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。

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

⚠️ 很多人只跑 npm uninstall -g，但 .openclaw 文件夹还在，旧配置原地复活。我们要斩草除根。

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 按以下选项选择

步骤	操作	备注
Where will the Gateway run?	Local (this machine)	回车确认
What do you want to configure?	Model	选择它后回车
Provider	OpenAI-compatible	不要选 custom 或 Ollama
API Base URL	https://api.deepseek.com	不加 /v1，更稳定
API Key	你的 sk- 真实 key	不带空格
Model ID	deepseek-chat	日常主力模型
Gateway bind	loopback / 127.0.0.1	默认即可
Tools profile	minimal	少工具 = 少出怪错

如果 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}'

返回	含义
有 "choices"	✅ Key 有效，网络通
401	Key 抄错或少了字符
402	余额不足
超时 / ENOTFOUND	代理 / VPN / 防火墙拦截

七、常见问题速查

问题	现象	解法
以为 stop 就干净了	旧配置复活	删 .openclaw 目录重来
onboard 选了 custom	请求一直 timeout	手写 JSON 切换到 openai-compatible
用了 –foreground	报 unrecognized option	新版改用 openclaw gateway run
浏览器空白	端口没在监听	netstat -ano | findstr 18789 查谁在占用

---

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