API 详细教程

通义千问 / Qwen API Key 获取教程

这条路线适合以后想继续走阿里云生态的用户。对零基础来说,最容易卡住的不是命令,而是没有先进入百炼的密钥管理页,或者拿到的不是程序调用用的 API Key。

先记住这三件事

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

官方入口
https://bailian.console.aliyun.com/?tab=model#/api-key
推荐命令
openclaw onboard --auth-choice qwen-api-key-cn
最终要拿到的东西

一串能给 Qwen / 通义千问 使用的程序调用 Key。 常见环境变量名是 QWEN_API_KEY 或 DASHSCOPE_API_KEY

按这个顺序做

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

1

先打开阿里云百炼的密钥管理页

直接进密钥管理页,少绕后台菜单。

阿里云登录页标注图
https://bailian.console.aliyun.com/?tab=model#/api-key
  • - 如果还没登录,会先跳到阿里云登录页。
  • - 如果提示先开通百炼服务,先把服务状态处理好再继续。
看到这些就说明顺了: 看到 API Key 或密钥管理页面,就说明入口走对了。
2

如果还没开通百炼,先完成开通

很多人明明有阿里云账号,但没进过百炼,所以一进来就找不到创建 Key 的入口。

百炼 API Key 页面标注图
  • - 看到开通协议就先确认。
  • - 如果提示需要实名认证,先完成实名认证再回来。
  • - 开通完成后重新回到 API Key 页面。
看到这些就说明顺了: 再次进入密钥管理页后,页面不再拦你开通服务。
先注意: 如果页面还在提示未开通或未实名,先别继续点,先把账号状态处理完。
3

创建新的 API Key

进入密钥管理后,找到创建 API Key 的按钮直接创建。

百炼创建 API Key 标注图
  • - 先点“创建 API Key”。
  • - 创建完成后立刻复制。
  • - 先粘贴到记事本确认完整。
看到这些就说明顺了: 你已经拿到了一串完整的 Qwen API Key。
4

把 Key 保存好,不要外传

很多平台只展示一次完整 Key,必须当场保存。

百炼复制 API Key 标注图
  • - 先保存在本地记事本里。
  • - 确认没有漏字符。
  • - 不要发群里,也不要截图外传。
看到这些就说明顺了: 现在你手里已经有能给 OpenClaw 使用的 Qwen Key。
5

回到 OpenClaw 完成配置

拿到 Key 后立刻回 PowerShell 继续,不要把浏览器页面放着不管。

openclaw onboard --auth-choice qwen-api-key-cn
  • - 向导里选择 Qwen / 通义千问。
  • - 提示输入 Key 时粘贴刚复制的内容。
  • - 如果你走的是中国区线路,这条命令更稳。
看到这些就说明顺了: 向导继续往后走且没有立刻报 invalid api key,就说明格式基本正确。
6

配好以后立刻做一次最小测试

不要等全部配完再排错,Key 一接上就先发一句最短消息。

  • - 启动或继续 OpenClaw 会话。
  • - 发送一句最短测试消息,比如“你好”。
  • - 确认模型真的有返回结果。
看到这些就说明顺了: 能正常收到回复,就说明这条 API 链路已经跑通了。

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

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

找不到创建按钮

大概率是百炼服务还没开通,或者账号还没实名认证。先把账号状态补齐,再回密钥管理页。

invalid api key

优先检查复制时有没有漏字符、前后空格,或者是不是把别的平台 Key 粘进来了。

明明有 Key 还是不通

检查 OpenClaw 里选的是不是 Qwen provider,provider 和 Key 对不上也会直接失败。

下一步怎么走

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