简介
OpenClaw 是一个可扩展的本地化 AI 智能体平台，支持通过 Skills 接管工作流。本教程指导用户在 Windows 环境下完成环境搭建、模型配置及飞书集成。
1. 环境准备：Node.js & NVM
建议使用 nvm 管理不同版本的 Node.js。
1.1 安装 nvm
nvm (Node Version Manager) 允许在同一台机器上安装和切换多个版本的 Node.js。
1.2 安装 Node.js v22+
需要安装大于 22 的版本（如 v22.10.0+ LTS）。
检查当前版本
打开终端输入：
nvm ls
显示列表中带有星号标记的为当前版本。
安装并切换版本
若无 22 版本，执行以下命令：
nvm install 22
nvm use 22
再次运行 nvm ls 确认。
2. Git 下载安装
请自行搜索并安装 Git 工具以进行代码管理。
3. OpenClaw 安装与配置
3.1 设置 PowerShell 策略
以管理员身份运行 PowerShell，执行以下命令允许脚本运行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
输入 Y 确认。
3.2 开始安装
执行安装命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
根据提示允许公共网络访问 Node.js。等待出现 "OpenClaw 2026" 字样表示安装成功。
3.3 初始配置
安装后按提示操作：
- 选择个人使用 (Yes)。
- 保持 QuickStart 模式。
- 选择大模型厂商，推荐 Kimi。
注意：此时不要关闭终端，先获取 API Key。
3.4 创建 Kimi 密钥
访问 Moonshot AI 开放平台登录账户，在 API key 管理页面新建密钥并复制保存。
3.5 配置大模型
回到 PowerShell 窗口：
- 向下选择 Kimi 模型并回车。
- 选择
.cn后缀区域。 - 粘贴刚才创建的密钥。
- 选择默认模型
kimi-2.5。 - 跳过网络搜索工具配置 (Skip for now)。
- 选择是否需要额外技能 (Skills)，无需求可跳过。
- 对于其他 API Key 配置 (如 Google, Notion 等)，若无账号请选择 No。
- 自动化钩子 (Hooks) 选择 Skip。
程序将自启动网关，随后打开 Web UI 网页即可对话。
4. 连接飞书机器人
4.1 创建飞书应用
- 登录 飞书开放平台。
- 创建企业自建应用，填写名称与描述。
- 添加机器人功能。
- 开通权限：输入
im:并全选确认。 - 创建并发布版本。
4.2 配置连接
在 PowerShell 输入 openclaw config 重新配置：
- 选择 Local 本地运行。
- 选择 Channels 配置通讯方式。
- 选择 Configure/link 添加新渠道，找到 Feishu。
- 安装飞书插件。
- 输入 App Secret 和 App ID（从飞书开发者后台凭证与基础信息中获取）。
- 选择 WebSocket 通讯方式。
- 选择是否允许群聊响应（建议 All groups with mention）。
- 配置私聊访问策略（测试选 Open，正式选 Pairing）。
4.3 事件回调设置
- 在飞书应用界面点击'事件与回调'。
- 选择长连接保存。
- 添加事件：勾选'接受消息'。
- 权限管理：开通通讯录基本信息权限。
- 再次创建并发布版本。
启动网关：
openclaw gateway
若提示 Gateway already running，说明已在运行。
5. 测试对话
打开手机版飞书 APP，找到应用中的机器人，发送消息进行测试。
6. 常见问题
6.1 飞书应用未显示
检查是否已完成飞书机器人的创建与发布步骤。
6.2 无响应
检查网关是否运行。若报错，尝试重启：
openclaw gateway stop
openclaw gateway restart
7. 关闭与暂停
临时停止服务：
openclaw gateway stop
彻底禁用开机自启：
- 按
Win + R，输入taskschd.msc。 - 在任务计划程序中找到 "Openclaw Gateway"。
- 右键点击'禁用'或'删除'。
8. 卸载
执行核心卸载命令：
openclaw uninstall --all --yes
删除命令行工具：
npm uninstall -g openclaw
(若使用 pnpm 或 bun，请替换为对应命令)
