API 详细教程

GLM / 智谱 / Z.AI API Key 获取教程

GLM 现在在 OpenClaw 里走的是 Z.AI provider,不是普通聊天网页入口。你真正需要拿到的是 Z.AI 开放平台里的 API Key。

先记住这三件事

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

官方入口
https://z.ai/manage-apikey/apikey-list
推荐命令
openclaw onboard --auth-choice zai-api-key
最终要拿到的东西

一串能给 Z.AI / GLM 使用的程序调用 Key。 常见环境变量名是 ZAI_API_KEY

按这个顺序做

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

1

先打开 Z.AI 的 API Keys 页面

直接进 API Keys 管理页,最省事。

Z.AI 登录页标注图
https://z.ai/manage-apikey/apikey-list
  • - 如果还没登录,会先进入注册或登录页。
  • - 如果还没进过开放平台,也可以先从 model-api 入口进入。
看到这些就说明顺了: 看到 API Keys 管理页,或者已经看到创建 Key 的入口。
2

在 API Keys 页面找到创建入口

进入管理页后,先确认自己处在能创建新 Key 的位置。

Z.AI API Keys 页面标注图
  • - 页面上方或右侧会有创建按钮。
  • - 如果提示权限或付费要求,先处理完再继续。
看到这些就说明顺了: 你已经找到创建 API Key 的按钮。
3

创建新 Key 并复制保存

点击创建后,系统会生成新的密钥,务必当场复制。

Z.AI Key 创建成功标注图
  • - 创建完成后立刻复制。
  • - 先粘贴到记事本确认完整。
  • - 不要和别的平台 Key 混在一起。
看到这些就说明顺了: 你已经拿到能完整复制的 Z.AI Key。
4

回到 OpenClaw 里走 Z.AI 配置路线

GLM 在 OpenClaw 里对应的 provider 名是 zai。

openclaw onboard --auth-choice zai-api-key
  • - 向导里选择 Z.AI / GLM。
  • - 输入 API Key 时粘贴刚才那一串。
  • - 如果不确定模型名,先按默认推荐项走。
看到这些就说明顺了: 向导没有立刻报 key 错误,就说明这一步已经接上了。
5

做一次最小测试

配好就测,别把问题往后拖。

  • - 先发一条短消息测试。
  • - 确认返回的不是空响应,也不是 provider 配置错误。
看到这些就说明顺了: 能收到正常回复,GLM 这条链路就算跑通。

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

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

用错 provider 名

GLM 在 OpenClaw 里不是单独叫 glm provider,而是走 zai provider。

页面没有创建 Key 的权限

先看是不是没登录开放平台、没开通账号,或者 Billing 状态不满足要求。

Key 粘进去后报错

先确认你拿到的是 API Keys 页面里创建出来的程序调用 Key,不是别的登录凭证。

下一步怎么走

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