OpenClaw 多会话配置说明
OpenClaw 多会话配置说明
问题
很多朋友在刚开始用OpenClaw的Web Chat界面时会发现，明明配置了好几个不同的agent，但页面上怎么只显示一个会话窗口？这的确是个挺常见的困惑。
原因
这背后的设计逻辑其实很直接：在OpenClaw里，每一个“对话会话”都是严格绑定到一个具体的agent身上的。也就是说，每创建一个新的agent，它都需要在Web Chat界面里“初始化”一下，属于自己的那个独立对话窗口才会显示出来。不是配置了就能直接看到，还得走个“激活”流程。
解决方案
别担心，跟着下面几步走，多会话显示的问题很快就能解决。
1. 创建新的 Agent
首先，咱们得确保有多个agent。打开你的命令行工具，用下面这个命令来创建新的agent：
openclaw agents add
举个例子，如果你想创建一个叫“助理”和一个叫“帮手”的agent，就可以这么操作：
# 创建名为 assistant 的 agent
openclaw agents add assistant --model minimax-cn/MiniMax-M2.5 --workspace ~/.openclaw/workspace-assistant
# 创建名为 helper 的 agent
openclaw agents add helper --model minimax-cn/MiniMax-M2.5 --workspace ~/.openclaw/workspace-helper
2. 初始化 Agent 会话
好了，agent创建完了，但它们在Web界面上还“隐身”着呢。关键是这一步：为每个新agent发送一条初始消息，来激活它的Web Chat会话。
openclaw agent --agent
接着刚才的例子：
# 初始化 assistant 的会话
openclaw agent --agent assistant --message “你好” --channel webchat
# 初始化 helper 的会话
openclaw agent --agent helper --message “你好” --channel webchat
这个过程相当于告诉系统：“这个agent要准备在网页上聊天了，请把它的聊天窗口打开。”
3. 刷新 Web 界面
完成上一步后，现在打开你的浏览器，访问 http://127.0.0.1:18789，然后刷新一下页面。怎么样？之前“失踪”的那些agent会话，现在应该都能在界面里看到了吧？
如果运气不好，刷新后还是没出来？别急，试试这个终极大法：重启一下网关服务。
openclaw gateway restart
重启之后，再刷新网页，问题大概率就解决了。
查看现有配置
有时候你也得确认一下自己的配置状态，下面这几个命令会很有用。
查看所有 agents
openclaw agents list
查看当前会话
openclaw sessions list
查看会话文件
ls -la ~/.openclaw/agents/*/sessions/
使用方式
当所有agent的会话都成功显示在Web界面后，使用起来就非常直观了：
在界面上找到那个选择agent的下拉菜单或者标签页（一般就在页面顶部或者侧边栏）。点一下，在不同的agent之间切换选择就行。每个agent都拥有完全独立的对话历史和上下文，互不干扰，想跟哪个聊就跟哪个聊。
注意事项
为了能更顺畅地使用多会话功能，这里有几个关键点最好记一下：
- 每个agent都会使用自己独立的workspace工作目录。
- 没错，你可以给不同的agent配置完全不同的模型。
- 所有聊天记录都安安稳稳地保存在
~/.openclaw/agents/这个目录下面。/sessions/ - 有个小坑需要注意：如果你给某个agent配了个新模型，但没给它配置对应的API密钥（key），那它可能就无法正常工作，记得把认证信息补全。
删除 Agent
最后，如果某个agent你用不着了，想清理掉，方法也很简单：
openclaw agents delete