名称： local-approvals
描述： 本地审批系统，用于管理智能体权限。可通过命令行界面（CLI）审批/拒绝请求、查看历史记录以及管理自动审批类别。

本地审批技能

一个本地审批系统，通过自动批准列表和审批历史记录来管理智能体权限。

快速开始

# 列出待处理请求
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py list

# 批准请求
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py approve abc123

# 拒绝请求
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py deny abc123

# 显示审批历史
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py history

# 重置智能体的类别
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py reset assistant

命令

approve(id)

通过 ID 批准待处理的请求。

python cli.py approve <request_id> [--learn] [--reviewer <name>]

选项：
- --learn: 将该类别添加到智能体的自动批准列表
- --reviewer: 审批人（默认："user"）

示例：

python cli.py approve abc123 --learn

deny(id)

通过 ID 拒绝待处理的请求。

python cli.py deny <request_id> [--reviewer <name>]

选项：
- --reviewer: 拒绝人（默认："user"）

示例：

python cli.py deny abc123

list_pending()

列出所有待处理的请求，可按智能体筛选。

python cli.py list [--agent <agent_id>]

选项：
- --agent: 按智能体 ID 筛选请求

示例：

python cli.py list --agent assistant

show_history()

从 state.json 显示审批历史。

python cli.py history [--limit <number>]

选项：
- --limit: 显示的最大条目数（默认：20）

示例：

python cli.py history --limit 50

reset_categories(agent)

重置智能体的自动批准类别列表。

python cli.py reset <agent_id>

示例：

python cli.py reset assistant

附加命令

categories

显示一个或所有智能体的自动批准类别。

python cli.py categories [--agent <agent_id>]

选项：
- --agent: 显示特定智能体的类别

示例：

python cli.py categories --agent planner

状态文件

该技能在状态目录中维护两个 JSON 文件：

• state.json: 自动批准列表和审批历史
• pending.json: 待处理的审批请求

位置：~/.openclaw/skills/local-approvals/

核心功能

core.py 模块提供底层功能：

• check_auto_approve(agent, category) - 检查类别是否已自动批准
• submit_request(agent, category, operation, reasoning) - 提交待处理请求
• learn_category(agent, category) - 将类别添加到自动批准列表
• get_request(request_id) - 按 ID 检索请求
• update_request(request_id, decision, reviewer) - 更新请求决策
• list_pending(agent) - 列出待处理请求
• get_agent_approvals(agent) - 获取智能体的自动批准类别

最佳实践

1. 批准前审查：在批准前务必检查操作和理由
2. 谨慎使用自动学习：仅对您希望自动批准的可信类别使用 --learn
3. 定期检查历史：查看 history 以了解审批模式
4. 需要时重置：如果怀疑有问题，使用 reset 清除智能体的自动批准列表

示例

完整工作流程

# 1. 检查待处理事项
python cli.py list

# 2. 查看请求详情（输出显示智能体、类别、操作、理由）
# ID: abc123
#   智能体:     assistant
#   类别:      file_write
#   操作:      Create config file
#   理由:      Setting up new environment

# 3. 批准并为未来自动学习此类别
python cli.py approve abc123 --learn

# 4. 验证是否已批准
python cli.py list  # 应显示无待处理请求

# 5. 检查历史
python cli.py history

# 6. 查看自动批准类别
python cli.py categories

管理类别

# 查看所有自动批准类别
python cli.py categories

# 查看特定智能体的类别
python cli.py categories --agent assistant

# 重置智能体的类别（清除所有自动批准）
python cli.py reset assistant

集成

CLI 设计用于交互式和编程式使用。退出代码：
- 0: 成功
- 1: 错误（未找到请求、未找到智能体等）

文件

• cli.py - 命令行界面（本文件）
• core.py - 核心审批功能
• schemas/ - JSON 模式定义
• schemas/state.json - 状态模式模板
• schemas/pending.json - 待处理请求模式模板