为 AI 智能体创建 API 令牌
通过四步向导(用途、权限、限制、查看)创建 API 令牌:预设、权限、过期时间、文档站点、消耗上限和 IP 白名单。令牌仅显示一次。
API 令牌允许 Claude Code、Codex、Cursor 或你自己的脚本以你的身份在工作区中工作,且仅拥有你选择的访问权限。你可以在四步向导(用途、权限、限制、查看)中创建它,Clevera 只会显示该令牌一次。
开始之前
- “AI 智能体与 API”功能适用于 Pro、Business 和 Custom 计划。在其他计划中,新令牌会显示“API 和智能体访问权限适用于 Pro 及以上版本。”
- 任何工作区成员都可以为自己创建令牌。令牌只能获得你角色所允许的权限。请参阅 智能体权限。
- 一个工作区最多可拥有 50 个活跃令牌。达到上限时,新令牌将被禁用,并显示:“你的工作区已达到 50 个活跃令牌的上限。请先撤销一个。”
- 每个智能体或脚本请使用一个令牌,这样你就能查看每个令牌的操作记录,并在不影响其他令牌的情况下撤销其中一个。
创建令牌
打开“令牌”选项卡
打开工作区菜单并选择 AI 智能体与 API。在 令牌 选项卡上,点击 新令牌。
用途:命名并选择其用途
为其输入一个你在令牌列表和活动日志中能识别出的 名称(最多 100 个字符),例如“文档撰写者 (Claude Code)”。在 它的用途是什么? 下,选择一个预设。它会自动勾选该工作所需的权限;你可以在下一步中进行微调。

选择最接近智能体工作的预设。 预设 用途 撰写者 “智能体起草;由专人审核并发布。”文档站点草稿。 发布者 “受信任的自动化程序,可能会更改读者看到的内容。”文档站点,包括发布功能。 支持助手 “来自已发布文档的回答。仅此而已。”帮助机器人。 只读 “研究、审计和翻译检查。” 分析师 “读取内容和读者信号以建议修复。” 制作人 “起草内容并在消耗积分上限内启动付费工作。”请求视频、剪辑和文章。 工作区智能体 “智能体在此工作区内可执行的所有操作,在消耗积分上限内。” 灰色的预设包含你的角色无法授予的权限:“你的角色无法授予此预设中的所有能力。”
权限:检查每项权限
此步骤列出了所有权限,按 文档、视频 和 工作区 分组,每项权限都说明了其允许的操作,并带有徽章(已读、编辑、发布、管理 或 消耗积分)。你可以勾选或取消勾选。一旦你更改了预设的设置,标题会显示 已自定义,点击 重置为 预设 可撤销你的更改。

每项权限都说明了它允许的操作类型。 每项权限允许的操作:智能体权限。
限制:设置过期时间、站点、消耗和地址

仅当令牌可能消耗积分时才会显示消耗。 请参阅下方的 限制选项。
查看并创建
查看页面会用通俗的语言说明令牌的功能(可读取、可创建和编辑、可发布、可管理站点、可消耗积分)及其限制。“它将以你的身份行事,且在你的角色允许范围内。”点击 创建令牌。

检查摘要,然后点击创建令牌。 复制令牌
令牌已创建 会显示该令牌,以
clv_agent_开头:“立即复制:你将无法再次看到它。”将其复制到密钥存储库或环境变量中。其下方的 连接智能体 提供了适用于 Claude Code、Codex CLI、.mcp.json、curl和 Claude.ai、ChatGPT 的现成设置。完成后点击 我已保存。
令牌仅显示一次。
返回 会保留你输入的所有内容。在更改某些内容后关闭向导会询问“放弃此令牌?”:“你开始的设置将丢失。不会创建任何令牌。”
限制选项
| 选项 | 功能 | 默认 |
|---|---|---|
| 过期时间 | 7 天、30 天、90 天或 1 年。日期显示在下方(“在 日期”)。令牌总是会过期。 | 90 天 |
| 文档站点 | 当令牌具有文档站点权限时显示。全部站点(“此工作区中的每个文档站点,包括新站点。”)或 已选站点。 | 当工作区有多个文档站点时为 已选站点,否则为 全部站点 |
| 消耗 → 按作业 | 单次启动可能被引用的最大积分数。为空:无上限。 | 无上限 |
| 消耗 → 按天 / 按月 | 令牌在日历日或月内可消耗(并为运行中的作业保留)的最大积分数。 | 无上限 |
| 消耗 → 自动批准 | 低于此积分数的作业启动无需人工干预。“0 表示人工批准每次付费启动。你的计划最多允许 500。”(Custom 计划为 1,000。) | 0 |
| 高级 → IP 白名单 | “可选。每行一个地址或范围;来自其他任何地方的调用将被拒绝。”最多 20 个 IPv4/IPv6 地址或 CIDR 范围,例如 203.0.113.7 或 198.51.100.0/24。 |
为空:任何地址 |
消耗 仅在令牌具有 credits:spend(制作人 和 工作区智能体 预设)时出现。上限和批准如何协同工作:控制智能体消耗和批准。
接下来会发生什么
- 令牌可通过 MCP (
https://app.clevera.ai/mcp) 和 REST API 立即使用。 - 工作区所有者和管理员会收到通知:“已为 工作区 创建了一个新的 API 令牌 名称”,其中包含设置者及其访问权限。
- 令牌会显示在 令牌 选项卡上,并带有其最后四个字符(如
clv_agent_…k7Qe),每次使用都会更新 最后使用时间。 - 创建后,其权限和限制无法更改。要更改它们,请创建一个新令牌并撤销旧令牌。请参阅 管理 API 令牌。
故障排除
| 消息 | 原因 | 解决方法 |
|---|---|---|
| “请为令牌命名。” | 名称为空。 | 输入名称。 |
| “请至少选择一项能力。” | 未勾选任何权限。 | 至少勾选一项。 |
| “请至少选择一个站点。” | 已选站点 但未选中任何站点。 | 选择一个站点,或选择 全部站点。 |
| “请输入整数积分。” | 消耗字段包含小数或文本,或上限为 0。 | 输入整数,或将上限留空。 |
| “你的计划最多自动批准低于 500 积分的智能体工作。” | 自动批准 超过了你计划的最大值。 | 降低该值。 |
| “值 不是 IP 地址或范围。” | IP 白名单行无效。 | 修复或删除该行。 |
| “你的角色无法授予其中一些能力。” | 权限超出了你的角色范围。 | 取消勾选,或请所有者或管理员创建令牌。 |
| “你的工作区已达到 50 个活跃令牌的上限。请先撤销一个。” | 达到 50 个活跃令牌。 | 撤销一个不用的令牌。 |
| “你的计划不支持 API 和智能体访问。” | 工作区不在 Pro、Business 或 Custom 计划中。 | 升级到 Pro。 |
| “无法创建令牌。请重试。” | 出现错误。 | 重试;如果问题持续,请联系支持团队。 |