简介
OpenClaw 是一个行动式智能体（AI Agent），支持本地化部署和隐私安全。本教程将指导您在 Windows 环境下，使用 Node.js 22、Git、Kimi 大模型 API 及飞书机器人，从零搭建个人 AI 基础设施。
一、Node.js 环境安装
建议使用 nvm 管理 Node.js 版本，避免环境冲突。
1.1 安装 nvm
nvm (Node Version Manager) 允许在同一台机器上安装和切换多个版本的 Node.js。
1.2 安装 Node.js v22+
确保版本大于 22。
检查当前版本
打开终端输入：
nvm ls
下载安装 v22
若无 22 版本，执行：
nvm install 22
nvm use 22
二、Git 安装
请自行下载并安装 Git for Windows，确保命令行可用。
三、OpenClaw 安装与配置
3.1 设置 PowerShell 策略
以管理员身份运行 PowerShell，执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
3.2 开始安装
执行以下命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
按提示允许公共网络访问。等待出现 OpenClaw 2026 即表示安装成功。
3.3 基础配置
- 选择
Yes确认个人专属使用。 - 保持默认 QuickStart 模式。
- 选择大模型厂商，推荐 Kimi。
- 若未创建密钥，请先前往 Moonshot AI 开放平台 获取 API Key。
- 在终端粘贴 Kimi API Key，选择
.cn后缀域名。 - 选择模型
kimi-2.5。 - 网络搜索工具建议跳过 (
Skip for now)。 - Skills 选择按需配置，无需求可跳过。
- 其他 API Key (Google, Notion 等) 如无需求选
No。 - Hooks 自动化规则直接跳过。
程序将自启动网关，推荐使用 Web UI 网页图形界面操作。
四、连接飞书机器人
4.1 创建飞书应用
- 登录 飞书开放平台。
- 创建企业自建应用，填写名称和描述。
- 添加机器人功能。
- 开通权限：输入
im:并全选。 - 创建并发布版本。
4.2 配置 OpenClaw
在 PowerShell 输入 openclaw config 重新配置：
- 选择 Local 本地运行。
- 选择 Channels 配置通讯方式。
- 选择 Configure/link 添加新渠道，找到飞书。
- 安装飞书插件。
- 输入飞书应用的 App Secret 和 App ID。
- 选择 WebSocket 通讯方式。
- 选择是否允许群聊响应（推荐 @机器人）。
- 私聊访问策略建议选择 Open 或 Pairing。
完成配置后，再次启动网关：
openclaw gateway
若提示 Gateway already running，说明已启动。
注意： 需在飞书开发者后台修改事件与回调为长连接，并订阅'接受消息'事件，同时开通通讯录权限。
五、测试对话
打开手机版飞书 APP，找到应用即可与 OpenClaw 对话。
六、常见问题
6.1 飞书应用未显示
检查是否已完成飞书机器人创建及权限发布。
6.2 无响应
检查网关是否运行。尝试重启：
openclaw gateway stop
openclaw gateway restart
七、关闭与暂停
临时停止服务：
openclaw gateway stop
彻底关闭开机自启：
- 按
Win + R，输入taskschd.msc。 - 找到
OpenClaw Gateway任务。 - 右键禁用或删除。
八、卸载
执行核心卸载命令：
openclaw uninstall --all --yes
npm uninstall -g openclaw
(若使用 pnpm 或 bun，请替换 npm 命令)
