OpenClaw飞书机器人本地部署实录

选择机器人，继续下一步。

输入内容（自定义）。

在权限管理里清空原有权限，粘贴下面这一段：

{"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" ] } }

在「凭证与基础信息」中复制 App ID 和 App Secret。接着进入「事件与回调」：订阅方式选 长连接订阅方式（不要选 HTTP 回调），添加事件 im.message.receive_v1。保存设置。

注意：事件订阅和回调配置最好等 openclaw 部署完再统一设置，避免向导卡住。

回到向导，输入复制好的 App ID 和 App Secret，继续直到完成。

启动网关

配置完成，启动网关服务：

openclaw-cn gateway

看到 Listening on http://127.0.0.1:18789 或类似提示就成功了。保持窗口运行或交给 pm2/nohup 后台守护。

管理后台与验证

浏览器打开 http://127.0.0.1:18789（可能需要带 token），登录后台。确认飞书渠道连接状态：检查事件订阅是否为长连接，事件列表是否完整。

测试与排错

把机器人拉进群或私聊，发消息试试。正常回复就表示部署成功。

常见问题

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