API Keys

概述

API Key 是一串密钥，程序带着它调用群历的 REST API 或 MCP 服务器，就能以某位成员的身份读写一个团队里的内容。群历有两种 API Key：

	个人 API Key	机器人的 API Key
以谁的身份工作	你本人	这个机器人
在哪里创建	「个人设置」的「API Keys」	机器人详情的「机器凭据」
谁能创建和撤销	你自己	机器人的负责人，或团队的所有者、管理员
适合	你自己的脚本、数据同步、CI	AI 客户端、没有浏览器的服务器

两种 Key 的规则相同：

• 权限和成员本人一致。Key 没有单独的权限范围：你看不到的项目，你的 Key 也访问不到；你能改的，它也能改。
• 只对一个团队有效。Key 在哪个团队创建，就只能访问哪个团队。你在多个团队里，每个团队要分别创建。
• 不会过期，直到被撤销。撤销立即生效。
• 只显示一次。创建时显示完整的 Key，之后列表里只显示开头 8 位。
• 成员离开团队后，他的 Key 不再能访问这个团队；机器人被暂停时，它的 Key 暂时失效，恢复后继续可用。团队被删除后，团队里所有的 Key 立即失效。
• 机器人不能给自己创建 Key，只能由它的负责人或团队的真人所有者、管理员在机器人详情里创建。机器人可以用 API 查看和撤销自己的 Key。

创建个人 API Key

1. 点击侧边栏左下角你的名字，选择「个人设置」，在左侧点击「API Keys」。
2. 在「名称」里写上用途，比如「CI/CD」或「数据同步」，方便以后认出它。
3. 点击「创建 API Key」。
4. 页面上出现「请立即复制并保存该 API Key」，点击「复制」，把它存进你的密钥管理工具或环境变量。

离开这个页面后，完整的 Key 就再也看不到了。

列表里能看到每个 Key 的名称、前缀、创建时间、「最后使用」时间和状态（「可用」或「已撤销」）。「最后使用」大约每 5 分钟更新一次。每个人只能看到自己的 Key，管理员也看不到别人的个人 Key。

创建机器人的 API Key

1. 打开机器人详情：在「个人设置」的「我的机器人」里点击这个机器人；所有者和管理员也可以在「成员管理」里点击机器人的角色按钮，选择「查看、编辑与管理凭据」。
2. 在「机器凭据」里输入名称，比如「OpenClaw 生产环境」，点击「创建 API Key」。
3. 出现「请立即复制。Token 只显示这一次。」时，点击「复制」保存。

能用浏览器授权的 AI 客户端（Claude Code、Codex 等），不需要 API Key，见连接 AI 客户端。授权和 Key 的安全建议见授权、撤销与安全。

使用 API Key

把 Key 放在请求头里：

Authorization: Bearer <API Key>

也可以用 X-Api-Key: <API Key>。REST API 的地址是 https://qunli.co/api/v1，接口说明见开发者文档；MCP 服务器是 https://qunli.co/mcp，用法见连接 AI 客户端。

撤销 API Key

在 Key 所在的列表里，点击那一行的「撤销」。会先弹出「撤销这个 API Key？」，点击「撤销 API Key」确认。撤销立即生效，用这个 Key 的程序下一次请求就会被拒绝。撤销后的 Key 留在列表里，状态是「已撤销」，不能恢复。

Key 不再使用、交给过不该给的人，或者可能出现在了代码仓库、聊天记录里，都请马上撤销，再创建一个新的。

常见问题

创建时忘了复制，还能再看吗？

不能，群历只保存 Key 的摘要，没有人能再看到原文。撤销这个 Key，重新创建一个。

能创建只读的 Key，或者只能访问某个项目的 Key 吗？

不能，Key 的权限总是和它所属的成员一致。需要限制范围时，创建一个机器人，只把它加进需要的项目，再给它创建 Key。

团队过期后 API Key 还能用吗？

能读不能写。团队只读期间，所有写入请求都会被拒绝，见套餐、试用与发票。

怎样停掉某位成员所有的 Key？

把他移出团队，他的 Key 就不再能访问这个团队。个人 Key 只有本人能撤销，管理员无法单独撤销别人的个人 Key。机器人的 Key，负责人和所有者、管理员都可以撤销。