简介
OpenClaw 是一个行动式智能体（AI Agent），支持本地化部署和隐私安全。它通过安装各种 Skills（技能）来接管工作流，可结合 Kimi 大模型与飞书生态构建全天候 AI 助手。
本教程将指导你在 Windows 环境下，使用 nvm 管理 Node.js 22+ 版本，通过 PowerShell 安装 OpenClaw，并配置 Kimi API 密钥及飞书机器人连接。
一、Node.js 环境搭建
建议使用 nvm (Node Version Manager) 管理 Node.js 版本，避免全局安装导致的冲突。
1.1 安装 nvm
下载并安装 nvm for Windows。安装完成后打开终端验证。
1.2 安装 Node.js v22+
确保 Node.js 版本大于等于 22.x LTS。
检查当前版本：
nvm ls
若没有 22 版本，执行以下命令安装并切换：
nvm install 22
nvm use 22
再次确认版本：
nvm ls
二、Git 安装
请确保系统已安装 Git。如未安装，请前往 Git 官网下载安装包并完成配置。
三、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（Moonshot AI），因其对中文长文本支持较好且新用户有额度赠送。 - 创建 Kimi API Key：
- 登录 Moonshot AI 开放平台。
- 在账户总览查看余额。
- 进入 API key 管理页面，点击新建 API key 并复制保存。
- 配置模型：
- 回到 PowerShell，选择 Kimi 模型。
- 选择
.cn后缀域名。 - 粘贴刚才创建的 API Key。
- 选择默认模型
kimi-2.5。
- 工具与技能：
- 网络搜索：初次尝试建议跳过 (
Skip for now)。 - Skills：根据需求选择，无特殊需求可直接跳过。
- 其他 API Key：如无特定服务账号（如 Google, Notion, OpenAI 等），全部选择
No。 - 自动化钩子 (Hooks)：选择跳过。
- 网络搜索：初次尝试建议跳过 (
- 启动网关：程序会自动启动网关窗口，请勿关闭。
- Web UI：在 PowerShell 中选择 Web UI 网页图形界面进行交互。
四、连接飞书机器人
4.1 创建飞书应用
- 登录 飞书开放平台。
- 进入开发者后台，点击创建企业自建应用。
- 填写应用名称和描述。
- 添加机器人功能。
- 权限管理：
- 开通
im:相关权限。 - 创建版本并保存。
- 开通
- 事件与回调：
- 选择长连接保存方式。
- 添加订阅事件：接收消息。
- 开通通讯录权限（获取基本信息）。
- 再次创建版本并发布。
4.2 配置 OpenClaw 连接
在 PowerShell 中运行配置命令：
openclaw config
按以下步骤操作：
- 选择
Local本地运行。 - 选择
Channels配置通讯方式。 - 选择
Configure/link添加新渠道，找到并选择Feishu。 - 安装飞书插件（直接回车）。
- 输入 App Secret：从飞书开发者后台的凭证与基础信息页复制。
- 输入 App ID：同样从飞书后台复制。
- 选择通讯方式：
WebSocket (default)。 - 区域选择：国内飞书直接回车。
- 群聊权限：选择
Open - respond in all groups (requires mention)。 - 私聊访问策略：测试阶段可选择
Open，生产环境推荐Pairing。 - 完成配置后，启动网关：
openclaw gateway
若提示 Gateway already running，说明已在运行，无需重复启动。
五、测试对话
打开手机版飞书 APP，找到应用中的机器人，发送消息即可与 OpenClaw 对话。
六、常见问题
6.1 飞书应用未显示
检查是否已完成飞书机器人的创建及权限配置步骤。
6.2 OpenClaw 回复无响应
检查网关是否正常运行。可在 PowerShell 中运行以下命令重启：
openclaw gateway stop
openclaw gateway restart
七、暂停与停止
7.1 临时停止
如需释放资源或暂时禁用，在终端输入：
openclaw gateway stop
7.2 彻底关闭开机自启
- 按
Win + R，输入taskschd.msc打开任务计划程序。 - 在左侧文件夹中找到
OpenClaw Gateway。 - 右键点击选择'禁用'或'删除'。
八、卸载
如需彻底移除 OpenClaw，请在终端执行：
openclaw uninstall --all --yes
npm uninstall -g openclaw
(若当初使用 pnpm 或 bun 安装，请将 npm 替换为对应命令)
