简介
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 替换为对应命令)


