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

📅 发布时间:2026/7/6 20:39:23 👁️ 浏览次数:
本地部署中文OpenClaw 飞书机器人部署指南
适用场景在 Windows 本地PowerShell一键部署 OpenClaw使用阿里云百炼作为大模型后端通过飞书长连接模式实现 AI 机器人。步骤 1安装 OpenClawopenclaw中文社区打开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/ 反馈或加入相关微信群讨论。