使用手册 · 操作
对话
通过对话界面与你的 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 的会话配置。