approvals-management

name	approvals-management
description	执行审批白名单管理：查看、设置、添加、移除审批规则与模式。当需要管理命令执行白名单、配置审批策略或查看当前审批规则时使用此技能。
tools	gateway
metadata	{"category":"operations","emoji":"✅","tree_id":"system/gateway","tree_group":"system","min_tier":"task_write","intent_priority":20,"intent_keywords":{"zh":["审批白名单","执行权限","命令审批","白名单管理","审批规则","命令执行","权限配置","allowlist","添加白名单","移除白名单"],"en":["approvals management","allowlist","command approval","execution permission","approval rules","approval policy"]},"scene_hint":"管理命令执行白名单用此→远程审批回调配置用remote-approval-config→能力树写权限用capability-governance"}

审批白名单管理技能

适用场景

用户需要管理命令执行审批白名单（exec approvals）时触发。

选择原则

场景	工具/技能
管理执行审批白名单	本技能
远程审批通知配置	→ remote-approval-config 专项工具
安全审计	→ crabclaw security audit CLI
能力树权限查看	→ capability-governance（元技能）

一、查看当前审批规则

1.1 查看本地审批规则

crabclaw approvals get

或 JSON 格式：

crabclaw approvals get --json

1.2 查看 Gateway 侧审批规则

crabclaw approvals get --gateway

Gateway 和本地的审批规则是独立的：

• 本地规则：控制本地 Agent 的命令执行权限
• Gateway 规则：控制通过 Gateway 派发的命令执行权限

二、设置审批规则

2.1 从文件导入

crabclaw approvals set <file> [--gateway]

文件格式支持 JSON 或 YAML：

{
  "allowlist": [
    {"pattern": "git *", "scope": "workspace"},
    {"pattern": "npm test", "scope": "global"},
    {"pattern": "ls *", "scope": "global"}
  ]
}

allowlist:
  - pattern: "git *"
    scope: workspace
  - pattern: "npm test"
    scope: global

2.2 模式语法

语法	说明	示例
*	匹配任意字符	git * 匹配所有 git 命令
精确匹配	完全匹配命令	npm test 仅匹配 npm test
前缀匹配	以某字符串开头	python 匹配所有 python 命令

2.3 作用域

作用域	说明
global	在任何工作目录下都生效
workspace	仅在当前工作区内生效

三、管理白名单条目

3.1 添加模式

crabclaw approvals allowlist-add "<pattern>" [--agent <agent-id>] [--node <node-id>]

参数：

• --agent: 限制到指定智能体
• --node: 限制到指定节点

3.2 移除模式

crabclaw approvals allowlist-remove "<pattern>"

四、审批类型对照

本技能管理的是执行层面的 命令审批白名单。Crab Claw 的完整审批体系包含 4 种类型：

审批类型	触发条件	管理方式
plan_confirm	计划确认	远程审批通知
data_export	敏感数据导出	远程审批通知
mount_access	文件系统挂载	远程审批通知
exec_escalation	命令执行提权	本技能 + 远程审批通知
result_review	最终结果签收	远程审批通知

白名单中的命令跳过 exec_escalation 审批，直接执行。

五、安全注意事项

1. 最小权限原则：只添加确实需要自动执行的命令
2. 避免过宽模式：* 模式会允许所有命令，极不安全
3. workspace 优先：优先使用 workspace 作用域，限制影响范围
4. Gateway 独立：Gateway 侧白名单影响所有通过 Gateway 执行的命令（含远程频道触发）
5. 审计建议：定期 crabclaw approvals get --json 检查白名单内容

六、与运行时安全等级的关系

安全等级	白名单作用
deny (L0)	所有命令被拒绝，白名单无效
allowlist (L1)	仅白名单中的命令可执行
sandboxed (L2)	白名单命令在沙箱中执行，非白名单需审批
full	所有命令可执行，白名单无实际限制

七、CLI 命令对照

CLI 命令	说明
crabclaw approvals get	查看本地白名单
crabclaw approvals get --gateway	查看 Gateway 白名单
crabclaw approvals get --node <id>	查看指定节点白名单
crabclaw approvals get --json	JSON 格式输出
crabclaw approvals set <file>	从文件导入白名单
crabclaw approvals set <file> --gateway	导入到 Gateway
crabclaw approvals allowlist-add "<p>"	添加模式
crabclaw approvals allowlist-add "<p>" --agent <id>	限定智能体
crabclaw approvals allowlist-add "<p>" --node <id>	限定节点
crabclaw approvals allowlist-remove "<p>"	移除模式