OpenClaw 安装与飞书机器人接入指南
OpenClaw 是一款开源个人 AI 助手,具备本地执行能力。本文介绍在 Windows 环境下安装 Node.js 及 OpenClaw 的步骤,包括设置 PowerShell 权限和执行一键安装脚本。随后指导配置 AI 模型 API Key(以智谱 GLM 为例),并通过飞书开放平台创建应用、获取凭证,利用插件将 OpenClaw 接入飞书机器人。文末提供常用管理命令及常见报错解决方案,帮助用户快速搭建自动化 AI 助理。

OpenClaw 是一款开源个人 AI 助手,具备本地执行能力。本文介绍在 Windows 环境下安装 Node.js 及 OpenClaw 的步骤,包括设置 PowerShell 权限和执行一键安装脚本。随后指导配置 AI 模型 API Key(以智谱 GLM 为例),并通过飞书开放平台创建应用、获取凭证,利用插件将 OpenClaw 接入飞书机器人。文末提供常用管理命令及常见报错解决方案,帮助用户快速搭建自动化 AI 助理。

OpenClaw(曾用名 ClawdBot、MoltBot)是一款开源个人 AI 助手。其名称曾经历变更,因版权及传播问题最终定名为 OpenClaw。
OpenClaw 是一款开源个人 AI 助手,与传统 AI 聊天机器人的区别在于:
它不只是回答问题的聊天机器人,而是能在电脑上动手操作。例如整理邮件、退订广告、预约行程或查找 Bug。你可以用钉钉、飞书、WhatsApp 等各类即时通讯软件指挥它。
执行一键安装命令可自动安装 Node.js,但为防止意外,建议先手动安装。
官方下载地址:https://nodejs.org/
以管理员身份运行 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.js 环境,版本建议在 v22.x 以上。若不懂如何安装,请参考 Node.js 官网文档。
安装完成后,会自动进入配置向导(openclaw onboard)。
系统会提示使用 OpenClaw 可能存在的风险,询问是否继续。按向左方向键 ←,选择 Yes,按 Enter 回车确认。
选择快速启动模式。
OpenClaw 需要连接到大语言模型才能工作。建议选择国内大模型以降低 Token 成本。
如果没有 API Key,请访问智谱开放平台注册账号获取:https://www.bigmodel.cn/
输入自己的 API Key。
选择默认的 GLM-4 模型(智谱当前旗舰模型)。
配置完 AI 模型后,OpenClaw 会询问要连接哪个通讯平台。
OpenClaw 原生支持 WhatsApp、Telegram、Discord 等,国内用户可选择飞书、钉钉。此处演示跳过,后续通过 UI 界面配置飞书。
选择 No,暂不配置,后续通过 UI 界面进行配置。
操作步骤:先敲 空格 选中当前项,再敲回车键。
此时会自动打开一个命令窗口来启动服务。
等待约 30 秒左右,回到设置窗口,选择 Open the Web UI,打开 OpenClaw 的 Web UI 界面。
浏览器自动打开 Web UI 界面。
在界面中进行初步测试。
需要先前往飞书平台创建机器人。
飞书开放平台地址:https://open.feishu.cn
点击右上角进入 开发者后台。
点击创建新应用。
填写应用名称等信息。
获取 AppID 和 AppSecret。
在应用中添加机器人组件。
开通即时通讯相关的权限。
创建版本并提交审批。
审批通过后,发布为在线应用。
打开 PowerShell,输入以下命令安装飞书插件:
openclaw plugins install @m1heng-clawd/feishu
安装成功后,打开新的命令窗口,输入命令:openclaw config。
选择渠道,选择配置链接。
输入飞书的 AppID 和 AppSecret。
域名选择中国区域。
接受群组聊天。
选择完成,确认开启。
重启服务使配置生效。
选择 使用长连接接收事件。
添加接收消息事件。
开通获取通讯录基本信息的权限。
重新发布版本为在线应用。
现在可以在飞书中与 AI 助手对话了。
在飞书客户端或手机 APP 上即可与机器人交互。
配置完成后,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。
解决步骤:定位问题代码并修改 spawn 调用。
文件路径:
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 });
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