使用手册 · 操作

对话

通过对话界面与你的 OpenClaw Agent 直接交互——就在 ClawButler 内。

/chat

概述#

对话页面提供了一个会话界面,让你无需离开 ClawButler 就能与 OpenClaw Agent 交互。选择一个 Agent,输入消息,实时查看 Agent 的回复——包括它在过程中调用的工具。

对话非常适合测试 Agent 行为、调试工具调用链和快速的临时交互。消息通过连接器隧道发送到 OpenClaw 网关,并以完整的工具调用可见性流式返回。

前置条件#

前置条件
  • 至少配置并同步了一个连接器(参见「连接器」)
  • Agent 已发现且状态健康(参见「Agent」)
  • 目标 Agent 必须在 OpenClaw 中运行并已启用

使用反馈#

打开对话页面并选择一个 Agent 后,你将看到:

  • -Agent 选择器,带有每个可用 Agent 的健康状态指示
  • -消息线程区域,按时间顺序显示你的消息和 Agent 回复
  • -工具调用展开面板,内联在回复中显示工具名称、输入和输出
  • -页面底部的输入栏和发送按钮

Web 端操作#

从侧边栏“操作”分组下导航到对话页面。

Agent 选择器

使用对话区域顶部的下拉菜单选择要交谈的 Agent。选择器显示 Agent 名称、表情和健康状态。切换 Agent 会开始一个新的对话线程。

消息线程

消息在可滚动的线程中显示。你的消息靠右对齐;Agent 回复带头像显示在左侧。回复实时流式传输,你可以看到 Agent 正在思考。回复中的 Markdown 格式会内联渲染。

工具调用显示

当 Agent 在回复过程中调用工具时,会内联显示一个可折叠面板,展示工具名称、输入参数和返回输出。展开任意工具调用可查看完整负载。这对调试 Agent 行为和验证工具使用是否正确非常有价值。

CLI 端操作#

启动与默认 Agent 的交互式对话

Terminal
$ ap chat start

指定 Agent ID 启动对话

Terminal
$ ap chat start --agent <agent-id>

移动端操作#

在移动端,进入“更多”标签页访问对话功能。功能包括:

  • -Agent 选择器和全屏消息线程
  • -实时回复流式传输,支持工具调用展开
  • -优化的键盘处理,方便快速输入消息

常见问题#

Q: Agent 没有回复我的消息。
A: 在 Agent 页面确认 Agent 正在运行且状态健康。如果连接器显示断开,请先重新连接。同时检查 Agent 是否被禁用或通过紧急停止开关停止。
Q: 能看到对话消息的 Token 费用吗?
A: 可以。每个 Agent 回复包含使用量元数据。费用会记录在费用追踪模块中并归属到相应 Agent。查看会话页面可以看到每条消息的费用明细。
Q: 对话会在页面刷新后保留吗?
A: 对话会话由 OpenClaw 网关维护。刷新页面后当前会话会继续。但离开后再返回可能会开始新会话,取决于 Agent 的会话配置。
对话 — ClawButler 用户手册