合规审计追踪

面向自主智能体（autonomous agents）的不可变、可验证篡改痕迹的审计日志系统。每一次操作均生成一条哈希链式记录，其完整性可被独立验证。

设计初衷

自主智能体在无人工监督的情况下即可做出决策、执行技能、访问数据及支出资金。当异常发生时，您必须精确掌握事件全貌。当前主流智能体框架缺乏标准化的审计追踪能力——本机制正是为此空白而设计。

命令

记录一项操作

python3 {baseDir}/scripts/audit.py log --action "skill_executed" --details '{"skill": "scanner", "target": "some-skill", "result": "clean"}'

记录一项决策

python3 {baseDir}/scripts/audit.py log --action "decision" --details '{"choice": "deploy v2", "reason": "all tests passed", "alternatives_considered": ["rollback", "hotfix"]}'

记录一次数据访问

python3 {baseDir}/scripts/audit.py log --action "data_access" --details '{"resource": "api_key", "purpose": "moltbook_post", "accessor": "ghost_agent"}'

记录一次预算变更

python3 {baseDir}/scripts/audit.py log --action "budget_change" --details '{"amount": -10.00, "merchant": "namecheap", "reason": "domain purchase", "balance_after": 190.00}'

查看最近的记录

python3 {baseDir}/scripts/audit.py view --last 20

按操作类型查看记录

python3 {baseDir}/scripts/audit.py view --action skill_executed

按时间范围查看记录

python3 {baseDir}/scripts/audit.py view --since "2026-02-15T00:00:00" --until "2026-02-16T00:00:00"

验证审计追踪完整性

python3 {baseDir}/scripts/audit.py verify

导出审计追踪

python3 {baseDir}/scripts/audit.py export --format json > audit-export.json
python3 {baseDir}/scripts/audit.py export --format csv > audit-export.csv

生成合规性摘要报告

python3 {baseDir}/scripts/audit.py summary --period day

日志条目格式

每条审计日志包含以下字段：

• timestamp — ISO 8601 格式，UTC 时间
• action — 事件类型（如：skill_executed、decision、data_access、budget_change、error 或自定义类型）
• agent — 执行该操作的智能体名称
• details — 结构化 JSON 数据，内容依具体操作类型而定
• hash — 当前条目的 SHA-256 哈希值，由前一条目的哈希与当前条目完整数据拼接后计算得出（具备篡改可检出性）
• sequence — 单调递增的序列号

完整性验证机制

审计追踪采用哈希链式结构：每条日志均包含一个 SHA-256 哈希值，该值由前一条日志的哈希值与其自身原始数据拼接后计算得出。若任一日志被修改或删除，哈希链将中断，verify 命令将精准定位并报告篡改发生的位置。

存储方式

审计日志以每日 JSON 文件形式保存于 ~/.openclaw/audit/ 目录下，文件命名格式为 audit-YYYY-MM-DD.json。此设计既保证单个文件体积可控，又完整保留全部历史记录。

典型应用场景

• 事故响应：错误发生前 5 分钟内发生了什么？
• 预算问责：逐笔展示资金支出明细及其用途
• 可信度验证：证明您的智能体未遭入侵或劫持
• 企业级合规：满足对自主系统所要求的审计合规性标准
• 调试分析：追溯导致意外结果的完整决策链路