用途:在智能体把工作委派给子智能体或者通过 DAG 回忆扩展上下文时,需要一个受控的方式来授予有限范围的权限。Expansion Grant Guard 维护一个 YAML 授权账本,签发带时限和 token 预算的授权,保证子智能体操作不越界。
主要能力:签发授权(可指定 scope、token 预算和 TTL)、校验授权是否仍有效、记录已消耗 token、提前撤销授权、列出全部有效授权、清理已过期授权、查看完整审计日志、统计与状态汇总,并可通过 --format json 输出机器可读结果。
使用方式:使用 Python 命令行调用 guard.py,例如签发授权 python3 guard.py --issue --scope "dag-recall" --budget 4000 --ttl 30;校验 python3 guard.py --validate <grant-id>;记录消耗 python3 guard.py --consume <grant-id> --tokens 500;撤销 python3 guard.py --revoke <grant-id>;列举 python3 guard.py --list;清理 python3 guard.py --sweep;审计 python3 guard.py --audit;统计 python3 guard.py --stats;状态 python3 guard.py --status。
授权生命周期:Issue 之后为 Active,随后可能变为 Consumed、Expired、Revoked 或 Exhausted。校验会同时检查状态为 active、未过期且预算尚有剩余。
适用场景:与 dag-recall、session-persistence、large-file-interceptor、context-assembly-scorer 等技能配合,在搜索会话数据库、恢复大文件、扩展上下文或调用外部工具之前先签发并校验授权。
限制:仅使用 Python 内置模块,无外部依赖;授权 ID 按时间戳当天顺序生成;账本为可追加的 YAML,适合并发读取;默认 TTL 为 30 分钟,最大 TTL 为 24 小时;token 预算是建议性的,实际约束依赖消费方技能配合;状态保存在 ~/.openclaw/skill-state/expansion-grant-guard/state.yaml。其他收费、价格或平台信息暂未提供。