Windows彻底重装 OpenClaw 教程：告别本地模型，接入 DeepSeek API

OpenClaw 是一个功能强大的开源 AI 助手框架，但很多用户在初始安装时可能配置了本地模型（如 LM Studio、Ollama），或者遇到了各种环境问题。本文将带你一步步彻底卸载旧版、清理残留，然后从零重装并配置 DeepSeek API，让你拥有一个干净、稳定的 OpenClaw 环境。

适用环境

• Windows 10 / 11
• Node.js（npm）
• DeepSeek API（无需本地大模型）

本文目标

• ✅ openclaw 命令可用
• ✅ 浏览器打开 http://127.0.0.1:18789 能进入 Dashboard
• ✅ 发消息 → DeepSeek 回复
• ❌ 不再碰 127.0.0.1:1234（本地 LM Studio / Ollama 的历史残留直接斩断）

一、准备工作

1.1 确认 Node.js / npm 正常

node -v
npm -v

建议 Node.js 20 LTS 或以上。低于 v18 可能会遇到兼容性问题。

1.2 关掉可能干扰的服务

LM Studio：完全退出（别只关窗口，确认右下托盘也没有残留图标）。

Ollama：如果有运行，停掉它：

taskkill /F /IM ollama.exe 2>$null

1.3 获取 DeepSeek API Key

前往 DeepSeek 开放平台 创建 API Key，复制保存好（只显示一次）。

最低先充 ¥2 即可测试，否则会遇到 402 Payment Required。

二、彻底卸载（关键步骤）

2.1 停掉旧服务

openclaw gateway stop 2>$null
openclaw gateway uninstall 2>$null

2.2 卸载 npm 包

npm uninstall -g openclaw 2>$null

2.3 清理残留目录（重点）

$paths = @(
    "$env:USERPROFILE\.openclaw",
    "$env:APPDATA\Temp\openclaw",
    "$env:LOCALAPPDATA\Temp\openclaw"
)
foreach ($p in $paths) {
    if (Test-Path $p) {
        Remove-Item $p -Recurse -Force
        Write-Host "已删除: $p"
    }
}

2.4 确认清理干净

Test-Path "$env:USERPROFILE\.openclaw"

应返回 False。如果仍是 True，通常是资源管理器预览窗格还挂着该文件夹，关闭所有 Explorer 窗口再删一次。

三、重装

一条命令搞定：

npm install -g openclaw@latest

验证安装：

openclaw --version

能看到版本号（例如 2026.5.28）即安装成功。

四、配置 DeepSeek API

这一步决定你后续使用体验是否顺畅。

4.1 启动配置向导

openclaw onboard

4.2 按以下选项选择

如果 onboard 在某步卡住或闪回，不要硬扛，直接跳转到下面的手写配置文件方案。

4.3 手写配置文件（最稳方案）

编辑配置文件：

notepad "$env:USERPROFILE\.openclaw\openclaw.json"

粘贴以下内容（替换 sk-你的真实key）：

{
  "model": {
    "provider": "openai-compatible",
    "baseUrl": "https://api.deepseek.com",
    "id": "deepseek-chat",
    "apiKey": "sk-你的真实key",
    "contextWindow": 32768,
    "maxTokens": 8192
  },
  "gateway": {
    "bind": "loopback",
    "port": 18789
  }
}

验证 JSON 格式：

Get-Content "$env:USERPROFILE\.openclaw\openclaw.json" -Raw | ConvertFrom-Json | select model, gateway

能正常打印即合法。

五、启动与验证

5.1 前台运行（方便看真实错误）

openclaw gateway run

✅ 成功标志：

Gateway listening on http://127.0.0.1:18789

❌ 如果报错，仔细看终端前 20 行输出——根因一定就在那里。

5.2 浏览器验证

打开 http://127.0.0.1:18789，在聊天框中发送：

你好，用中文回我：你是谁？

收到 AI 回复 = 大功告成。

5.3 安装为后台服务（可选但推荐）

Ctrl+C 停止前台运行，然后执行：

openclaw gateway install --force
openclaw gateway start
openclaw gateway status

六、DeepSeek API 连通性自检

如果怀疑是 API Key 的问题，直接用 curl 测试：

$key="sk-你的key"
curl -X POST "https://api.deepseek.com/v1/chat/completions" `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer $key" `
  -d '{\"model\":\"deepseek-chat\",\"messages\":[{\"role\":\"user\",\"content\":\"1\"}],\"max_tokens\":8}'

七、常见问题速查

写完这篇，以后重装 OpenClaw 就再也不用翻聊天记录了 😄