本地部署中文OpenClaw 飞书机器人部署指南
适用场景：在 Windows 本地（PowerShell）一键部署 OpenClaw，使用阿里云百炼作为大模型后端，通过飞书长连接模式实现 AI 机器人。
步骤 1：安装 OpenClaw（openclaw中文社区）
打开PowerShell。
执行以下命令一键安装：
# 在 PowerShell 中运行 iwr -useb https://clawd.org.cn/install.ps1 | iex- 安装过程会自动下载 Node.js、依赖等，耗时几分钟。
- 安装完成后会自动进入配置向导，或提示你继续下一步。
步骤 2：运行首次配置向导
重新打开一个CMD。
输入命令启动配置向导：
openclaw-cn onboard向导启动后：
- 第一步通常会问是否继续 → 选择YES。
- 在选择大模型提供商时，选阿里云百炼（或你想用的其他平台，如 OpenAI、deepseek 等）。
- 后面会引导你输入 API Key。
步骤 3：获取阿里云百炼 API Key
- 浏览器访问阿里云百炼控制台：https://bailian.console.aliyun.com/cn-beijing/#/home
- 登录后，进入左侧菜单密钥管理→创建 API Key。
- 创建完成后，立即复制 Key（通常以 sk- 或 bk- 开头）。
- 返回 onboard 向导，在对应位置粘贴这个 Key 并继续。
步骤 4：配置飞书机器人渠道
在 onboard 向导中，选择配置Feishu（飞书）渠道。
参考官方快速开始文档（强烈推荐先看一遍）： https://openclaw.club/guides/quick-start
飞书侧关键操作（建议在 onboard 向导运行的同时打开飞书后台操作）：
- 登录飞书开放平台：https://open.feishu.cn
- 创建企业自建应用 → 选择机器人类型 → 填写名称等 → 创建。
- 在「凭证与基础信息」中复制App ID和App Secret。
- 进入「事件与回调」：
- 订阅方式：选择长连接订阅方式（非常重要！不要选 HTTP 回调）。
- 添加事件：至少勾选 im.message.receive_v1（接收消息），推荐再加群聊@、已读等事件。
- 保存配置。
注意：事件订阅和回调配置建议在openclaw部署完成后统一在飞书后台设置，避免向导卡住。
3.在指定位置输入刚才复制的飞书 App ID和App Secret，继续下一步直到向导完成。
步骤 5：启动网关服务
配置完成后，启动 OpenClaw 的网关（负责 WebSocket 长连接）：
openclaw-cn gateway- 看到类似 “Listening on http://127.0.0.1:18789” 或 “Gateway ready” 即启动成功。
- 保持这个窗口运行（或用 nohup / pm2 后台运行）。
步骤 6：访问管理后台并验证
- 浏览器打开命令中提示的网址（通常是 http://127.0.0.1:18789 或 http://localhost:18789，可能带 token 参数）。
- 登录 OpenClaw 管理后台。
- 确认飞书渠道已连接：
- 检查事件订阅是否为长连接模式。
- 确认已添加的事件列表完整。
步骤 7：测试部署是否成功
- 将机器人拉入飞书群或私聊。
- 发送消息（如 @机器人 你好）。
- 如果机器人正常回复（可能简单问候或调用百炼模型生成回答），则部署成功！
快速排错提示
- onboard 卡住或报错 → 检查网络，重新运行 openclaw-cn onboard。
- gateway 启动失败 → 检查端口 18789 是否被占用，可加参数 --port 其他端口。
- 飞书不回复 → 确认选了“长连接”、事件已订阅、App ID/Secret/Key 无误。
- 模型无响应 → 确认百炼 API Key 有效、配额充足。
祝部署顺利！ 有问题欢迎到中文社区 http://clawd.org.cn/ 反馈，或加入相关微信群讨论。