OpenClaw 安装及飞书机器人接入教程
OpenClaw 曾用名:ClawdBot → MoltBot → OpenClaw(同一软件,勿混淆) 适用系统:Windows 10/11
一、什么是 OpenClaw?
OpenClaw 是一款开源个人 AI 助手,GitHub 星标已超过 10 万颗。
与普通 AI 聊天机器人的核心区别:
- 真正的执行能力:不只回答问题,能实际操作你的电脑
介绍 OpenClaw 开源 AI 助手的安装流程及飞书机器人接入方法。首先需安装 Node.js,通过 PowerShell 设置权限并执行一键安装脚本。完成基础配置后,在飞书开放平台创建应用并获取凭证,随后安装并配置 OpenClaw 的飞书插件。文中还包含常用命令速查及常见问题解决方案,帮助用户快速部署本地 AI 助手。
OpenClaw 曾用名:ClawdBot → MoltBot → OpenClaw(同一软件,勿混淆) 适用系统:Windows 10/11
OpenClaw 是一款开源个人 AI 助手,GitHub 星标已超过 10 万颗。
与普通 AI 聊天机器人的核心区别:
建议提前手动安装 Node.js(版本 v22.x 以上),可加快后续安装速度并减少意外。
以管理员身份运行 PowerShell(Win 键搜索 → 右键 → 以管理员身份运行),依次执行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程会自动完成:检测系统环境、安装依赖、下载核心文件、配置环境变量,并进入配置向导。
按左方向键 ← 选择 Yes,回车确认继续。
推荐使用国内智谱 GLM 模型,成本低且门槛低。
选择 GLM-4.7(智谱当前旗舰模型)或其他你已有 Key 的模型。
飞书配置较复杂,此处选择 Skip,后续单独配置。
选择 No,后续通过 UI 界面配置。
按空格键选中,再按回车确认。
服务启动后,约等待 30 秒,选择 Open the Web UI,浏览器自动打开管理界面:
http://127.0.0.1:18789
在应用详情页,找到添加应用能力,选择并添加机器人。
在权限管理页面,开通以下权限(即时通讯相关权限全部开通):
打开 PowerShell,执行:
openclaw plugins install @m1heng-clawd/feishu
安装完成后,新开一个 PowerShell 窗口,执行:
openclaw config
按照向导依次完成:
| 步骤 | 操作 |
|---|---|
| 选择渠道 | 选择飞书 |
| 选择配置链接 | 选择对应链接 |
| 填写凭证 | 输入 App ID 和 App Secret |
| 选择域名 | 选择中国区域 |
| 接受群组聊天 | 确认开启 |
| 完成配置 | 选择 Yes → Open → 继续 |
配置完成后重启服务使配置生效:
openclaw gateway stop
openclaw gateway start
打开飞书客户端,找到你创建的机器人,直接发消息即可指挥 OpenClaw 干活!
| 命令 | 功能 |
|---|---|
openclaw onboard | 重新进入配置向导 |
openclaw status | 查看运行状态 |
openclaw health | 健康检查 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw update | 更新到最新版本 |
openclaw doctor | 诊断问题 |
openclaw uninstall | 卸载 OpenClaw |
Q:安装飞书插件提示 spawn npm ENOENT
这是 OpenClaw 在 Windows 上的已知 bug。找到以下文件:
C:\Users\你的用户名\AppData\Roaming\fnm\node-versions\v22.x.x\installation\node_modules\openclaw\dist\process\exec.js
找到 runCommandWithTimeout 函数中的 spawn 调用,在其前面添加 Windows npm 兼容处理:
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,
});
Q:提示"openclaw 命令找不到"
关闭所有 PowerShell 窗口,重新打开后重试。如仍不行,重启电脑。
Q:安装卡住不动
按 Ctrl+C 中断,执行 openclaw doctor 检查问题,确认防火墙设置是否阻止了网络请求。
Q:端口 18789 被占用
openclaw gateway --port 18790
换用其他端口启动服务。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online