Windows 本地安装 OpenClaw 完整指南

Posted on | In , |
Words count in article: 7.5k | Reading time ≈ 7 mins.

OpenClaw 是一个强大的 AI Agent 平台，支持多种模型和工具集成。本文将详细介绍如何在 Windows 本地安装和配置 OpenClaw，让你能够快速搭建自己的 AI Agent 环境。

前言

OpenClaw 是一个开源的 AI Agent 框架，支持本地部署，可以连接多种大语言模型（如 Moonshot、OpenAI 等），并提供丰富的工具集成（浏览器控制、文件操作、代码执行等）。相比在线服务，本地部署具有更好的隐私性和可控性。

环境准备

在开始安装之前，我们需要准备以下工具：

1. 安装 Git

Git 用于后续可能的源码操作。

下载地址: https://git-scm.com/download/win

安装过程中保持默认选项即可。

2. 安装 nvm-windows

nvm (Node Version Manager) 用于管理 Node.js 版本。

下载地址: https://github.com/coreybutler/nvm-windows/releases

下载 nvm-setup.exe 并安装。安装完成后，打开 PowerShell 验证：

1
2
nvm version
# 应显示版本号，如 1.1.12

3. 安装 Node.js

⚠️ 重要提示: OpenClaw 要求 Node.js 版本必须 大于等于 22！

使用 nvm 安装 Node.js 22：

1
2
3
4
5
6
7
8
9
10
11
12
# 查看可用版本
nvm list available

# 安装 Node.js 22
nvm install 22

# 使用该版本
nvm use 22

# 验证安装（应显示 v22.x.x）
node -v
npm -v

为什么不能低于 22 版本？

  • OpenClaw 使用了 Node.js 22 引入的新特性
  • 低版本会导致安装失败或运行时错误
  • 确保使用 nvm use 22 切换到正确版本

安装 OpenClaw

⚠️ 重要提示: 由于网络原因，安装时建议使用代理。

1. 使用 npm 全局安装

如果你已经有代理工具（如 Clash、V2Ray 等），确保终端走代理：

1
2
3
4
5
6
# 设置代理（根据你的代理端口调整）
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

# 全局安装 OpenClaw
npm install -g openclaw@latest

安装过程可能需要几分钟，请耐心等待。

2. 初始化 OpenClaw

安装完成后，运行 onboarding 命令进行初始化：

1
openclaw onboard --install-daemon

这个命令会：

  • 创建必要的配置文件
  • 安装系统服务（daemon）
  • 引导你完成初始设置

模型配置建议

强烈推荐使用 Moonshot Kimi K2.5

经过综合测试，强烈推荐使用 Moonshot 的 Kimi K2.5 模型，原因如下：

特性 Kimi K2.5 其他模型
中文理解 ⭐⭐⭐⭐⭐ 优秀 一般
代码能力 ⭐⭐⭐⭐⭐ 强大 良好
长上下文 ⭐⭐⭐⭐⭐ 支持 200K 较短
成本效益 ⭐⭐⭐⭐⭐ 性价比高 一般
响应速度 ⭐⭐⭐⭐ 快速 不一

配置示例 (~/.openclaw/config.yaml):

1
2
3
4
5
6
7
8
models:
  default: "moonshot/kimi-k2.5"
  
  moonshot/kimi-k2.5:
    provider: moonshot
    model: "kimi-k2.5"
    max_tokens: 8192
    temperature: 0.7

总结

通过本文的步骤，你应该已经成功在 Windows 本地安装了 OpenClaw。记住以下关键点：

  1. ✅ Node.js 版本必须 >= 22
  2. ✅ 使用 nvm 管理 Node.js 版本
  3. ✅ npm install 时务必使用代理或镜像
  4. ✅ 使用 openclaw onboard --install-daemon 初始化
  5. ✅ 强烈推荐使用 Moonshot Kimi K2.5 模型
  6. ✅ 妥善保管 API 密钥

现在你可以开始探索 OpenClaw 的强大功能了！

相关链接:

Happy Coding with OpenClaw! 🤖