【保姆级教程】手把手教你安装 OpenClaw 并接入飞书,让 AI 在聊天软件里帮你干活

——从零开始打造你的个人 AI 执行助手，告别繁琐操作

引言：重新认识 OpenClaw

你可能在各大技术社区听说过 ClawdBot 或 MoltBot，甚至见过一些同名的割韭菜加密项目，但它们其实都是 OpenClaw 在遭遇版权纠纷和恶意抢注前使用的曾用名。如今，这款项目已经在 GitHub 上狂揽了超过 10 万颗星标，成为了 2026 年现象级的开源 AI 应用。

市面上大多数的 AI 助手都停留在“你问我答”的聊天层面，而 OpenClaw 的杀手锏在于“落地执行”。它像是一个驻扎在你系统底层的虚拟员工：

当你下达“清理上个月过期邮件”的指令时，它会自己接管键鼠去完成操作。
即便你在熟睡，它也能根据预设逻辑默默跑代码排错、退订垃圾信息。
由于完全开源，你的隐私数据无需上传云端，且能无缝桥接飞书、钉钉、Discord 等各大主流即时通讯工具。

简而言之，这不是一个简单的聊天机器人，而是你电脑里真正意义上的私人“贾维斯”。

第一章：系统准备与环境检查

1.1 系统要求

操作系统
：Windows 10/11（64位）
Node.js
：版本 22.x 或更高（推荐最新 LTS 版本）
内存
：至少 8GB RAM
磁盘空间
：至少 2GB 可用空间
网络
：稳定的互联网连接

1.2 安装 Node.js（强烈推荐预装）

为了加快后续安装速度并防止意外中断，建议提前配置好 Node.js 环境。

访问 Node.js 官网：https://nodejs.org/zh-cn/download。
下载 Windows 安装包（推荐 LTS 版本）。
运行安装程序，按提示完成安装。
重要
：安装过程中务必勾选“Add to PATH”选项。
安装完成后，打开 PowerShell 验证：
```
node --versionnpm --version
```

第二章：一键安装 OpenClaw

2.1 设置 PowerShell 执行权限

重要提示：必须以管理员身份运行 PowerShell！

按下 Win 键，搜索“PowerShell”。
右键点击“Windows PowerShell”，选择“以管理员身份运行”并确认。

在管理员窗口中，依次执行以下两条命令：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUserSet-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

安全说明：这两条命令的作用是允许当前用户运行本地和下载的脚本。此操作仅影响当前账户，不会对系统整体安全造成影响。

2.2 执行一键安装命令

复制以下命令并执行：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装脚本会自动完成系统环境检测、依赖安装、核心文件下载及环境变量配置，并最终启动配置向导。注意：如果执行报错，建议自行前往官网下载 Node.js（22.x 以上版本）进行手动安装。

第三章：初始配置向导

安装完成后，系统会自动进入配置向导模式（等同于执行 openclaw onboard）。

3.1 风险告知与 QuickStart

风险告知
：由于 OpenClaw 具备实际操作权限，向导会提示相关风险。按向左方向键 ← 选择 Yes，按 Enter 确认。
QuickStart
：选择快速开始模式以简化流程。

3.2 配置 AI 模型与 API Key

OpenClaw 需要接入大语言模型作为大脑。

模型选择建议
：OpenClaw 消耗 Token 较多，建议选择性价比极高的国内模型，如智谱 GLM 4.7。其他备选项包括 DeepSeek 或 Qwen。
获取 API Key
：如果没有智谱 API Key，可前往官方平台注册获取：智谱大模型平台。
向导中输入你的 API Key，并推荐选择默认的 GLM 4.7 旗舰模型。

3.3 后续项配置

通讯平台
：国内用户建议在此步选择“跳过”，稍后单独配置飞书。
Skills (技能)
：建议选择 No，后续通过 UI 界面直观配置。
Hooks
：按空格键选中，回车确认。

3.4 启动服务与 Web UI

配置完成后，系统会自动弹出一个新窗口启动服务，此过程需要稍作等待。约 30 秒后，回到设置窗口选择 "Open the Web UI"，浏览器将自动打开可视化管理界面。

第四章：接入飞书机器人

4.1 创建飞书应用与获取凭证

访问飞书开放平台：https://open.feishu.cn，进入“开发者后台”。
点击“创建企业应用”，自定义应用名称（如：OpenClaw助手）和图标。
在“凭证与基础信息”中，复制并妥善保管 App ID 和 App Secret。

4.2 配置机器人权限与发布

进入“应用能力” → “机器人”，启用机器人能力并设置名称。
在“权限管理”中，批量导入以下即时通讯权限： im:message, im:message:send_as_bot, im:message:readonly, im:message:send, im:message:receive, im:chat, im:chat:readonly（可选权限：drive:drive:readonly, drive:file:readonly, drive:file:write）
在“版本管理与发布”中创建版本并提交审核发布。

4.3 安装飞书插件并配置

打开 PowerShell，执行以下安装命令（注意使用的是 @m1heng-clawd/feishu 包）：

openclaw plugins install @m1heng-clawd/feishu

安装成功后，打开新命令窗口，执行配置命令：

openclaw config

依次选择并填写：选择“渠道” → “配置链接” → 输入 AppID 和 AppSecret → 域名选择“中国的” → 接受群组聊天 → 完成 → yes → open → 继续。

4.4 重启服务与最终回调设置

执行以下命令使配置生效：

openclaw gateway restart

最后，回到飞书开发者后台：

选择“使用长连接接收事件”。
添加接收消息事件：im.message.receive_v1。
开通获取通讯录基本信息的权限，并重新发布在线版本。

至此，你已经可以在飞书客户端与你的 OpenClaw 助手对话了！

第五章：高级配置与避坑指南

5.1 常用命令速查

命令	功能说明
`openclaw onboard`	重新进入配置向导（修改底层配置时使用）
`openclaw gateway start/stop/restart`	启动 / 停止 / 重启服务网关
`openclaw status / health`	查看运行状态及诊断系统健康度
`openclaw doctor`	一键诊断并排查环境问题

5.2 常见问题解决 (FAQ)

Q1: 安装飞书插件提示 spawn npm ENOENT 报错怎么办？解决步骤：这可能是底层代码对 Windows 环境的适配 Bug。找到以下路径的文件：C:\Users\Administrator\AppData\Roaming\fnm\node-versions\v22.14.0\installation\node_modules\openclaw\dist\process\exec.js修改其中的 runCommandWithTimeout 函数，针对 npm 增加 shell: true 处理。修改后代码参考：

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,});

Q2: 提示 "openclaw 命令找不到"关闭并重新打开所有 PowerShell 窗口，或尝试执行 exec bash 及重启电脑。

Q3: 端口 18789 被占用执行命令更换端口：openclaw gateway --port 18790。

结语：开启智能办公新时代

OpenClaw 代表了个人 AI 助理的进化方向——从单一的“对话框”走向真正的“执行中枢”。只需一次性完成上述配置，你就拥有了一个 24 小时不间断工作的超级助手。

建议你从简单的整理任务开始，逐步熟悉它的能力，并尝试安装天气 (@openclaw/weather)、日历 (@openclaw/calendar) 等进阶技能插件，彻底释放生产力！

部署过程中如果遇到任何问题，欢迎在留言区交流讨论！

如果需要单独交流或请教的可以私信加我