OpenClaw 本地部署教程（Windows）
本文介绍在 Windows 环境下使用 Node.js 22 和 Git 部署 OpenClaw 智能体的完整流程。通过 nvm 管理 Node 版本，结合 Kimi 大模型 API 作为核心大脑，并集成飞书机器人实现消息交互。
环境准备
1. 安装 Node.js (nvm)
建议使用 nvm (Node Version Manager) 管理 Node.js 版本，避免全局安装导致的冲突。
1.1 检查当前版本
打开终端（cmd 或 PowerShell），输入以下指令查看已安装的 Node.js 版本：
nvm ls
显示结果中带有星号 * 的表示当前激活版本。
1.2 安装指定版本
如需安装 v22+ 版本，执行以下命令：
nvm install 22
切换至该版本：
nvm use 22
再次运行 nvm ls 确认当前版本为 22.x。
2. 安装 Git
请前往 Git 官网下载 Windows 安装包并完成安装。
OpenClaw 安装与配置
3.1 初始化安装
以管理员身份运行 PowerShell，设置执行策略：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
输入 Y 确认。
执行安装脚本：
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程中若弹出网络访问权限请求，请选择允许。等待提示 "OpenClaw 2026" 即表示安装成功。
3.2 基础配置
安装完成后，按提示选择配置模式：
- 选择个人专属使用（Yes）。
- 保持默认 QuickStart 模式。
- 选择大模型厂商，推荐 Kimi（Moonshot AI）。
- 后续需配置 API Key，请先暂停此步骤去创建密钥。
3.3 创建 Kimi API Key
- 登录 Moonshot AI 开放平台。
- 进入账户总览查看余额。
- 在 API key 管理页面点击新建 API key。
- 复制密钥并妥善保管。
3.4 配置大模型
回到 PowerShell 窗口：
- 向下选择 Kimi 模型，回车。
- 选择
.cn后缀区域，回车。 - 粘贴刚才创建的 API Key，回车。
- 选择默认模型
kimi-2.5，回车。 - 关于网络搜索工具，建议初次尝试选择
Skip for now。 - Skills 选择：根据需求勾选，无特殊需求可直接跳过。
- 其他 API Key（如 Google, Notion 等）若无账号，统一选择 No。
- Hooks 自动化规则选择
Skip for now。 - 程序将自启动网关，不要关闭弹出的命令窗口。
- 推荐使用 Web UI 网页图形界面进行交互，回车打开。
飞书机器人集成
4.1 创建飞书应用
- 登录飞书开放平台，创建企业自建应用。
- 填写应用名称和描述。
- 添加机器人功能。
- 开通权限：输入
im:并全选确认。 - 创建版本并保存。
4.2 连接飞书机器人
在 PowerShell 中输入 openclaw config 重新配置：
- 选择 Local 本地运行。
- 选择 Channels 配置通讯方式。
- 选择 Configure/link 添加新渠道。
- 找到飞书选项，回车。
- 安装飞书插件，回车。
- 获取 App Secret：在飞书开发者后台凭证与基础信息页复制 App Secret 并粘贴。
- 复制 App ID 并粘贴。
- 选择 WebSocket (default) 通讯方式。
- 选择国内飞书环境。
- 群聊权限：选择
Open - respond in all groups (requires mention)。 - 私聊访问策略：测试环境建议选择 Open，正式环境建议 Pairing。
- 完成配置后，输入
openclaw gateway启动网关。
若提示 Gateway failed to start (gateway already running)，说明服务已在运行，无需重复启动。
4.3 配置事件订阅
- 在飞书开发者后台，点击左侧'事件与回调'。
- 选择长连接保存。
- 添加事件：搜索'接受消息'并勾选。
- 权限管理：开通通讯录权限，获取基本信息。
- 创建版本并发布。
测试对话
打开手机版飞书 APP，找到应用中的机器人，发送消息即可开始对话。
常见问题
6.1 飞书应用未显示
检查是否已完成机器人配置及权限开通。
6.2 OpenClaw 回复无响应
检查网关是否正常运行。可在 PowerShell 中运行以下命令重启：
openclaw gateway stop
openclaw gateway restart
关闭与卸载
7.1 暂停服务
不想使用时，可在终端输入：
openclaw gateway stop
这将停止后台服务，Web 界面和聊天功能暂时不可用。
7.2 禁用开机自启
- 按
Win + R，输入taskschd.msc打开任务计划程序。 - 在右侧列表中找到 "Openclaw Gateway"。
- 右键点击选择'禁用'或'删除'。
7.3 彻底卸载
- 打开终端（Terminal/CMD/PowerShell）。
- 执行核心卸载命令：
openclaw uninstall --all --yes
- 删除命令行工具：
npm uninstall -g openclaw
(若当初使用 pnpm 或 bun 安装，请将 npm 替换为对应包管理器)
