OpenClaw 安装与配置完整教程(Windows)
一、环境准备
安装 OpenClaw 的首要步骤是搭建运行环境。该工具基于 Node.js 构建,因此首先确保您的系统已安装 Node.js 运行环境。
1 安装 Node.js
请访问 Node.js 官方网站下载安装程序:
https://nodejs.org
建议选择最新的 LTS(长期支持)版本以确保最佳稳定性与兼容性。当然,当前最新的稳定版本同样适用。
下载完成后,运行安装程序并遵循引导步骤完成安装。安装结束后,请打开终端或命令提示符,执行以下命令以验证安装结果:
node -v
npm -v
若环境配置正确,终端将分别显示 Node.js 与 npm 的版本信息,示例如下:
v20.x.x
10.x.x
确认两个版本号成功显示,即代表 Node.js 环境部署完毕。
二、安装 OpenClaw
基础环境就绪后,即可安装 OpenClaw 核心工具。我们通过 npm 包管理器进行全局安装,以便在任意目录调用。
在终端中运行以下安装命令:
npm install -g openclaw
安装过程通常耗时约一两分钟。完成后,请执行版本检查命令进行验证:
openclaw --version
若终端返回类似下方的版本信息,则表明 OpenClaw 已成功安装在您的系统中。
OpenClaw 2026.x.x
三、配置 Kimi API Key(首次注册送15元token)
OpenClaw 作为智能网关,需通过接入 Kimi AI 模型来实现功能激活。为此,您需获取一个有效的 API 访问密钥。
请登录 Kimi AI 开放平台获取您的专属 API Key:
https://platform.moonshot.cn
登录后,请导航至:控制台 → API Key → 创建 Key。
点击创建后,系统将生成一个格式为 sk-xxxxxxxxxxxx 的密钥字符串。
重要提示:该 API Key 是您的核心访问凭证,务必安全保管,接下来的配置步骤将立即用到它。
四、初始化配置
完成工具安装与密钥获取后,下一步是运行初始化配置向导,以建立工具与模型服务间的连接。
在终端中执行以下命令启动配置程序:
openclaw configure
执行后,命令行将进入交互式配置向导,请您根据屏幕提示逐步完成设置。
五、配置 Gateway
在配置向导中,首先需要设定网关服务的运行位置:
Where will the Gateway run? (Gateway 将在哪里运行?)
对于本地开发与测试用途,请选择 Local (this machine) 选项。
此配置意味着网关服务将运行于您的本地计算机,并默认监听地址:ws://127.0.0.1:18789。后续所有 API 请求都将通过此本地地址进行代理转发。
六、配置 Model
接下来进入核心环节——配置 AI 模型。请在配置菜单中选择:
Select sections to configure (选择要配置的模块)
然后从列表中选择 Model 模块。
在模型提供商列表中,定位并选择:Moonshot AI (Kimi K2.5)。
随后,向导将提示您输入:Kimi API key (.cn)。
请将您先前保存的 API 密钥准确粘贴至此处。确认提交后,模型配置即告完成。
七、启动 Gateway
全部配置完成后,即可启动本地网关服务。
在终端中运行以下启动命令:
openclaw gateway
若配置无误,终端将开始输出运行日志。成功启动的日志会包含类似以下信息:
[gateway] agent model: moonshot/kimi-k2.5
[gateway] listening on ws://127.0.0.1:18789
当看到 listening on... 提示行时,表明本地网关已成功启动并在指定端口监听。请保持此终端窗口开启,以维持网关服务的运行状态。
八、打开 Dashboard 控制面板
网关服务在后台运行后,您可以通过 Web 控制面板与其进行可视化交互。请开启一个新的终端窗口(切勿关闭运行网关的窗口)。
在新终端中,执行以下命令以启动控制面板:
openclaw dashboard
命令执行后,您的默认浏览器通常会自动打开一个本地网页,例如:http://127.0.0.1:18789/#token=xxxx。此页面即为 OpenClaw 的 Web 管理控制台。
九、测试连接
最后一步是进行端到端的功能验证,确保整个链路畅通无误。
请在控制面板的聊天对话框中,输入简单的测试语句:
你好
然后按回车键发送。
如配置一切正确,您将在短时间内看到 Kimi 模型返回的响应内容。成功接收到答复,即标志着您的 OpenClaw 开发环境已完全就绪,可以投入实际应用。

