Windows 版 OpenClaw 配置避坑指南

检查 JSON 配置花了三周，终于用上 DeepSeek V4 了！

作为一个在 Windows 上跑 OpenClaw 的用户，我最近花了整整三周时间，终于把 API Key 配置搞定了。今天这篇文章，就是要把我的踩坑经历分享出来，让你少走弯路。

一、为什么配置个 API Key 这么难？

OpenClaw 的配置文件是 JSON 格式的，存放在用户目录下。第一次配置还好，但如果想换 API Key，就会发现它可能在多个地方存储了旧的配置。

我第一次尝试：直接修改 JSON 文件中的 apiKey 字段，然后重启应用。结果 OpenClaw 报错说用的是旧 Key。我懵了——文件明明已经改了呀！

于是我开始漫长的排查：三周时间里，我检查了无数次 openclaw.json，检查了 openclaw.json.bak 备份文件，甚至检查了 Windows 注册表和环境变量…

二、正确姿势：用 openclaw onboard

后来我才明白，OpenClaw 官方早就提供了最好的解决方案—— openclaw onboard 命令！这是最稳妥、最推荐的方法。

操作步骤：

第 1 步：打开命令提示符或 PowerShell

按 Win+X，选择”终端”或”Windows PowerShell”

第 2 步：运行 onboard 命令

输入 openclaw onboard 并回车

第 3 步：选择更新模式

你会看到两个选项：
• Update values：更新配置值（推荐）
• Reset：完全重置配置

第 4 步：按指引更新

选择 “Update values”，按提示输入新的 API Key

第 5 步：验证配置

输入 openclaw doctor 检查配置是否正确

三、神奇的 openclaw doctor 命令

openclaw doctor 是 OpenClaw 自带的诊断工具，可以自动检测配置问题并尝试修复。强烈建议在配置完成后运行一下！

openclaw doctor –yes

这个命令会自动：

• 修复字段迁移和废弃的 key

• 修复 Auth OAuth 刷新问题

• 修复配置文件权限问题

• 审计服务配置

四、手动检查 JSON 配置

如果 onboard 命令没能完全解决问题，你可能需要手动检查 JSON 配置文件。

配置文件位置（Windows）：

%USERPROFILE%\.openclaw\openclaw.json

需要检查的关键字段：

注意：修改 JSON 后需要完全关闭并重新启动 OpenClaw 才能生效！

五、DeepSeek V4 有多香？

配置完成后，我终于用上了 DeepSeek V4（flash 版本）！体验下来真的太棒了：

• 响应速度极快：Flash 版本果然名不虚传，几乎秒回结果

• 上下文理解能力强：能准确理解复杂的多轮对话上下文

• 代码能力出色：写代码、调试代码都很在行

• 性价比超高：Flash 版本价格实惠，效果却不打折

• 中文表达流畅：用中文交流完全没有障碍

六、避坑总结

• 优先使用 openclaw onboard 命令来更新配置，避免手动修改 JSON

• 配置完成后运行 openclaw doctor 检查配置是否正确

• 检查 JSON 时注意 apiKey、baseUrl、model 等关键字段

• 修改配置后必须完全重启 OpenClaw 应用

• 备份重要配置文件，修改前先备份一份

希望这篇文章能帮到在 Windows 上配置 OpenClaw 的你！如果遇到问题，欢迎留言交流~