介绍开源 AI 助手 OpenClaw 在 Windows 系统上的安装步骤及飞书机器人接入配置。内容涵盖 Node.js 环境准备、PowerShell 权限设置、一键安装命令执行、AI 模型 API Key 配置，以及飞书开放平台应用创建、插件安装与事件回调设置。包含常用命令速查与常见问题解决方案，帮助用户快速部署本地 AI 自动化任务。
适用系统：Windows 10/11
OpenClaw 是一款开源个人 AI 助手，支持本地执行任务。
与普通 AI 聊天机器人的核心区别：
建议提前手动安装 Node.js（版本 v22.x 以上），可加快后续安装速度并减少意外。
以管理员身份运行 PowerShell（Win 键搜索 → 右键 → 以管理员身份运行），依次执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
iwr -UseBasicParsing 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