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

2026-05-06阅读 0热度 0

飞书 OpenClaw

适用场景与最终效果

想不想在Windows系统里，快速拥有一个能理解你、帮你处理任务的AI助手？这篇指南，就来带你完成这件事。我们将在本地通过PowerShell一键部署OpenClaw，用上阿里云百炼的强大模型能力，并最终让这个AI通过飞书的长连接模式，成为一个随时待命的机器人伙伴。

延伸阅读：技能拓展

想让你的机器人更强大？安装必备技能包可以参考这篇指南：OpenClaw 最新必安装 10 个 Skills。想探索自动化内容创作？这篇OpenClaw 实现小红书自动化发文的操作指南，也值得一看。

步骤一：安装 OpenClaw 核心框架

整个过程，我们从打开PowerShell开始。别担心，后面的操作几乎都是一键式的。

在PowerShell中，直接执行下面这条命令，安装程序就会自动启动：

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

接下来，系统会自动处理所有脏活累活：下载Node.js环境、安装各种依赖包。这个过程通常只需要几分钟，喝杯咖啡的功夫就好。安装完成后，它会自动跳转到配置向导，或者提示你进行下一步操作。

步骤二：启动首次配置向导

安装完成后，建议你新打开一个CMD窗口，这样环境会更干净。然后输入启动配置向导的命令：

openclaw-cn onboard

向导启动后，跟着提示一步步来就行：

第一步通常会问你是否继续，直接选择 YES。
到了关键的选择大模型提供商环节，这里我们选择 阿里云百炼。当然，你也可以按需选择OpenAI、deepseek等其他平台。
选择之后，向导就会引导你输入对应的API Key。

步骤三：获取并配置阿里云百炼 API Key

现在，我们需要去阿里云百炼控制台拿一把“钥匙”。

用浏览器访问阿里云百炼控制台并登录。
在左侧菜单找到密钥管理，点击创建 API Key。
创建成功后，页面会立即显示Key，通常以 sk- 或 bk- 开头。切记，此时立刻复制它，关闭页面后就看不到了。
回到刚才的配置向导，在对应位置粘贴这个Key，然后继续下一步。

步骤四：配置飞书机器人渠道（核心环节）

配置完模型，就该给AI找个“发声”的渠道了。在onboard向导中，选择配置 Feishu（飞书）渠道。

接下来，我们需要在飞书开放平台创建一个应用：

访问飞书开放平台。
点击**创建企业自建应用**，应用类型选择机器人，填写好基本信息后创建。

应用创建好后，在功能列表里选择机器人，进入配置。

这里需要填写机器人的名称和描述，你可以按喜好自定义。

关键一步：配置权限。

进入「权限管理」，找到「批量导入/导出权限」，先清空原有的权限内容。
将下面这一整段JSON代码完全复制，粘贴到输入框中，然后保存。

{"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，这两个值后面马上要用。
进入「事件与回调」页面：
a. 在订阅方式处，务必选择「长连接订阅方式」，不要选HTTP回调。
b. 添加事件：至少需要添加 im.message.receive_v1（接收消息）这个事件，这是机器人能回复消息的基础。
c. 保存设置。

一个小建议： 事件订阅和回调的具体配置，其实可以等OpenClaw部署启动完成后，再回到飞书后台统一设置，这样可以避免向导过程中因为网络或验证问题卡住。

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

步骤五：启动网关服务

配置都搞定后，现在来启动核心的通信服务。运行以下命令启动OpenClaw网关（它负责维持与飞书的WebSocket长连接）：

openclaw-cn gateway

当你看到命令行输出类似 “Listening on http://127.0.0.1:18789” 或者 “Gateway ready” 的提示时，就说明网关启动成功了。

注意： 这个命令行窗口需要一直保持运行，长连接才能维持。如果后续需要长期在后台运行，可以考虑使用 nohup 或 pm2 这类工具。

步骤六：访问管理后台进行验证

网关启动后，用浏览器打开提示中的网址（通常是 http://127.0.0.1:18789，有时会附带token参数），就能进入OpenClaw的管理后台。

登录后，重点检查一下飞书渠道的连接状态：

确认事件订阅方式显示为长连接模式。
检查已添加的事件列表是否完整，特别是 im.message.receive_v1 是否在其中。

这些都确认无误，渠道配置才算真正完成。

步骤七：激动人心的测试环节

终于到了检验成果的时刻。

打开飞书，将你刚创建的机器人拉入某个群聊，或者直接和它发起私聊。
发送一条消息，比如“@机器人你好”。
如果一切顺利，你会收到机器人的回复。它可能是一句简单的问候，也可能是调用百炼模型生成的智能回答。

恭喜！看到回复的那一刻，就标志着你的AI机器人部署成功了！

快速排错指南

万一过程中遇到点小波折，别慌，可以按照下面几点快速排查：

onboard向导卡住或报错：首先检查网络连接是否通畅，尝试重新运行一次 openclaw-cn onboard 命令。
gateway启动失败：提示端口被占用？可以尝试在启动命令后加上 --port 参数指定另一个端口，比如 openclaw-cn gateway --port 18888。
飞书机器人不回复消息：这是最常见的问题。请按顺序检查：1) 飞书后台是否确认为“长连接”模式；2) 事件订阅列表里是否有 im.message.receive_v1；3) 填入的App ID、App Secret和API Key是否完全正确、没有空格。
模型无响应：如果机器人能接收消息但不回复，可能是模型侧的问题。确认你的阿里云百炼API Key有效，并且账号下有充足的额度。