windows 部署openclaw

在 Windows 系统中部署配置 OpenClaw 的完整指南

本文将为您提供一份详尽的教程，指导您在 Windows 操作系统上完成 OpenClaw 的本地安装与配置。我们将循序渐进，涵盖从搭建 Node.js 运行环境、处理常见的网络安装错误，到正确配置 API 密钥以连接 Kimi 大模型的全部关键步骤。准备好您的命令提示符，让我们即刻开始。

第一步：安装与配置 Node.js 运行环境

部署任何基于 Node.js 的应用，第一步都是配置好相应的基础环境。请前往 Node.js 官方网站，下载适用于 Windows 系统的最新长期支持版本（LTS）并进行安装。

https://nodejs.org/dist/v22.13.1/node-v22.13.1-x64.msi

完成安装后，为了确保环境准备妥当，需要验证安装是否成功。请以管理员身份打开 CMD 命令提示符，依次输入并执行以下两条命令：

node --version

npm --version

若命令行正确地显示出 Node.js 和 npm 的版本号，则表明基础环境已成功搭建，可以进行下一步操作。

第二步：通过 npm 安装 OpenClaw 主程序

接下来，我们将使用 Node.js 的包管理工具 npm 来全局安装 OpenClaw。在 CMD 窗口中输入以下命令：

npm install -g openclaw

然而，在实际操作中，您可能会首先遇到一个常见障碍：Git 的 SSH 协议权限问题，导致克隆仓库失败。

处理 Git SSH 及 SSL 证书验证错误

若出现上图所示错误，无需紧张。这通常是因为网络环境对 SSH 协议有限制。我们可以通过修改 Git 的全局配置，强制其将 SSH 链接转换为更通用的 HTTPS 链接。在 CMD 中执行：

git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

此外，另一个常见问题是 SSL 证书验证失败，这同样会阻碍从 GitHub 拉取依赖。

为了绕过此问题（请注意，这仅作为开发环境的临时解决方案），可以尝试在安装命令中添加参数，临时放宽权限并忽略部分安全校验：

npm install -g openclaw --unsafe-perm

如果问题依旧存在，推荐执行一套组合命令，从根源上调整 Git 配置，一劳永逸地解决 SSL 和协议问题：

git config --global http.sslverify false

git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

npm install -g openclaw

应对网络超时：启用国内 npm 镜像加速

在安装过程中，如果长时间卡顿或提示“网络超时”（Network Timeout），这通常是由于访问 npm 官方源或 GitHub 速度过慢或受限所致。此时，更换为国内的 npm 镜像源是最高效的解决办法。

执行以下命令，将 npm 的注册表源切换至国内镜像，并使用强制参数重新执行安装：

npm config set registry https://registry.npmmirror.com

npm install -g openclaw --force

至此，当看到“安装成功”的提示信息后，表明 OpenClaw 的核心程序已正确部署到您的系统中。

第三步：启动 OpenClaw 网关并进行基础配置

安装成功只是完成了部署的一半，接下来需要启动核心的网关服务。在您的 CMD 窗口中输入启动命令：

openclaw gateway

重要提示：请勿在此窗口中按下 Ctrl+C，否则会导致网关服务立即终止。请保持此窗口运行，以便服务在后台持续工作。

随后，请另外打开一个新的 CMD 窗口，用于执行后续的配置和管理命令。在新窗口中，首先检查网关服务的运行状态：

openclaw gateway status

确认服务状态为“运行中”后，为了提高本地访问的安全性，我们需要为其设置一个访问令牌。请在该新窗口继续执行命令。

生成并设置访问令牌

在新 CMD 窗口里依次执行以下命令来设置令牌并重启服务使其生效：

openclaw config set gateway.auth.token my-token-12345

openclaw gateway restart

配置完成后，打开您常用的浏览器，在地址栏中输入 OpenClaw 的本地网关地址进行访问：

http://127.0.0.1:18789/

页面将自动跳转并要求输入访问令牌，请输入您刚才设定的 my-token-12345。

登录成功后，您将进入 OpenClaw 的 Web 管理仪表盘界面，现在可以尝试与界面进行初步的交互了。

第四步：配置 AI 模型 API 密钥以启用完整功能

虽然 Web 界面可以正常访问，但当你尝试发起对话时，可能会收到错误提示，指出“找不到 Kimi 的 API Key”。这表示当前 OpenClaw 平台本身已就绪，但尚未接入后端的人工智能模型。让我们来解决这个核心配置问题。

1. 获取 Moonshot (Kimi) AI 的 API Key

首先，您需要拥有一个有效的 Kimi API 密钥。请访问 Moonshot AI 的官方开放平台：

https://platform.moonshot.cn/

完成登录后，在个人中心或“API 管理”相关页面，创建一个新的 API 密钥，并务必将这一长串密钥复制并保存在安全的地方。

2. 在 OpenClaw 中配置获取到的 API Key

返回到我们用于执行管理命令的 CMD 窗口，运行 OpenClaw 的交互式配置向导：

openclaw configure

配置向导首先会询问运行模式，为进行本地部署，请选择 Local（本地运行）选项。

接下来，向导会引导您为需要使用的 AI 模型配置访问凭证。

在呈现的模型列表中，找到并选择 Moonshot AI (Kimi K2.5) 这一项。

这里有一个关键点：由于您的 API Key 是从国内版平台 platform.moonshot.cn 获取的，因此在配置时务必选择对应国内端点的 Kimi API key (.cn) 选项。

按下回车确认后，在随后的输入提示框中，粘贴您之前保存好的 API 密钥。

看到“配置成功”的提示，意味着 OpenClaw 已成功关联到 Kimi 大模型。配置向导通常会默认将刚配置好的 moonshot/kimi-k2.5 模型设为您的主要聊天模型。

按回车确认此默认选择，并依照提示完成配置向导剩余的非关键步骤。

所有配置完成后，必须重启网关服务才能使新的 API Key 生效。切换回最初运行 openclaw gateway 的命令行窗口：

1. 按下 Ctrl + C 来停止当前正在运行的网关服务。

2. 再次输入 openclaw gateway 命令并执行，以重新启动服务。

现在，请刷新浏览器中的 OpenClaw 仪表盘页面，或新建一个对话进行测试。如果一切步骤都正确无误，您的本地 OpenClaw 现在就已经是一个能够流畅调用 Kimi 大模型能力的、功能完备的 AI 助手了。