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

新手优先回安装教程走 openclaw onboard --install-daemon;这条命令适合已经熟悉 OpenClaw、想直接指定 provider 的用户。

最终要拿到的东西

一串能给 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

新手优先回安装教程走完整 onboarding;熟悉命令行的用户也可以直接指定 OpenAI provider。

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 拿到以后,不要停,继续把安装和验证走完。

下一步

拿到 Key 了,回去把 OpenClaw 装通

Key 拿好之后,如果还没装 OpenClaw,先去安装教程把基础环境跑通。已经装好就直接 onboarding 接进去。