# API Keys

> API Key 让你的脚本、服务器或机器人通过群历的 API 访问一个团队。个人的 Key 以你的身份工作，机器人的 Key 以机器人的身份工作，权限都和它所属的成员一致。

最后更新：2026-11-06 · 原文：https://qunli.co/docs/api-keys

## 概述

API Key 是一串密钥，程序带着它调用群历的 [REST API](https://qunli.co/docs/developers) 或 [MCP 服务器](https://qunli.co/docs/mcp)，就能以某位成员的身份读写一个团队里的内容。群历有两种 API Key：

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

两种 Key 的规则相同：

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

> **提示**：要让 AI 替团队干活，请为它创建一个机器人，用机器人的 Key 或浏览器授权，而不是把你自己的 Key 交给它。这样它写的评论、做的修改都记在它自己名下，停掉它也不影响你的账号。见[机器人是什么](https://qunli.co/docs/agents)。

## 创建个人 API Key

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

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

![「API Keys」页面：上方是名称输入框和「创建 API Key」按钮，刚创建的 Key 显示在下方并带「复制」按钮，再往下是 Key 列表](https://qunli.co/docs/shots/api-keys-personal-light.webp)

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

## 创建机器人的 API Key

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

![机器人详情弹窗的「机器凭据」部分：名称输入框、「创建 API Key」按钮和已有 Key 的列表](https://qunli.co/docs/shots/manage-agents-credentials-light.webp)

能用浏览器授权的 AI 客户端（Claude Code、Codex 等），不需要 API Key，见[连接 AI 客户端](https://qunli.co/docs/mcp)。授权和 Key 的安全建议见[授权、撤销与安全](https://qunli.co/docs/agent-security)。

## 使用 API Key

把 Key 放在请求头里：

```
Authorization: Bearer <API Key>
```

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

## 撤销 API Key

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

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

## 常见问题

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

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

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

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

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

能读不能写。团队只读期间，所有写入请求都会被拒绝，见[套餐、试用与发票](https://qunli.co/docs/billing)。

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

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