会话监控
监控所有 Agent 的活跃和历史对话。
/sessions概述#
会话页面追踪用户与 OpenClaw Agent 之间的每一次对话。每个会话记录完整的消息线程、工具调用、成本归因和时间数据。这让你全面了解 Agent 的实际运行状况——不仅是配置，更是运行时行为。
会话数据从 OpenClaw 的会话日志中自动采集。你可以通过矩阵布局（Agent × 活跃会话）查看、浏览可筛选的会话列表、深入单个对话，或查阅汇总统计。基于 SSE（Server-Sent Events）的实时指示器无需手动刷新即可显示会话状态。
前置条件#
- 至少配置并同步了一个连接器（参见「连接器」）
- Agent 已处理过至少一次对话（Agent 处理请求时会创建会话）
使用反馈#
同步后，会话页面提供三个主要视图：
- -矩阵视图：以网格形式展示 Agent 及其活跃会话，每个单元格带有健康状态圆点，指示会话状态（活跃、已完成、出错）
- -会话列表：分页、可筛选的会话表格，包含类型、状态、Agent 名称、时长和成本列
- -统计视图：汇总指标，包括会话总数、当前活跃数、平均时长和平均每会话成本
页面顶部的实时指示器在连接到 SSE 流时显示绿色脉冲。活跃会话的状态会自动更新，无需刷新页面。
如果历史会话数据尚未同步，使用回填按钮从 OpenClaw 拉取会话历史。这是一次性操作，将过去的会话批量导入 ClawButler。
Web 端操作#
从侧边栏的「运营」区域导航至会话页面。
矩阵视图
矩阵每行显示一个 Agent，活跃会话分布在各列中。每个单元格显示健康圆点：绿色表示活跃且健康，橙色表示长时间运行，红色表示出错。点击任意单元格可直接跳转到该会话的详情视图。无活跃会话的 Agent 显示空行。
会话列表
切换到列表标签页可查看完整的会话历史。支持按会话类型（聊天、任务、定时）、状态（活跃、已完成、出错、超时）和日期范围筛选。可按开始时间、时长或成本排序。默认每页显示 20 条。
会话详情
点击任意会话可查看完整对话线程。每条消息显示角色（用户或助手）、内容和时间戳。工具调用内联显示，支持展开/折叠查看参数和返回值。助手消息会在可用时显示单条消息成本。
统计视图
统计标签页显示汇总的会话指标：会话总数、活跃数量、平均时长和平均每会话成本。图表可视化展示会话量随时间的变化趋势和各 Agent 的成本分布。
实时更新
SSE 连接保持页面与服务器同步。实时指示器连接时显示绿色脉冲。新会话自动出现，活跃会话实时更新状态。连接中断时指示器变灰，并自动重连。
CLI 端操作#
列出最近的会话，支持可选筛选（Agent、状态、日期范围）
$ ap session list查看指定会话的完整详情，包括消息、工具调用和成本
$ ap session show <id>移动端操作#
在移动端，会话位于「运维」标签页。选择顶部的「会话」分段。
- -会话列表带状态徽章和 Agent 头像
- -点击会话查看完整对话线程和工具调用详情
- -下拉刷新重新加载会话数据