OpenClaw工具分组机制详解

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{  id: "developer",  tools: {    allow: [      "read",      "write",      "edit",      "apply_patch",      "exec",      "bash",      "process",      "browser",      "web_search",      "web_fetch"    ],    deny: [      "sessions_spawn",      "sessions_yield",      "subagents"    ]  }}

1
2
3
4
5
6
7
{  id: "developer",  tools: {    allow: ["group:fs", "group:runtime", "group:web"],    deny: ["group:sessions"]  }}

1
2
3
4
5
6
{  tools: {    allow: ["group:<组名>"],    deny: ["<单个工具名>"]  }}

1
2
3
4
5
6
{  tools: {    allow: ["group:runtime"],    deny: ["exec"]  }}

1
2
3
4
5
6
7
8
9
10
11
12
{  tools: {    allow: [      "group:fs",      "browser",      "web_search"    ],    deny: [      "apply_patch"    ]  }}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// 产品经理：需要读写文档，但不能批量修改{  id: "pm",  tools: {    allow: ["group:fs"],    deny: ["apply_patch"]  }}// 开发工程师：完全文件权限{  id: "developer",  tools: {    allow: ["group:fs"]  }}// 安全审计员：只读{  id: "security-auditor",  tools: {    allow: ["read"],    deny: ["write", "edit", "apply_patch"]  }}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// 开发工程师{  id: "developer",  tools: {    allow: ["group:fs", "group:runtime"]  }}// 运维工程师{  id: "ops",  tools: {    allow: ["group:fs", "group:runtime", "group:automation"]  }}// 安全审计员：禁止所有运行时工具{  id: "security-auditor",  tools: {    allow: ["group:fs"],    deny: ["group:runtime"]  }}

1
2
3
4
5
6
7
8
9
10
{  id: "developer",  sandbox: {    mode: "all",    scope: "agent"  },  tools: {    allow: ["group:runtime"]  }}

1
2
3
4
5
6
7
{  logging: {    audit: {      events: ["exec", "bash"]    }  }}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// 跨部门协调器{  id: "cross-coordinator",  tools: {    allow: [      "group:fs",      "group:sessions",      "message"    ],    deny: ["group:runtime"]  }}// 项目管理智能体：只能查看，不能创建{  id: "pm",  tools: {    allow: [      "group:fs",      "sessions_list",      "sessions_history",      "session_status"    ],    deny: [      "sessions_spawn",      "sessions_yield"    ]  }}

1
2
3
4
1. sessions_spawn 创建新会话（如项目A协作会话）2. sessions_send 向其他部门智能体发送邀请3. subagents 管理参与协作的子智能体4. sessions_yield 让出控制权，等待其他智能体响应

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// 默认配置：所有智能体都可以访问记忆{  agents: {    defaults: {      tools: {        allow: ["group:memory"]      }    }  }}// 临时智能体：不需要记忆{  id: "temporary-assistant",  tools: {    deny: ["group:memory"]  }}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// 产品经理{  id: "pm",  tools: {    allow: ["group:fs", "group:web"]  }}// 安全审计员：禁止访问外网{  id: "security-auditor",  tools: {    allow: ["group:fs"],    deny: ["group:web"]  }}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// 前端开发{  id: "frontend-developer",  tools: {    allow: ["group:fs", "group:runtime", "group:ui"]  }}// UI 设计师：只需要 Canvas{  id: "ui-designer",  tools: {    allow: ["group:fs", "canvas"],    deny: ["browser"]  }}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// 运维工程师{  id: "ops",  tools: {    allow: ["group:fs", "group:runtime", "group:automation"]  }}// 项目经理：只需要定时任务{  id: "pm",  tools: {    allow: ["group:fs", "cron"],    deny: ["gateway"]  }}

1
2
3
4
5
6
{  id: "cross-coordinator",  tools: {    allow: ["group:fs", "group:sessions", "group:messaging"]  }}

1
2
3
4
5
6
{  id: "admin",  tools: {    allow: ["group:openclaw"]  }}

1
2
3
4
5
6
7
{  id: "pm",  tools: {    allow: ["group:fs", "group:web", "sessions_list", "session_status"],    deny: ["apply_patch", "group:runtime", "group:sessions"]  }}

1
2
3
4
5
6
{  id: "frontend-developer",  tools: {    allow: ["group:fs", "group:runtime", "group:ui"]  }}

1
2
3
4
5
6
7
{  id: "backend-developer",  tools: {    allow: ["group:fs", "group:runtime"],    deny: ["browser"]  }}

1
2
3
4
5
6
{  id: "ops",  tools: {    allow: ["group:fs", "group:runtime", "group:automation"]  }}

1
2
3
4
5
6
7
{  id: "security-auditor",  tools: {    allow: ["read", "sessions_list", "session_status"],    deny: ["group:runtime", "group:automation", "write", "edit"]  }}

1
2
3
4
5
6
{  tools: {    allow: ["group:fs", "group:web", "group:memory"],    deny: ["group:runtime", "group:automation"]  }}

1
2
3
4
5
6
{  tools: {    allow: ["group:fs", "group:runtime", "group:web"],    deny: ["group:automation"]  }}

1
2
3
4
5
{  tools: {    allow: ["group:openclaw"]  }}

1
2
3
4
5
6
{  id: "pm",  tools: {    allow: ["group:openclaw"]  // 过度授权  }}

1
2
3
4
5
6
7
{  id: "pm",  tools: {    allow: ["group:fs", "group:web"],    deny: ["group:runtime"]  }}

1
2
3
4
5
6
7
{  id: "developer",  tools: {    allow: ["group:runtime"],    deny: ["exec"]  // exec 最危险  }}

1
2
3
4
5
6
7
8
9
10
{  id: "developer",  sandbox: {    mode: "all",    scope: "agent"  },  tools: {    allow: ["group:runtime"]  }}

1
2
3
4
5
6
7
8
9
{  logging: {    level: "info",    audit: {      enabled: true,      events: ["exec", "bash", "sessions_spawn", "message"]    }  }}

1
2
3
4
5
{  tools: {    allow: ["group:fs", "browser", "web_search"]  }}

1
2
3
4
5
6
{  tools: {    allow: ["group:runtime"],    deny: ["exec"]  // exec 会被拒绝  }}

1
openclaw config get agents.list[0].tools