小龙虾🦞OpenClaw 个人实践 · B-17

模型配置系列 · Oauth + API Key · 信息截至 2026 年 4 月

OpenClaw 模型 OAuth 配置完全指南

以 GPT 为例的实践手册 · 基于 v2026.4.23

有读者希望能讲一讲 OpenClaw 里如何配置 GPT 模型？

虽然官方文档说”一行命令就能搞定”,但现实是:版本不对、插件没启用、登录完了模型没切过来。

接下来，今天就讲一讲 OAuth 和 API Key 的本质区别,看看大家踩的坑,是不是因为把两种认证方式混在一起用了。

这篇文章不会告诉你”OAuth 很简单”,而是把当前(2026年4月)哪些模型真的支持 OAuth、怎么配、会遇到什么坑、该不该用,尽量全部说清楚。

一、为什么要用 OAuth?

在聊具体配置前,先搞清楚一个问题:OAuth 解决的是什么问题?

OAuth vs API Key:根本区别

OpenAI 的特殊性

OpenAI 是目前唯一明确支持第三方工具使用订阅 OAuth 的大厂。

对比一下:

• OpenAI
  
  : 工程总监公开表示支持在 OpenClaw、Cursor 等工具中使用 Codex
• Anthropic
  
  : 疯狂封禁第三方工具账号,Claude Max Plan 只能在官方 Claude Code 里用
• Google
  
  : 部分方式(如 Antigravity)曾大规模封号

这就是为什么本文以 GPT 为例——它是目前 OAuth 路径最可靠的选择。

二、当前支持 OAuth 的模型(2026年4月)

1. OpenAI Codex ✅ 推荐

模型标识: openai-codex/gpt-5.4, openai-codex/gpt-5.5

订阅要求: ChatGPT Free/Plus/Pro 均可(额度不同)

免费额度:

• Free: 有限(具体额度未公开)

• Plus ($20/月): 5小时/次 + 周限额

• Pro ($100/月): 5小时最高 10 倍 + 周限额 2 倍

政策状态: ✅ 官方明确支持

2. Qwen (通义千问) ✅ 推荐(免费)

模型标识: qwen-portal/coder-model, qwen-portal/vision-model

订阅要求: 免费,需 qwen.ai 账号

免费额度: 60次/分钟,1000次/天

政策状态: ✅ 官方免费 OAuth

特点:

• 完全免费,无需信用卡

• 支持设备码授权(headless 服务器友好)

• Token 自动刷新

• 适合轻量级个人使用

3. MiniMax ⚠️ 选用

模型标识: minimax-portal/M2.7

订阅要求: MiniMax 订阅

政策状态: ⚠️ 官方支持,但文档不完善

4. Anthropic Claude CLI ❌ 不推荐

模型标识: anthropic/claude-* (通过 Claude CLI)

订阅要求: Claude Pro/Team 订阅

政策状态: ❌ 高风险

为什么不推荐:

• Anthropic 曾明确限制在非 Claude Code 场景使用订阅凭证

• 大量用户报告账号被封

• 即使能用,也可能随时被停止服务

5. Google Gemini ❌ 高风险

可用方式: Gemini CLI、Antigravity (第三方反向代理)

政策状态: ❌ 高风险

历史问题:

• 曾有用户因使用 Antigravity 被 Google 大规模封号

• 需要写”声泪俱下的申诉邮件”才能解封

建议: 非关键账号可尝试,生产环境绝对避免

三、GPT OAuth 配置实战:从零到能用

前提条件检查

# 1. 确认 OpenClaw 版本(需 >= 2026.3.8) openclaw --version  # 2. 检查当前模型状态 openclaw models status  # 3. 检查可用提供商 openclaw models list

如果版本过旧,先升级:

npm update -g openclaw

Step 1: OAuth 登录

openclaw models auth login --provider openai-codex

执行后会发生什么:

• 终端输出一个 URL (类似 https://codex.openai.com/authorize?client_id=...)

• 自动打开浏览器(或手动复制 URL 打开)

• 用 ChatGPT 账号登录并授权

• 浏览器跳转到回调地址

• 终端显示 “Authorization successful”

Step 2: 切换模型(关键!)

登录成功 ≠ 模型已切换。必须手动执行:

openclaw models set openai-codex/gpt-5.4

验证切换是否成功:

openclaw models status

输出应包含:

Primary model: openai-codex/gpt-5.4 Auth provider: openai-codex (OAuth) Auth status: ✅ Valid

Step 3: 重启 Gateway

openclaw gateway restart

Step 4: 验证配置

openclaw agent --agent main --message "你好,测试 GPT-5.4"

如果输出正常响应,配置成功。

如果报错 Unknown model: openai-codex/gpt-5.4,说明:

• 版本太旧,不支持 GPT-5.4

• 或者没有重启 Gateway

四、Qwen OAuth 配置:免费方案

如果你不想花钱,Qwen 是最佳选择。

Step 1: 启用插件

openclaw plugins enable qwen-portal-auth

Step 2: 重启 Gateway

openclaw gateway restart

Step 3: OAuth 登录

openclaw models auth login --provider qwen-portal --set-default

设备码授权流程:

• 终端显示一个 6 位授权码(如 AB-CDEF)

• 浏览器打开 https://chat.qwen.ai/authorize?user_code=AB-CDEF

• 用 qwen.ai 账号登录并输入授权码

• 返回终端,显示 “Authorization successful”

五、版本差异说明

升级命令:

npm update -g openclaw

六、常见问题排查

1. 登录成功但模型调用失败

症状: openclaw agent --message "test" 返回 Model not found

检查清单:

# 1. 确认模型已设置 openclaw models status  # 2. 确认 Gateway 已重启 openclaw gateway restart  # 3. 确认模型名称正确 openclaw models list | grep openai-codex

2. Plus 额度很快用完

原因: 2026年4月 Plus 套餐调整后,额度分配策略变化

症状:

• 之前 5 小时额度用不完

• 现在开几个窗口 1 小时就用完了

解决方案:

• 减少并发会话

• 配置备用模型(如 Qwen 免费版)

• 升级 Pro 套餐($100/月)

七、生产环境建议

OAuth vs API Key:何时用哪个?

八、总结

核心要点

1. OAuth 不是万能的

• OpenAI Codex: ✅ 可靠,官方支持

• Qwen: ✅ 免费,适合轻量使用

• Anthropic: ❌ 高风险,生产环境避免

• Google: ❌ 高风险,避免使用

2. 配置三步走

• openclaw models auth login --provider openai-codex

• openclaw models set openai-codex/gpt-5.4
  
   (关键!)

• openclaw gateway restart

3. 生产环境优先 API Key

• OAuth 适合个人复用订阅

• API Key 适合企业生产环境

4. 配置备用模型

• 单一模型不可靠

• 至少配置 2 个备用模型

     💬 你使用的Oauth模式还是API Key呢？     有没有遇到配置了但不能用的问题？评论区说说。