OpenClaw 安装与配置完整教程(Windows)

2026-05-06阅读 0热度 0
ai OpenClaw

一、环境准备

安装 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 开发环境已完全就绪,可以投入实际应用。


免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策