API 详细教程

OpenAI API Key 获取教程

OpenAI 这条路线最容易搞混的一点是:能登录 ChatGPT,不等于 API 已经能用。你需要单独进入 OpenAI Platform 的 API Keys 页面创建开发者 Key。

先记住这三件事

先把入口、命令和最终要拿到的 Key 对齐。

官方入口
https://platform.openai.com/api-keys
推荐命令
openclaw onboard --auth-choice openai-api-key
最终要拿到的东西

一串能给 OpenAI 使用的程序调用 Key。 常见环境变量名是 OPENAI_API_KEY

按这个顺序做

先拿到正确的 Key,再回到 OpenClaw 继续接入。

1

直接打开 OpenAI API Keys 页面

这一步最省事,直接进真正创建 Key 的地方。

OpenAI Platform 登录页标注图
https://platform.openai.com/api-keys
  • - 如果还没登录,会先进入 OpenAI 登录页。
  • - 登录后应该进入 Platform,而不是普通 ChatGPT 页面。
看到这些就说明顺了: 页面已经显示 API Keys 相关内容。
2

确认自己有创建 Key 的权限

如果页面提示组织、账单或权限问题,先把这些处理完。

OpenAI API Keys 管理页标注图
  • - 如果创建按钮是灰的,先去看 Billing 或组织权限。
  • - 不要跳过错误提示,先处理完再创建 Key。
看到这些就说明顺了: 你已经具备创建 Key 的权限,并找到创建按钮。
3

创建新的 API Key

点击创建按钮后,系统会生成一串新的 Key。

OpenAI Key 创建成功标注图
  • - 创建后立刻复制保存。
  • - 先粘贴到记事本确认完整。
  • - 不要把 ChatGPT 的登录信息和 API Key 混在一起。
看到这些就说明顺了: 你已经拿到完整的 OpenAI API Key。
4

回到 OpenClaw 里配置 OpenAI

拿到 Key 后就回终端继续。

openclaw onboard --auth-choice openai-api-key
  • - 向导里选择 OpenAI。
  • - 输入 Key 时原样粘贴。
  • - 模型选项先按默认推荐走,先把链路跑通。
看到这些就说明顺了: 向导没有直接报错,就说明 Key 和 provider 已经接上了。
5

做一次最小对话测试

API 配置完成后立刻验证一次。

  • - 发一条最短测试消息。
  • - 确认返回的是模型结果,而不是权限或账单错误。
看到这些就说明顺了: 能正常回复,就说明 OpenAI 这条路线已经跑通。

如果这里卡住,优先查这些高频问题

先排高频错误,别一上来就怀疑系统坏了。

ChatGPT 能用,但 API 不能用

这是两回事。你需要的是 Platform API Key,不是单纯能登录 ChatGPT。

创建按钮是灰的或提示权限错误

优先检查 Billing、组织权限,以及你当前是否真的在 platform.openai.com。

复制后立刻报 invalid api key

先检查有没有漏字符、前后空格,或者是不是把别的服务 Key 粘进来了。

下一步怎么走

Key 拿到以后,不要停,继续把安装和验证走完。