OpenClaw 多会话配置说明

OpenClaw 多会话配置说明

问题

OpenClaw Web Chat 界面默认只显示一个会话（main session），即使配置了多个 agents。

原因

• OpenClaw 的"会话"是基于 agent 的
• 每个 agent 在 webchat 中有一个独立的对话会话
• 新创建的 agent 需要初始化会话后才会在 Web 界面显示

解决方案

1. 创建新的 Agent

使用命令行创建新的 agent：

openclaw agentsadd<agent名称>--modelminimax-cn/MiniMax-M2.5--workspace~/.openclaw/workspace-<agent名称>

示例：

# 创建 assistant agentopenclaw agentsaddassistant--modelminimax-cn/MiniMax-M2.5--workspace~/.openclaw/workspace-assistant# 创建 helper agentopenclaw agentsaddhelper--modelminimax-cn/MiniMax-M2.5--workspace~/.openclaw/workspace-helper

2. 初始化 Agent 会话

创建 agent 后，需要为每个 agent 初始化一个 webchat 会话：

openclaw agent--agent<agent名称>--message"你好"--channelwebchat

示例：

# 初始化 assistant 会话openclaw agent--agentassistant--message"你好"--channelwebchat# 初始化 helper 会话openclaw agent--agenthelper--message"你好"--channelwebchat

3. 刷新 Web 界面

• 访问http://127.0.0.1:18789
• 刷新页面
• 现在应该能看到多个 agent 和对应的会话

如果还是看不到，重启 gateway：

openclaw gateway restart

查看现有配置

查看所有 agents

openclaw agents list

查看当前会话

openclaw sessions list

查看会话文件

ls-la~/.openclaw/agents/*/sessions/

使用方式

在 Web 界面中：

1. 找到 agent 选择器（通常在顶部或侧边栏）
2. 选择不同的 agent
3. 每个 agent 都有独立的对话历史和上下文

注意事项

• 每个 agent 使用独立的 workspace 目录
• 每个 agent 可以配置不同的模型
• 会话历史保存在~/.openclaw/agents/<agent名称>/sessions/目录
• 如果 agent 配置了不同的模型但缺少 API key，需要配置认证信息

删除 Agent

如果需要删除某个 agent：

openclaw agents delete<agent名称>