OpenClaw Windows 版部署与 DeepSeek API 配置指南

对于大多数个人开发者及中小规模调用，DeepSeek 的 API 性价比更高。

二、环境准备

首先确保 Windows 系统基础环境就绪。

2.1 安装 Node.js

1. 访问 Node.js 官网。
2. 下载 LTS 版本（推荐 22.x.x）。
3. 安装时务必勾选以下三项：
   • ✅ Node.js runtime
   • ✅ npm package manager
   • ✅ Add to PATH
4. 安装路径建议保持默认：C:\Program Files\nodejs\
5. 安装完成后重启电脑以确保环境变量生效。

2.2 验证环境

以管理员身份打开 PowerShell，执行以下命令：

node -v
npm -v

期望输出类似如下版本号：

v22.14.0
11.9.0

三、安装 Git（OpenClaw 依赖）

OpenClaw 依赖 Git 进行部分版本管理操作。

3.1 下载安装

访问 Git 官网：https://git-scm.com/，下载 64-bit Git for Windows Setup。

3.2 安装选项详解（关键步骤）

3.3 验证 Git

git --version

四、安装 OpenClaw

4.1 执行安装命令

方法一：使用官方源（默认）

npm install -g openclaw@latest

方法二：安装 cnpm（淘宝镜像客户端）

若网络环境受限，建议使用 cnpm：

npm install -g cnpm --registry=https://registry.npmmirror.com

随后使用 cnpm 安装：

cnpm install -g openclaw@latest

注意：若使用的是中文镜像版本，后续所有命令前缀请替换为 openclaw-cn。

4.2 验证安装

openclaw --version

期望输出类似：

2026.2.26 或类似版本号

五、配置 DeepSeek API（核心步骤）

5.1 启动配置向导

openclaw onboard

5.2 配置选项一览表（按顺序）

5.3 网关配置

5.4 附加功能配置

六、常见报错及解决方案

6.1 ENOENT / spawn git 错误

现象：安装 OpenClaw 时报错找不到 git 原因：Git 未安装或未添加到 PATH 解决：

1. 重新安装 Git，务必在 PATH 选择界面选中间选项
2. 重启 PowerShell 后验证 git --version

6.2 No API key found for provider "anthropic"

现象：启动后报错找不到 Anthropic 的 API Key 原因：默认代理仍指向 Anthropic 解决：

# 查看当前默认模型
openclaw config get agents.defaults.model.primary

# 修改为 DeepSeek
openclaw config set agents.defaults.model.primary custom-api-deepseek-com/deepseek-chat

# 重启服务
openclaw gateway restart

6.3 Model context window too small (4096 tokens)

现象：提问时报错上下文太小 原因：OpenClaw 未正确识别 DeepSeek 的 128K 上下文 解决：

# 设置正确的上下文窗口
openclaw config set 'models.providers.custom-api-deepseek-com.models[0].contextWindow' 128000
openclaw config set 'models.providers.custom-api-deepseek-com.models[0].maxTokens' 128000

# 重启服务
openclaw gateway restart

6.4 Config validation failed: Unrecognized key

现象：配置文件语法错误 原因：手动修改配置时引入格式错误 解决：

# 自动修复
openclaw doctor --fix

# 或完全重置
openclaw config reset --force
openclaw onboard

6.5 Gateway restart timed out

现象：重启服务超时 原因：服务进程卡死或端口被占用 解决：

# 强制停止所有进程
openclaw gateway stop --force

# 重新启动
openclaw gateway start

七、日常使用命令

7.1 启动服务

openclaw gateway start

7.2 访问 Web 界面

方法一：端口访问

http://127.0.0.1:18789/?token=你保存的token

方法二：指令行访问

openclaw dashboard

7.3 常用命令速查表

英文原版镜像常用命令

中文镜像常用命令

主要区别在于命令前缀是否包含 -cn。

八、性能优化

8.1 启用 MemBrain 记忆系统

openclaw config set memory.membrain.enabled true
openclaw config set memory.membrain.size "10GB"
openclaw gateway restart

8.2 启用 Her 协议优化

openclaw config set prompt.protocols.her.enabled true
openclaw gateway restart

8.3 验证优化配置

openclaw config get | findstr "contextWindow memory her"

九、故障排查清单

如遇其他问题，建议查阅官方文档或社区支持。