OpenClaw 安装与飞书机器人接入指南
OpenClaw 是一款支持多平台的开源个人 AI 助手,具备执行电脑操作的能力。本文介绍其名称演变历程,提供 Node.js 环境配置、一键安装命令及初始向导设置步骤。重点讲解如何在飞书开发者后台创建应用、配置权限,并通过插件将飞书机器人接入 OpenClaw,实现通过即时通讯软件指挥 AI 完成任务。同时包含常用命令速查及常见问题解决方案。

OpenClaw 是一款支持多平台的开源个人 AI 助手,具备执行电脑操作的能力。本文介绍其名称演变历程,提供 Node.js 环境配置、一键安装命令及初始向导设置步骤。重点讲解如何在飞书开发者后台创建应用、配置权限,并通过插件将飞书机器人接入 OpenClaw,实现通过即时通讯软件指挥 AI 完成任务。同时包含常用命令速查及常见问题解决方案。

OpenClaw(曾用名 ClawdBot、MoltBot)是一款开源个人 AI 助手。名称变更历史为:ClawdBot -> MoltBot -> OpenClaw。
OpenClaw 是一款开源个人 AI 助手,与传统 AI 聊天机器人的区别在于具备执行能力。
它不只是回答问题的聊天机器人,而是真的能在你电脑上动手操作。比如你告诉它'帮我整理一下上个月的邮件',它就默默去处理了;你睡觉时,它还能继续干活,退订广告、预约行程、甚至找找 Bug。
简单来说,一句话交给它,从整理桌面文件到控制家里灯光,它都默默帮你搞定。
执行一键安装命令可自动安装 Node.js,但为了加快速度防止安装意外,建议先手动安装 Node.js。
官方下载地址:https://nodejs.org/zh-cn/download
以管理员身份运行 PowerShell:
Win 键,搜索 PowerShell点击 是 确认。
在管理员 PowerShell 窗口中,依次执行以下两条命令:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
⚠️ 安全提示:这些命令只会影响您自己的账户,不会影响系统安全或其他用户。
复制以下命令,粘贴到 PowerShell 窗口中,按 Enter 执行:
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程会自动完成:
注意:如果命令执行后报错,可以自行到官网下载安装包,自己安装 Node 环境,注意版本最好在 Node v22.x 以上。若仍不懂如何安装,请参考官方文档或社区资源。
安装完成后,会自动进入配置向导(openclaw onboard)。
这一步主要是告知使用 OpenClaw 可能存在的风险。请问你是否继续?
按 向左方向键 ←,选择 Yes,按 Enter 回车确认。
OpenClaw 需要连接到大语言模型才能工作。OpenClaw 比较费 Token,国外模型成本高,门槛也高,这里选择国内的智谱 GLM 4.7。
如果没有智谱的 API Key,点击官方地址注册账号获取 API Key:https://www.bigmodel.cn/
输入自己的 API Key。
这里选择默认的 GLM 4.7,也是智普当前的旗舰模型。
配置完 AI 模型后,OpenClaw 会询问你要连接哪个通讯平台?
OpenClaw 原生支持的即时通信平台主要是海外的 WhatsApp、Telegram、Discord、Slack、iMessage 等,国内用户不习惯,这里国产即时通信软件大厂也跟进了,现在钉钉、飞书等都已支持接入 OpenClaw。
后面会带领大家把飞书机器人接入 OpenClaw,使大家可以通过飞书即可指挥 OpenClaw 为我们干活,但是飞书配置比较复杂,这里我们先选择跳过,后面我们可以通过继续进行配置。
这里选择:No,暂不配置,后面通过 UI 界面进行配置。
操作步骤:先敲 空格,表示选中当前项,再敲回车键。
此时它会自动再打开一个命令窗口来启动服务。
这个过程是在启动服务,可能会需要等一点时间。
同时,大约过 30 秒左右,我们回到刚才的设置窗口,选择 Open the Web UI,打开 OpenClaw 的 UI 界面。
浏览器自动打开 Web UI 界面。
我们需要先到飞书平台创建自己的机器人来接入 OpenClaw。
飞书开放平台地址:https://open.feishu.cn
没有飞书账号的,需要自己注册账号。 点击右上角进入 开发者后台。
把即时通讯相关的权限全部开通。
来到飞书客户端进行审批。
打开 PowerShell,输入以下命令,安装飞书插件:
openclaw plugins install @m1heng-clawd/feishu
安装成功后,再打开一个新的命令窗口,开始配置飞书插件。
输入命令:openclaw config
选择渠道。
选择配置链接。
输入飞书的 AppID,AppSecret。
域名选择中国的。
接受群组聊天。
选择完成。
选择 Yes。
选择 Open。
选择继续,完成配置。
重启服务,使配置生效。 控制台可以看到飞书插件已经配置成功。
选择 使用长连接接收事件。
可以看到添加事件按钮由原来的灰色不可点击变为可点击。
添加接收消息事件。
给应用开通获取通讯录基本信息的权限。
重新发布版本。 跟前面的步骤一样,发布为在线应用即可。
现在可以在 飞书中与 AI 助手对话了!
来到飞书客户端或者手机飞书 app 上。
以下是 openclaw 文件夹下面的文档内的内容。
现在我跟飞书机器人对话,让他告诉我指定文档内是什么内容。
配置完成后,PowerShell 窗口底部会显示控制面板链接,格式类似:
Control UI: http://127.0.0.1:18789
| 命令 | 功能 |
|---|---|
openclaw onboard | 重新进入配置向导 |
openclaw status | 查看运行状态 |
openclaw health | 健康检查 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw update | 更新到最新版本 |
openclaw doctor | 诊断问题 |
openclaw uninstall | 卸载 OpenClaw |
问题原因:这可能是 OpenClaw 的一个 bug,可以等官方更新,也可以自己去官方仓库提 issue。
解决步骤: 定位问题代码 文件路径:
C:\Users\Administrator\AppData\Roaming\fnm\node-versions\v22.14.0\installation\node_modules\openclaw\dist\process\exec.js
修改代码
找到 runCommandWithTimeout 函数中的 spawn 调用,修改如下:
修改前:
const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
const child = spawn(argv[0], argv.slice(1), { stdio, cwd, env: resolvedEnv, windowsVerbatimArguments });
修改后:
const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
// On Windows, npm must be spawned with shell: true or use .cmd extension
let command = argv[0];
let useShell = false;
if (process.platform === "win32" && path.basename(command) === "npm") {
useShell = true;
}
const child = spawn(command, argv.slice(1), { stdio, cwd, env: resolvedEnv, shell: useShell });
解决方法:
exec bash 或重启电脑解决方法:
Ctrl + C 中断当前操作openclaw doctor 检查问题解决方法:
openclaw onboard解决方法:
openclaw gateway --port 18790
使用其他端口启动服务。
OpenClaw 软件本身完全免费,主要成本来自 AI 模型 API 调用,可选择国产大模型,降低成本。
OpenClaw 代表了个人 AI 助理的未来趋势——从'聊天工具'进化为'执行工具'。虽然目前的配置过程对小白用户有一定门槛,但一旦完成设置,您将拥有一个 24/7 待命的超级助手。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online