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 替换为对应包管理器)


