MateClaw 中文文档 下载 App

审计日志——所有人做过的所有事,按时间顺序,永远保留

生产环境一定要看的东西

安全的一半是拦截,另一半是知道发生过什么。MateClaw 的审计日志表 mate_audit_event 永远保留所有操作记录——谁、什么时候、对什么、做了什么,全在里面。

记录什么

事件类型记录内容
登录/登出用户、时间、IP、成功/失败
工具调用Agent、工具名、参数摘要(敏感参数打码)、结果、耗时
审批请求人、审批人、工具调用摘要、批准/拒绝/超时
Cron 执行任务 ID、Agent、开始时间、结束时间、状态、输出摘要
知识库操作创建/删除 Wiki、原始材料入库、消化结果
工作空间变更成员加入/移除、权限变更

查审计日志的方式

UI 里有专门的审计日志页面,按时间线列出所有事件,支持过滤:

每条审计记录可以展开看完整详情——包括 Agent 的 Thought 摘要(为什么调这个工具)和完整参数(敏感部分打码)。

为什么重要

审计日志在三种场景特别有用:

  1. 出问题后追责:某个 Agent 凌晨执行了一个敏感操作——翻审计日志看看是 Cron 触发的还是有人手动启动的
  2. 合规要求:金融、医药等行业需要可审计的 AI 操作记录,审计日志直接满足
  3. 调试 Agent 行为:Agent 行为不符合预期时,看它每步的 Thought → Action → Observation 链,找到问题出在哪一步

日志保留

审计日志默认永久保留。如果担心表太大,可以定期归档——把 N 天前的日志导出到独立存储然后清理主表。归档脚本以官方最新版为准。