跳转到内容
Clevera 帮助中心

为 AI 智能体创建 API 令牌

通过四步向导(用途、权限、限制、查看)创建 API 令牌:预设、权限、过期时间、文档站点、消耗上限和 IP 白名单。令牌仅显示一次。

更新于 阅读需 3 分钟

API 令牌允许 Claude Code、Codex、Cursor 或你自己的脚本以你的身份在工作区中工作,且仅拥有你选择的访问权限。你可以在四步向导(用途、权限、限制、查看)中创建它,Clevera 只会显示该令牌一次。

开始之前

  • “AI 智能体与 API”功能适用于 Pro、Business 和 Custom 计划。在其他计划中,新令牌会显示“API 和智能体访问权限适用于 Pro 及以上版本。”
  • 任何工作区成员都可以为自己创建令牌。令牌只能获得你角色所允许的权限。请参阅 智能体权限。
  • 一个工作区最多可拥有 50 个活跃令牌。达到上限时,新令牌将被禁用,并显示:“你的工作区已达到 50 个活跃令牌的上限。请先撤销一个。”
  • 每个智能体或脚本请使用一个令牌,这样你就能查看每个令牌的操作记录,并在不影响其他令牌的情况下撤销其中一个。

创建令牌

  1. 打开“令牌”选项卡

    打开工作区菜单并选择 AI 智能体与 API。在 令牌 选项卡上,点击 新令牌。

  2. 用途:命名并选择其用途

    为其输入一个你在令牌列表和活动日志中能识别出的 名称(最多 100 个字符),例如“文档撰写者 (Claude Code)”。在 它的用途是什么? 下,选择一个预设。它会自动勾选该工作所需的权限;你可以在下一步中进行微调。

    新 API 令牌向导第 1 步:名称以及撰写者、发布者和支持助手等用途预设的选择。
    选择最接近智能体工作的预设。
    预设 用途
    撰写者 “智能体起草;由专人审核并发布。”文档站点草稿。
    发布者 “受信任的自动化程序,可能会更改读者看到的内容。”文档站点,包括发布功能。
    支持助手 “来自已发布文档的回答。仅此而已。”帮助机器人。
    只读 “研究、审计和翻译检查。”
    分析师 “读取内容和读者信号以建议修复。”
    制作人 “起草内容并在消耗积分上限内启动付费工作。”请求视频、剪辑和文章。
    工作区智能体 “智能体在此工作区内可执行的所有操作,在消耗积分上限内。”

    灰色的预设包含你的角色无法授予的权限:“你的角色无法授予此预设中的所有能力。”

  3. 权限:检查每项权限

    此步骤列出了所有权限,按 文档、视频 和 工作区 分组,每项权限都说明了其允许的操作,并带有徽章(已读、编辑、发布、管理 或 消耗积分)。你可以勾选或取消勾选。一旦你更改了预设的设置,标题会显示 已自定义,点击 重置为 预设 可撤销你的更改。

    第 2 步,权限:已勾选撰写者预设的权限,按工具集分组,每项都有简短说明和已读、编辑、发布或管理徽章。
    每项权限都说明了它允许的操作类型。

    每项权限允许的操作:智能体权限。

  4. 限制:设置过期时间、站点、消耗和地址

    第 3 步,限制:过期时间、文档站点、按作业/天/月计算的消耗上限、下方的自动批准,以及高级设置下的 IP 白名单。
    仅当令牌可能消耗积分时才会显示消耗。

    请参阅下方的 限制选项。

  5. 查看并创建

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

    第 4 步,查看:在创建之前,用通俗语言说明新令牌的功能,以及它的过期时间、文档站点和 IP 白名单。
    检查摘要,然后点击创建令牌。
  6. 复制令牌

    令牌已创建 会显示该令牌,以 clv_agent_ 开头:“立即复制:你将无法再次看到它。”将其复制到密钥存储库或环境变量中。其下方的 连接智能体 提供了适用于 Claude Code、Codex CLI、.mcp.json、curl 和 Claude.ai、ChatGPT 的现成设置。完成后点击 我已保存。

    “令牌已创建”对话框仅显示一次新令牌,并提供适用于 Claude Code、Codex CLI、.mcp.json 和 curl 的现成设置命令。
    令牌仅显示一次。

返回 会保留你输入的所有内容。在更改某些内容后关闭向导会询问“放弃此令牌?”:“你开始的设置将丢失。不会创建任何令牌。”

限制选项

选项 功能 默认
过期时间 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。
“无法创建令牌。请重试。” 出现错误。 重试;如果问题持续,请联系支持团队。