Windows 本地部署 OpenClaw 飞书机器人指南

选择机器人并继续下一步，输入自定义内容。

2. 配置权限与事件

在「凭证与基础信息」中复制 App ID 和 App Secret。

在「权限管理/批量导入/导出权限」中清空原有权限，粘贴以下内容：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application.self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "contact:contact.base:readonly",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

在「事件与回调」中设置：

• 订阅方式选择 长连接订阅方式（不可选 HTTP 回调）。
• 添加事件：至少包含 im.message.receive_v1（接收消息）。
• 保存设置。

注意：事件订阅和回调配置建议在 OpenClaw 部署完成后统一在飞书后台设置，避免向导卡住。

3. 完成配置

在指定位置输入刚才复制的飞书机器人 App ID 和 App Secret，继续下一步直到向导完成。

启动网关服务

配置完成后，启动 OpenClaw 的网关（负责 WebSocket 长连接）：

openclaw-cn gateway

看到类似 Listening on http://127.0.0.1:18789 或 Gateway ready 即表示启动成功。请保持该窗口运行（或使用 nohup/pm2 后台运行）。

访问管理后台并验证

1. 浏览器打开命令中提示的网址（通常是 http://127.0.0.1:18789 或 http://localhost:18789，可能带 token 参数）。
2. 登录 OpenClaw 管理后台。
3. 确认飞书渠道已连接：
   • 检查事件订阅是否为 长连接模式。
   • 确认已添加的事件列表完整。

测试部署是否成功

将机器人拉入飞书群或私聊，发送消息（如 @机器人 你好）。如果机器人正常回复（可能简单问候或调用百炼模型生成回答），则部署成功！

常见问题排查

• onboard 卡住或报错：检查网络环境，尝试重新运行 openclaw-cn onboard。
• gateway 启动失败：检查端口 18789 是否被占用，可加参数 --port 指定其他端口。
• 飞书不回复：确认选了'长连接'、事件已订阅、App ID/Secret/API Key 无误。
• 模型无响应：确认百炼 API Key 有效且配额充足。