API密钥无效需从四方面排查：一查密钥格式是否含不可见字符，二验密钥前缀与provider是否匹配（如sk-对应OpenAI），三确认密钥在平台处于Active状态且额度充足，四检查环境变量是否覆盖配置文件中的密钥设置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在使用 OpenClaw 时遇到“API Key 无效”提示，程序无法连接模型服务，说明鉴权环节已失败——这通常不是网络或代码问题，而是密钥本身、格式、环境或匹配关系出了偏差。
检查本地配置中的 API Key 是否含不可见字符
第一步：运行 openclaw config show 查看当前加载的密钥值。
第二步：观察输出中 api_key: 后的内容——如果两侧有空格、换行、制表符（比如显示为 " sk-xxx "），则密钥已被污染。这类字符肉眼难辨，但会导致后端校验直接拒绝。
第三步：执行 openclaw config edit，定位到 api_key: 行，【手动删除冒号后第一个非空格字符前的所有空白，以及该字符后所有尾部空白】，确保形如 api_key: sk-xxx（冒号后仅一个空格，无引号，无换行）。
确认 API Key 所属平台与当前配置的 provider 是否一致
OpenClaw 要求密钥类型和 provider 配置严格对应，否则即使密钥真实有效也会报 401。
方法一：查看当前 provider 设置
运行 openclaw config show | grep provider，获取当前值（如 openai、anthropic、openrouter）。
方法二：核对密钥前缀
- OpenAI 密钥必须以 sk- 开头；
- Anthropic 密钥必须以 sk-ant-api03- 开头；
- OpenRouter 密钥必须以 sk-or-v1- 开头。
若发现不匹配（例如 provider 是 openai 但密钥是 sk-or-v1-），立即运行 openclaw config set provider openrouter 并重新输入密钥。
验证密钥是否仍处于 Active 状态且未耗尽额度
访问对应平台的 API 密钥管理页：
- OpenAI：https://platform.openai.com/api-keys
- Anthropic：https://console.anthropic.com/settings/keys
- OpenRouter：https://openrouter.ai/keys
找到你正在使用的密钥条目，确认其状态为 Active，且 Expiration 时间晚于当前日期（2026年7月28日）。
若显示 Revoked 或已过期，点击 Regenerate 获取新密钥，并立刻替换本地配置中的旧值——旧密钥一旦重生成即永久失效，无法恢复。
同时检查账户余额或用量仪表盘，若提示 insufficient_quota 或 balance exhausted，需充值或申请配额提升。
排查环境变量是否意外覆盖了配置文件
如果系统中设置了 OPENCLAW_API_KEY 或通用型变量如 API_KEY，OpenClaw 会优先读取它们，而忽略 config.yaml 中的设置。
在终端中运行 echo $OPENCLAW_API_KEY（macOS/Linux）或 echo %OPENCLAW_API_KEY%（Windows），查看是否有输出。
若有输出，且内容与你期望的密钥不一致，说明环境变量正在干扰。临时清空它：
- macOS/Linux：执行 unset OPENCLAW_API_KEY；
- Windows：执行 set OPENCLAW_API_KEY=（注意等号后无空格）。
然后重启 OpenClaw 进程，让配置文件重新生效。
