跳转至

子代理工具策略

工具策略

子代理首先使用与父代理或目标代理相同的配置档和工具策略流水线。之后,OpenClaw 会应用子代理限制层。

当已结算子代理在 sessions_yield 之后恢复请求方时,延续会保持在生成时捕获的请求方策略。交接仍必须属于当前请求方会话和已结算批次,并且该批次中的每个子代理都必须携带相同的已验证请求方策略。冲突或缺失的子代理策略会使延续保持在其普通受限策略下。当前工具限制和实时吊销检查在执行时仍然适用;交接不会授予额外工具,也不会推断发送方身份。

对于 Claude CLI 后端上的请求方,自动完成轮次会保持同一捕获策略。工具只能通过 OpenClaw 经策略过滤的 MCP 表面到达 CLI,因此原生 CLI 工具在该轮次保持禁用,并且每个继承的拒绝仍然适用。其他 CLI 后端、节点托管的 Claude CLI 会话和结算批次不会重新获得请求方工具。仅消息工具回复会保留其现有的源绑定 message 授权。

无论深度或角色如何,子代理始终失去 gateway、agents_list、session_status、progress_card、cron、message、sessions_send 以及 conversations_* 工具(系统级/交互式工具、父代理拥有的进度卡片、直接投递界面,或应由主代理协调的工具)。这个硬拒绝层在每一轮都从持久化的子代理会话信封派生,包括恢复的和可见的仪表板会话;普通 allow/alsoAllow 条目无法覆盖它。隐藏启动还会在工具构建前禁用 message,作为纵深防御。位于配置深度上限的子代理额外失去 subagents、sessions_list、sessions_history 和 sessions_spawn,因此它们的通信保持在公告链上。

在这里,sessions_history 仍然是有界的、脱敏的召回视图——它既不是原始转录转储,也不是仅散文渲染。

默认情况下,深度低于 5 的子代理会获得 sessions_spawn、subagents、sessions_list 和 sessions_history,以便它们可以管理其子代理。

将工具委派给编码代理

入口代理可以保持无法执行命令或编辑文件,同时将实现工作交给单独配置的编码代理。在请求代理上为每个目标选择加入:

{
  agents: {
    entries: {
      intake: {
        tools: { deny: ["exec", "process", "write", "edit", "apply_patch"] },
        subagents: {
          allowAgents: ["coder"],
          delegateToolsTo: ["coder"],
        },
      },
      coder: {},
    },
  },
}

delegateToolsTo 是操作员拥有的权限,不是 sessions_spawn 参数。它指定确切配置的目标代理;它不替代 allowAgents,也不允许任意目标。没有此授权时,现有调用方工具上限不变。接收代理保持本地受限。

该授权适用于原生跨代理交接,并且仅放宽请求代理自身的 tools.deny 层。全局、提供方、发送方、会话、沙箱和继承限制都不是委派授权。那些层中的重复拒绝仍然被拒绝,并且目标仍应用其自身当前工具策略和硬性子代理限制。限制性继承允许列表不能被丢弃以使交接生效。无法安全投影的显式授权会在创建前失败,而不是启动一个不可用的子代理。ACP 保留其原始继承和准入检查。

初始交接需要 Gateway 侧原生工具表面和本地放置。云工作器和经 CLI 中介的生成表面不能发起或传播该例外。受支持的 CLI 和插件框架目标使用 OpenClaw 中介的工具,而不是环境原生命令表面,因此可以在效果发生前检查授权吊销。无法强制该投影的后端会拒绝运行。

编码目标的同代理原生辅助工具保留该授权和任何额外限制。它们不能将其转移给第三方代理。完成返回到接收代理时,保留接收代理的原始工具快照。移除目标授权或其 allowAgents 准入会在后续准备中恢复原始上限,并在其效果发生前拒绝依赖该授权的保留操作。已启动的效果不会回滚。

现有会话保留其记录的策略;添加此设置不会追溯升级之前创建的子代理。

通过配置覆盖

{
  agents: {
    defaults: {
      subagents: {
        maxConcurrent: 1,
      },
    },
  },
  tools: {
    subagents: {
      tools: {
        // deny wins
        deny: ["gateway", "cron"],
        // if allow is set, it becomes allow-only (deny still wins)
        // allow: ["read", "exec", "process"]
      },
    },
  },
}

tools.subagents.tools.allow 是最终的仅允许过滤器。它可以缩小已解析的工具集,但无法加回被 tools.profile 移除的工具。例如,tools.profile: "coding" 包含 web_search/web_fetch,但不包含 browser 工具。要让编码配置档子代理使用浏览器自动化,请在配置档阶段添加 browser:

{
  tools: {
    profile: "coding",
    alsoAllow: ["browser"],
  },
}

当只有一个代理应获得浏览器自动化时,使用按代理的 agents.entries.*.tools.alsoAllow: ["browser"]。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw