openclaw + 飞书 本地部署
📝 第一步：环境准备（安装Node.js和Git）
OpenClaw基于Node.js运行，版本要求为v22.0.0或更高 。
1. 安装Node.js：访问Node.js官网，下载并安装最新的LTS版本（≥22.x）。安装过程一路“下一步”即可。
• 验证：安装完成后，打开PowerShell（建议以管理员身份运行），输入 node -v，如果显示版本号（如v22.x.x），则说明安装成功 。
2. 安装Git：OpenClaw的安装和插件管理需要用到Git。同样从官网下载安装程序，默认选项安装即可。
• 验证：在PowerShell中输入 git --version，能显示版本号即表示成功 。
3. 切换国内镜像源（重要）：为了避免网络下载失败或速度过慢，建议将npm的源切换为国内镜像。
powershell
npm config setregistry https://registry.npmmirror.com
第二步：安装OpenClaw核心程序
OpenClaw提供了一个PowerShell一键安装脚本，非常方便 。
1. 以管理员身份打开PowerShell。这是关键一步，否则可能因权限不足导致安装失败。
2. 临时放宽脚本执行策略（只需执行一次）：
powershell
Set-ExecutionPolicy-ExecutionPolicy RemoteSigned -Scope CurrentUser
在提示后输入 Y 并回车确认 。
3. 执行安装命令：
powershell
iwr-useb https://openclaw.ai/install.ps1 |iex
这个命令会自动下载并安装OpenClaw。等待安装完成，期间不要关闭窗口 。
🦞 第三步：初始化OpenClaw（关键配置向导）
安装完成后，安装脚本可能会自动进入配置向导。如果没有自动启动，你也可以随时在命令行输入 openclaw configure 手动启动 。这个向导会问你一系列问题，请参考以下步骤回答：
1. 信任关系确认：提示是否信任此设备，输入 Yes 并回车。
2. 部署方式：使用方向键选择 QuickStart（快速开始），回车。
3. 飞书配置：这一步会提示输入飞书应用的 App ID 和 App Secret。先不要着急填，因为我们现在还没有这些信息。
• 在光标处直接按回车，选择 Skip for now（暂时跳过）。
4. 模型提供商：选择 All providers，这样可以显示出所有可用模型，方便我们后续配置免费模型 。
5. 默认模型：直接回车，接受默认模型（如 anthropic/claude-...）即可，我们后面会把它换成国内可用的免费模型 。
6. 目标平台：使用方向键找到并选中 Feishu/Lark (飞书)，回车确认 。
7. 插件路径：选择 Use local plugin path（使用本地插件路径），回车 。
8. 暂时跳过：后续会询问关于网络搜索、技能配置、Hooks等问题，可以都选择 Skip for now 或 No 来跳过，先确保核心功能跑通 。
完成上述步骤后，向导会暂停，并提示你需要去飞书开放平台创建应用。请保持这个PowerShell窗口不要关闭，打开新的终端，
输入 openclwa dashboard 会跳转浏览器打开页面，可以查看openclwa的使用情况，我没打开，我的电脑本地dnx解析有问题。
我们接下来就去操作飞书后台。
✈️ 第四步：飞书开放平台配置（创建机器人）
这是让OpenClaw能与飞书对话的核心步骤。
1. 访问飞书开放平台：浏览器打开 飞书开放平台开发者后台，使用你的飞书账号登录 。
2. 创建企业自建应用：
• 点击“创建应用” -> 选择“企业自建应用” 。
• 填写应用名称（如“我的小龙虾助手”）和描述，点击“确定创建” 。
3. 获取凭证：
• 创建成功后，进入应用详情页，点击左侧“凭证与基础信息”。
• 在这里，你可以看到 App ID 和 App Secret。复制并保存好这两个关键信息，注意保密 。
4. 添加机器人能力：
• 在左侧菜单中，找到“添加应用能力”，点击并开启 机器人 。
5. 配置权限（最关键的一步）：
• 点击左侧“权限管理”。
• 为了简化操作，可以使用“批量导入”功能。点击“批量导入”，将下面这段JSON代码复制粘贴进去，然后点击“下一步”和“申请开通” 。
json
{ "scopes":{ "tenant":[ "contact:user.base:readonly", "im:message", "im:message.p2p_msg:readonly", "im:message.group_at_msg:readonly", "im:message:send_as_bot", "im:resource", "im:chat" ] }}
（注：这是一个精简但够用的权限列表，包含了收发消息、读取用户信息等必需项。官方教程中可能提供更长的列表，核心是确保 im.message.receive_v1 事件对应的权限被包含。）
6. 配置事件订阅（收不到消息的元凶）：
• 点击左侧“事件与回调” 。
• 在“订阅方式”处，点击编辑图标，选择 使用长连接接收事件 并在下方添加 im.message.receive_v1事件。这是因为OpenClaw网关通过WebSocket与飞书保持连接，无需公网IP 。
7. 发布版本：
• 点击左侧“版本管理与发布”，创建一个版本（如版本号1.0.0），然后点击“申请发布”。对于自建应用，通常秒过或无需审核 。注意，有新的修改、、添加之后要重新发版。
🔗 第五步：连接OpenClaw与飞书
现在，我们回到之前暂停的PowerShell窗口，把飞书应用的凭证交给OpenClaw。
1. 输入凭证：
• 在PowerShell窗口中，你应该还能看到提示输入 App ID 和 App Secret 的信息。
• 将刚刚从飞书开放平台复制的 App ID 和 App Secret 依次粘贴进去，并回车确认 。
2. 选择连接模式：
• 提示选择连接模式，直接回车选择默认的 WebSocket (default) 。
• 提示选择区域，选择 China（国内版）。
3. 完成后续配置：
• 关于“网络搜索”、“技能”、“Hooks”等配置，可以继续选择 Skip for now 跳过。我们的目标是先让机器人跑起来 。
4. 启动OpenClaw网关：
• 当所有配置完成后，OpenClaw会自动尝试启动网关服务。你会看到一行行的日志输出。
• 重要提示：这个运行着日志的PowerShell窗口是OpenClaw的网关进程，必须保持打开状态，飞书机器人才能正常工作。关闭它，机器人就下线了 。
5. 完成飞书事件回调配置：
• 回到飞书开放平台的“事件与回调”页面，现在应该可以点击“保存”按钮了。保存成功后，建议再检查一下“事件配置”列表，确保至少添加了 接收消息 v2.0 (im.message.receive_v1) 事件。如果没有，需要手动添加并再次发布版本 。
🧪 第六步：测试与模型配置
至此，你的OpenClaw应该已经连上飞书了，但可能还无法智能回复，因为还没有配置真正干活的大模型。
1. 在飞书中找到机器人：
• 打开飞书桌面端，在搜索框中搜索你创建的应用名称（如“我的小龙虾助手”），点击进入对话窗口 。
2. 发送一条消息试试：
• 输入 你好 并发送。你可能会看到机器人回复了，但内容可能是报错，比如提示找不到API Key 。
3. 配置一个可用的免费模型：
• 回到PowerShell窗口，按下 Ctrl + C 可以暂时停止OpenClaw运行。
• 输入命令重新进入配置向导：openclaw configure 。
• 在向导中找到并选择 Model 选项。
• 为了免费体验，可以选择一个国内有免费额度的模型。例如，选择 qwen-portal/coder-model（阿里云百炼平台上的通义千问模型，部分版本有免费额度）。选择后，浏览器可能会自动打开一个登录页面，让你授权并获取API Key 。
• 完成模型配置后，在向导最后选择 Continue 退出。
4. 重启网关：
• 在PowerShell中输入命令，重新启动网关：
powershell
openclaw gateway \ C:\Users\lijie\.openclaw\gateway.cmd
5. 最终验证：
• 再次在飞书中向你的机器人发送消息。现在，它应该能正常调用你配置的大模型，并给出有意义的回复了！
如果第一次回复：
2.飞书报错
⚠️ Agent failed before reply: All models failed (2): qwen-portal/coder-model: OAuth token refresh failed for qwen-portal: Qwen OAuth refresh token expired or invalid. Re-authenticate with openclaw models auth login --provider qwen-portal.. Please try again or re-authenticate. (auth) | qwen-portal/vision-model: OAuth token refresh failed for qwen-portal: Qwen OAuth refresh token expired or invalid. Re-authenticate with openclaw models auth login --provider qwen-portal.. Please try again or re-authenticate. (auth). Logs: openclaw logs --follow
解决：openclaw models auth login --provider qwen-portal
🚨 常见问题速查
• 机器人能收到消息但无法回复（报错）：99%是模型配置问题，没有配置API Key或Key无效。请重新运行 openclaw configure 配置一个有效的模型 。
• 飞书里搜索不到机器人：检查应用是否已发布，以及你在飞书开放平台设置的“可用范围”是否包含你的账号 。
• PowerShell报错“无法加载文件...”：执行第一步中的 Set-ExecutionPolicy 命令以管理员身份运行即可 。
• 想在外网或手机上使用：目前的配置是基于本地局域网的。如果你需要公网访问，可以研究一下OpenClaw官方文档中关于 Tailscale 的集成，它可以轻松组建安全的虚拟局域网，让手机端通过VPN连接回你家里的电脑 。
部署过程中如果遇到具体的报错信息，或者想了解如何为OpenClaw编写自定义的“技能”（Skills）来扩展功能，随时可以再问我。祝你部署顺利！
浙公网安备 33010602011771号