一、环境准备（必做）

组件	版本要求	下载地址
Node.js	≥ 22.0.0（推荐 24+）	https://nodejs.org/
Git	最新版	https://git-scm.com/download/win
系统	Windows 10 1903+ / Windows 11	-
内存	≥ 4GB（推荐 8GB+）	-

安装步骤：

1. 安装 Git（默认选项即可）
2. 安装 Node.js（选择 LTS 版本）
3. 验证安装：

node -v    # 应显示 v22.x 或更高
npm -v     # 应显示版本号
git --version

二、安装 OpenClaw（三种方式）

方式 1：npm 全局安装（推荐）

# 配置国内 npm 源（加速下载）
npm config set registry https://registry.npmmirror.com

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

# 验证安装
openclaw --version

方式 2：PowerShell 一键脚本

# 以管理员身份运行 PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

方式 3：中文社区版（国内用户推荐）

npm install -g openclaw-cn@latest

三、初始化配置

# 运行配置向导
openclaw onboard --install-daemon

# 或创建配置目录
mkdir C:\Users\%USERNAME%\.openclaw

配置文件位置

系统	配置路径
Windows	C:\Users\<用户名>\.openclaw\config.yaml
macOS/Linux	~/.openclaw/config.yaml

配置示例（config.yaml）

# 大模型 API 配置
llm:
  provider: "moonshot"  # 或 deepseek、openai 等
  api_key: "your_api_key_here"
  model: "moonshot-v1-8k"

# 服务配置
server:
  port: 3000
  host: "127.0.0.1"

# 渠道配置（可选）
channels:
  - type: "discord"
    token: "your_discord_token"
  - type: "telegram"
    token: "your_telegram_token"

四、启动与验证

# 启动 OpenClaw
openclaw start

# 查看帮助
openclaw --help

# 检查状态
openclaw doctor

# 查看日志
openclaw logs

验证成功标志

• 命令行显示 OpenClaw Logo
• Web 面板可访问：http://localhost:3000
• openclaw --version 返回版本号（如 2026.2.6-3）

五、API 接入（与大模型对接）

OpenClaw 本身不提供 API，而是作为本地 AI 代理网关，连接各大模型服务：

支持的模型提供商

提供商	API 获取地址
Moonshot (Kimi)	https://platform.moonshot.cn/
DeepSeek	https://platform.deepseek.com/
OpenAI	https://platform.openai.com/
阿里云通义	https://dashscope.aliyun.com/

Python 调用示例（通过 OpenClaw 转接）

import requests

# OpenClaw 本地服务端口
url = "http://localhost:3000/api/v1/chat"
headers = {"Content-Type": "application/json"}
data = {
    "message": "帮我整理今天的待办事项",
    "model": "moonshot-v1-8k"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

六、常见问题解决

问题	解决方案
npm 安装失败	切换国内源：npm config set registry https://registry.npmmirror.com
Node.js 版本过低	升级至 22+：npm install -g n && n 24
命令不存在	重启终端，或检查 npm 全局路径是否在 PATH 中
端口占用	修改 config.yaml 中的 port 配置
API 连接失败	检查 API Key 有效性，确认网络可访问 API 端点
配置文件错误	运行 openclaw doctor 检查并修复

七、升级与卸载

# 升级 OpenClaw
npm install -g openclaw@latest
# 或
openclaw update

# 卸载
npm uninstall -g openclaw

# 清理配置（谨慎操作）
rmdir /s /q C:\Users\%USERNAME%\.openclaw

⚠️ 安全提示

1. 权限风险：OpenClaw 可执行系统命令，请在可信环境运行
2. API 密钥：不要将 config.yaml 上传到公开仓库
3. 建议：重要数据请在虚拟机或备用设备上测试

官方资源

资源	地址
官网	https://openclaw.ai/
GitHub	https://github.com/openclaw/openclaw
文档	https://docs.openclaw.ai/
社区	https://discord.gg/openclaw