档详细介绍了 OpenClaw 开源 AI 助手的安装流程及飞书机器人接入方法。内容涵盖 Node.js 环境准备、PowerShell 权限设置、一键安装脚本执行、初始配置向导操作（包括 API Key 配置）、以及飞书应用的创建、权限开通、插件安装与配置。此外，文档还提供了常用命令速查表及常见问题的解决方案，如 npm 报错、命令未找到、端口占用等，帮助用户快速部署并使用该工具进行自动化任务。
OpenClaw 曾用名：ClawdBot → MoltBot → OpenClaw（同一软件，勿混淆） 适用系统：Windows 10/11 最后更新：2026 年 3 月
OpenClaw 是一款开源个人 AI 助手。
与普通 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
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online