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

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

最终要拿到的东西

一串能给 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 配置路线

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

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

下一步

拿到 Key 了,回去把 OpenClaw 装通

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