管理、重新生成和撤销 API 令牌
查找你的 API 令牌、重新生成密钥（仅限一次，可选择 24 小时重叠期）、撤销令牌、了解过期时间和 IP 白名单，并查看令牌停止工作的原因。
令牌选项卡列出了你的 API 令牌及其访问权限、限制和最后使用时间。你可以在此重新生成令牌的密钥、撤销令牌，并查看令牌停止工作的原因。
如何找到你的令牌
打开工作区菜单并选择 AI agents & API。令牌选项卡是第一个选项卡；每个选项卡都会显示其数量。
谁可以看到哪些令牌：
| 你的角色 | 你可以看到 | 你可以执行 |
|---|---|---|
| 所有者或管理员 | “此工作区中的每个令牌。成员只能看到他们自己的。” 使用所有者菜单按人员筛选（所有人显示全部）。 | 撤销任何令牌。仅能重新生成你自己的令牌。 |
| 编辑者或内容创作者 | “你的令牌。使用这些令牌的代理将以你的身份执行操作。” | 撤销并重新生成你自己的令牌。 |
每一行显示名称（带有密钥的最后几个字符，如 clv_agent_…k7Qe）、所有者、访问权限（其权限）、它涵盖的站点、已创建、最后使用和过期时间。页脚会根据工作区的限制统计活跃令牌的数量。行上的徽章：
| 徽章 | 含义 |
|---|---|
| 消耗积分 | 该令牌具有 credits:spend。指向它可查看其上限：每个任务、每天、每月（为空时表示“无上限”）以及“低于 n 积分自动批准”或“由专人批准每次付费启动”。 |
| IP 受限 | 该令牌具有 IP 白名单，且仅能从这些地址使用。 |
| 超出角色权限 | “所有者的角色已更改。拒绝执行需要被划掉的权限的调用。” |
| 已撤销 / 已过期 | 该令牌不再有效。原因显示在旁边（请参阅 令牌停止工作的原因）。 |
已撤销和已过期的令牌默认处于隐藏状态。点击显示已撤销和已过期的令牌 (count) 以列出它们；它们会保留在列表中 30 天。
更改令牌的访问权限
令牌的权限、站点、过期时间、积分消耗上限和 IP 白名单在创建后无法编辑。若要更改其中任何一项，请使用新设置创建一个新令牌，切换你的代理，然后撤销旧令牌。
重新生成令牌的密钥
当密钥可能已泄露或需要按计划轮换时，请重新生成密钥。新密钥具有相同的名称、访问权限、站点、IP 白名单、积分消耗上限和过期日期。
打开令牌菜单
在令牌选项卡上，打开令牌行上的 ⋯ 菜单并选择重新生成密钥。
选择旧密钥何时停止使用
对话框会询问“重新生成“name”？”：“你将获得一个具有相同访问权限的新密钥。旧密钥将停止工作。”如果代理仍在使用它且你需要时间进行切换，请勾选保持旧密钥有效 24 小时。如果不勾选，旧密钥将立即停止使用。
复制新密钥
点击重新生成。令牌已创建对话框会显示一次新密钥。复制它，更新你的代理或密钥存储，然后点击我已保存。
重新生成规则：
- 只有创建令牌的人才能重新生成它。 未创建该令牌的所有者或管理员会看到“只有创建此令牌的人才能重新生成它。你可以撤销它。”
- 密钥只能重新生成一次。 此后，旧行显示“已被重新生成的密钥替换”且没有重新生成密钥选项；请改为重新生成新令牌。在旧密钥上再次尝试会返回“此令牌已被重新生成、撤销或已过期；请使用其替代令牌或创建一个新令牌。”
- 过期日期不会改变。 为 90 天创建的令牌仍会在其原始日期过期。如果旧密钥的 24 小时重叠期超过了该日期，它将在过期日期停止。
- 即使工作区达到活跃令牌限制，你也可以重新生成。在 24 小时重叠期间，两个密钥均有效，且都计入活跃令牌数量。
- 重新生成需要工作区处于 Pro 或更高版本；否则重新生成密钥将打开升级对话框。
撤销令牌
- 打开令牌行上的 ⋯ 菜单并选择撤销。
- 使用撤销令牌确认：“使用此令牌的代理将立即失去访问权限。此操作无法撤销。”
撤销令牌会立即释放其在工作区活跃令牌限制中的名额。
过期时间
每个令牌都会过期。你在创建时选择其有效期：7 天、30 天、90 天（默认）或 1 年。没有“永不过期”选项，因此被遗忘的令牌无法永久有效。过期时间列显示该日期。
过期日期过后，每个调用都会返回“此令牌已过期。请在 Integrations → AI agents & API 中创建一个新令牌。”已过期的令牌无法续期或重新生成；请创建一个新令牌。
IP 白名单
令牌可以限制为仅限你的代理运行所在的地址（例如 CI 运行器或服务器）。你可以在向导的限制步骤下的高级 → IP 白名单中进行设置：“可选。每行一个地址或范围；来自其他任何地方的调用都将被拒绝。”
- 输入 IPv4 或 IPv6 地址 (
203.0.113.7) 或 CIDR 格式的范围 (198.51.100.0/24)，最多 20 个条目。 - 留空以允许任何地址。审核步骤随后会显示任何地址。
- 来自其他地址的调用将返回“此令牌不能从该 IP 地址使用。”
- 非地址或范围的条目将被拒绝：“value 不是 IP 地址或范围。”
令牌停止工作的原因
| 令牌上显示的内容 | 发生了什么 | 怎么做 |
|---|---|---|
| 已过期 | 其有效期已过。 | 创建一个新令牌。 |
| “由其所有者撤销” | 创建它的人撤销了它。 | 如果仍需要，请创建一个新令牌。 |
| “由管理员撤销” | 工作区所有者或管理员撤销了它。 | 在创建新令牌之前询问他们原因。 |
| “已撤销：所有者离开了工作区” | 创建它的人已从工作区中移除。他们所有的令牌都被撤销。 | 工作区中的其他人创建一个新令牌。 |
| “已撤销：所有者账户已被删除” | 所有者删除了他们的 Clevera 账户。 | 创建一个新令牌。 |
| “已被重新生成的密钥替换” | 密钥已被重新生成。 | 使用新密钥。 |
| “已撤销：在公共存储库中发现” | 令牌在公共 GitHub 存储库中被发现并被自动撤销。 | 从存储库历史记录中删除它，然后创建一个新令牌并将其保存在密钥存储中。 |
| “已撤销：异常活动” | 它在几分钟内进行了多次被拒绝的请求（10 分钟内超过 50 次）。 | 检查活动以了解它尝试了什么，修复代理，然后创建一个新令牌。 |
| “已撤销：检测到令牌重用” / “已撤销：应用已断开连接” | 这些适用于已连接的应用，不适用于 API 令牌。 | 重新连接应用。 |
| 每个调用返回“代理 API 不在此工作区的计划中。它适用于 Pro 及以上版本。” | 工作区不再处于 Pro、Business 或 Custom 计划。 | 升级到 Pro。请参阅 如果工作区离开 Pro。 |
异常活动
Clevera 会监控每个令牌的突发活动，并通过“token 出现异常活动”通知告知工作区所有者：
- 多次被拒绝的请求：在几分钟内发生，令牌被撤销。“它在几分钟内进行了多次被拒绝的请求。”
- 异常高频的更改：在几分钟内发生（10 分钟内超过 200 次写入或 20 次页面删除）：其写入操作暂停 10 分钟。调用返回“在异常的更改突发后，来自此令牌的写入已暂停。工作区所有者已收到通知。”读取操作仍可正常工作。
- 积分消耗异常快：令牌在 24 小时内无法启动付费工作。“它在几分钟内消耗了异常多的积分，因此暂时无法启动付费工作。”
如果工作区离开 Pro
AI agents & API 包含在 Pro、Business 和 Custom 计划中。如果工作区转为 Starter 或 Free，页面会显示“AI agents & API 包含在 Pro 中”：“升级以让 Claude、ChatGPT 和你的脚本在此工作区中工作。现有的令牌和应用在此之前将停止工作；你仍可以在此撤销它们。”
- 令牌保持列出状态且可以撤销，但每个调用都会被
plan_locked拒绝。 - 重新生成密钥将改为打开升级对话框。
- 升级回 Pro 后，令牌将恢复工作。没有任何内容被删除；令牌仍会在其日期过期。