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

**适用场景：**在 Windows 本地（PowerShell）一键部署 OpenClaw，使用阿里云百炼作为大模型后端，通过飞书长连接模式实现 AI 机器人。

步骤 1：安装 OpenClaw

1. 打开 PowerShell。
2. 执行以下命令一键安装：

# 在 PowerShell 中运行 iwr -useb https://clawd.org.cn/install.ps1 | iex

• 安装过程会自动下载 Node.js、依赖等，耗时几分钟。
• 安装完成后会自动进入配置向导，或提示你继续下一步。

步骤 2：运行首次配置向导

1. 重新打开一个 CMD。
2. 向导启动后：
   • 第一步通常会问是否继续 → 选择 YES。
   • 在选择大模型提供商时，选 阿里云百炼（或你想用的其他平台，如 OpenAI、deepseek 等）。
   • 后面会引导你输入 API Key。

输入命令启动配置向导：

openclaw-cn onboard

步骤 3：获取阿里云百炼 API Key

1. 浏览器访问 阿里云百炼控制台。
2. 登录后，进入左侧菜单 密钥管理 → 创建 API Key。
3. 创建完成后，立即复制 Key（通常以 sk- 或 bk- 开头）。
4. 返回 onboard 向导，在对应位置粘贴这个 Key 并继续。

步骤 4：配置飞书机器人渠道

1. 在 onboard 向导中，选择配置 Feishu 渠道。

• 访问 飞书开放平台。
• 创建企业自建应用 → 选择机器人类型 → 填写基本信息 → 创建。

选择机器人，继续下一步

输入内容（自定义）

2. 在权限管理/批量导入/导出权限中清空原有权限，粘贴复制下方内容

{ "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 部署完成后统一在飞书后台设置，避免向导卡住。

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

步骤 5：启动网关服务

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

openclaw-cn gateway

• 看到类似 'Listening on http://127.0.0.1:18789' 或 'Gateway ready' 即启动成功。
• 保持这个窗口运行（或用 nohup / pm2 后台运行）。

步骤 6：访问管理后台并验证

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

步骤 7：测试部署是否成功

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

快速排错提示

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