审计日志——所有人做过的所有事,按时间顺序,永远保留
生产环境一定要看的东西
安全的一半是拦截,另一半是知道发生过什么。MateClaw 的审计日志表 mate_audit_event 永远保留所有操作记录——谁、什么时候、对什么、做了什么,全在里面。
记录什么
| 事件类型 | 记录内容 |
|---|---|
| 登录/登出 | 用户、时间、IP、成功/失败 |
| 工具调用 | Agent、工具名、参数摘要(敏感参数打码)、结果、耗时 |
| 审批 | 请求人、审批人、工具调用摘要、批准/拒绝/超时 |
| Cron 执行 | 任务 ID、Agent、开始时间、结束时间、状态、输出摘要 |
| 知识库操作 | 创建/删除 Wiki、原始材料入库、消化结果 |
| 工作空间变更 | 成员加入/移除、权限变更 |
查审计日志的方式
UI 里有专门的审计日志页面,按时间线列出所有事件,支持过滤:
- 按时间范围
- 按 Agent
- 按事件类型(工具调用、审批、登录……)
- 按结果(成功/失败)
每条审计记录可以展开看完整详情——包括 Agent 的 Thought 摘要(为什么调这个工具)和完整参数(敏感部分打码)。
为什么重要
审计日志在三种场景特别有用:
- 出问题后追责:某个 Agent 凌晨执行了一个敏感操作——翻审计日志看看是 Cron 触发的还是有人手动启动的
- 合规要求:金融、医药等行业需要可审计的 AI 操作记录,审计日志直接满足
- 调试 Agent 行为:Agent 行为不符合预期时,看它每步的 Thought → Action → Observation 链,找到问题出在哪一步
日志保留
审计日志默认永久保留。如果担心表太大,可以定期归档——把 N 天前的日志导出到独立存储然后清理主表。归档脚本以官方最新版为准。