windows 部署openclaw
在 Windows 系统上一步步搞定 OpenClaw 本地部署与配置
今天咱们来手把手走一遍 OpenClaw 在 Windows 环境下的完整安装和配置流程。整个过程会涉及到 Node.js 环境搭建、依赖安装、网络问题排查以及关键的 API Key 配置，准备好你的命令行工具，我们这就开始。
第一步：搭建 Node.js 运行环境
万事开头先搭环境。访问 Node.js 官网，下载并安装适用于 Windows 的稳定版本。
https://nodejs.org/dist/v22.13.1/node-v22.13.1-x64.msi
安装完成后，别忘了验证一下。打开你的 CMD 命令提示符，分别执行下面两条命令：
node --version
npm --version
如果成功显示出版本号，恭喜你，基础环境已经就绪。
第二步：安装 OpenClaw 主程序
接下来，我们通过 npm 全局安装 OpenClaw。在 CMD 中直接输入：
npm install -g openclaw
不过，事情很少有一帆风顺的。执行这个命令后，你很可能会遇到第一个门槛：Git 的 SSH 权限问题。
解决 Git SSH 与 SSL 证书问题
遇到上述问题不用慌，这是常见的网络配置冲突。我们可以通过修改 Git 的全局配置，强制其使用 HTTPS 协议来代替 SSH。在 CMD 里输入以下命令：
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"
紧接着，另一个老朋友可能也会来“打招呼”——SSL 证书验证失败。
作为临时的解决方案，我们可以先关闭 Git 的 SSL 验证。尝试用下面这个加强版的安装命令：
npm install -g openclaw --unsafe-perm
如果问题依旧，那就需要我们更彻底地调整 Git 配置。依次执行下面这三条命令，组合拳效果更佳：
git config --global http.sslverify false
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"
npm install -g openclaw
应对网络超时：切换到国内镜像源
“网络超时”——看到这几个字，老手们大概会心一笑了。这通常是访问 GitHub 受限的典型表现。别担心，我们有备选方案：换用国内的 npm 镜像源，速度会快上不少。
执行以下命令切换源，并强制重新安装：
npm config set registry https://registry.npmmirror.com
npm install -g openclaw --force
瞧，安装成功的提示出来了。到这里，核心程序就已经稳稳地躺在你的系统里了。
第三步：启动并配置 OpenClaw 网关服务
安装完成只是第一步，接下来要让服务跑起来。在 CMD 中输入命令启动网关：
openclaw gateway
这里有个关键提醒：千万不要在这个窗口按 Ctrl+C，否则会直接停止服务。我们需要让它保持在后台运行。
然后，新开一个 CMD 窗口，用来执行后续的管理命令。在新窗口里，我们先检查一下网关状态：
openclaw gateway status
看到服务正在运行，就可以进行安全配置了。为了保证访问安全，我们需要设置一个认证令牌（Token）。
设置一个新的 Token
在新 CMD 窗口里执行：
openclaw config set gateway.auth.token my-token-12345
openclaw gateway restart
设置完成后，打开你的浏览器，访问本地网关地址：
http://127.0.0.1:18789/
页面会提示输入 Token，就把刚才设置的 my-token-12345 填进去。
登录成功，你就进入了 OpenClaw 的仪表盘，可以开始尝试聊天了。
第四步：解决模型配置与 API Key 问题
虽然界面能打开了，但当你开始对话时，可能会发现新的报错：模型虽然识别正确（比如 kimi-coding），但系统提示找不到 Kimi 的 API Key。这意味着我们只完成了平台部署，还没给平台“接上”AI大脑。
下面就来解决这个问题。
1. 获取 Kimi API Key
首先，你需要一个可用的 Kimi API Key。访问 Moonshot AI 的开放平台：
https://platform.moonshot.cn/
登录你的账号，在账户或API管理部分，创建一个新的 API Key，并妥善保存下来。
2. 在 OpenClaw 中配置 API Key
回到命令行，运行配置向导：
openclaw configure
首先会让你选择运行模式，这里我们选择 Local（本地运行）。
接下来是关键步骤：为模型配置 API key。
在模型列表中找到并选择 Moonshot AI (Kimi K2.5)。
这里要注意：因为你是在 platform.moonshot.cn 这个国内版平台获取的 Key，所以配置项应该选择 Kimi API key (.cn)。
按回车继续，然后在提示框内粘贴你刚刚保存的 API Key。
看到配置成功的提示，说明 AI 大脑已经接上了。向导通常会默认将 moonshot/kimi-k2.5 设置为你的首选模型。
按回车确认选择，并继续完成配置向导剩下的步骤。
配置完成后，需要重启网关服务来让新配置生效。回到运行 openclaw gateway 的那个命令行窗口：
1. 按下 Ctrl + C 停止当前服务。
2. 重新输入 openclaw gateway 启动。
现在，再次刷新你的浏览器仪表盘页面，或者重新发起对话测试一下。一切顺利的话，你的本地 OpenClaw 现在已经是一个能调用 Kimi 大模型、功能完整的 AI 助手了。