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 权限的密钥。数据隔离方式详见安全说明