Skip to main content
如果你的团队使用 OpenClaw，OpenClaw 会话捕获功能可将这些会话作为普通会话和事件引入 AgentEye，方便你与其他观测数据一起进行搜索、回放和评估。该功能与 Python SDK 互为补充：SDK 用于对你自行编写的 Agent 进行插桩，而本功能则捕获团队日常使用 OpenClaw 所产生的工作内容——无需改变任何使用习惯。 一个轻量级后台采集器会在 OpenClaw 本地会话记录写入时实时读取，并将其传输至 AgentEye。其工作方式与 Codex 捕获 相同，且同一采集器可同时捕获两者。

​
捕获内容

机器上 OpenClaw 配置中的每个 Agent 都会被该机器的采集器捕获，无需针对单个 Agent 进行额外配置。 每个 OpenClaw 会话对应 AgentEye 中的一个会话；其用户消息、助手消息、工具调用及工具结果将成为对应的事件。

​
开启方式

捕获功能默认关闭，需手动启用。使用具有 events:add 权限的 API 密钥（参见 API 密钥）安装采集器，并开启 OpenClaw 捕获：
该命令会安装采集器、将其注册为后台服务并开始捕获。确认服务正在运行：
同一台机器上需捕获多个 Agent？在同一命令中添加各自的标志即可，例如 --openclaw-enabled --codex-enabled。 首次运行时，已有的 OpenClaw 会话会被一次性回填，此后的新活动将在数秒内实时传输。OpenClaw 的本地文件仅供读取，不会被修改、移动或删除；每个会话即使跨越重启也只会被传输一次。

​
数据呈现位置

捕获的会话显示在 Sessions 中，其事件显示在 Events 流中，与其他被观测的 Agent 完全一致——因此会话回放、搜索、评估和告警均适用。按 OpenClaw Agent 进行筛选可单独查看其数据。

​
隐私说明

OpenClaw 记录包含完整的会话内容——包括命令输出、文件内容以及 Agent 读写的所有信息——可能涉及敏感数据。捕获的会话将原样传输，因此请仅在适合将相关内容集中存储至 AgentEye 的机器和团队中启用捕获功能，并将采集器的密钥权限限定为仅 events:add。有关数据隔离保护措施，请参阅安全性。