夜雨聆风
OpenClaw 查询切换 Agent 常用命令
OpenClaw 查询切换 Agent 常用命令
本文主题：本文把本聊天中关于 Ubuntu Bash 下 OpenClaw 查询、临时切换 Agent、固定切换 Agent、session 操作、openclaw chat 固定 Agent、三 Agent 日常工作流的全部内容整理为可直接查阅的日常操作手册。
内容摘要：文章保留了所有关键命令、结构图、流程图、概念表格、常见错误、推荐配置与安全边界。核心结论是：临时切换 Agent 用 openclaw agent –agent；session 用 –session-key 或 –session；固定切换分为 Bash 快捷入口、通道路由 bindings、默认 Agent 配置；openclaw chat 更适合通过进入 Agent workspace 后启动。
图片说明：文中结构图均已重绘为 PNG 图片，分别呈现 Agent/session/binding/default 的关系、临时切换流程、固定切换路径、openclaw chat 固定 Agent 路径，以及 coordinator/executor/reviewer 三 Agent 协作结构。
阅读目录：一、问题背景；二、核心结论；三、概念关系；四、临时切换 Agent；五、临时切换 session；六、固定切换 Agent；七、固定 session；八、openclaw chat 固定 Agent；九、tmux 三 Agent 工作台；十、命令清单；十一、常见错误与安全边界；十二、原始问答保留。
一、问题背景：用户要解决什么
本手册的原始问题从 在 Ubuntu bash，OpenClaw 中如何切换不同的 Agent 开始，随后进一步展开为三个操作层面：如何临时切换 Agent 和 session，如何固定切换 Agent 和 session，以及如何在 Bash 中开启 openclaw chat 并指定固定 Agent。
这些问题共同指向一个实际运维场景：用户已经有 coordinator、executor、reviewer 等多个 Agent，需要在 Ubuntu Bash 中明确控制“谁执行任务”“任务上下文是哪一个”“外部入口应该路由到谁”“交互式 chat 应该落到哪个 workspace”。
图 1：Agent、session、binding、default、workspace、Gateway 与 CLI 的关系。
二、核心结论：先把四种切换分清楚
| 操作类型 | 含义 | 推荐命令或位置 |
|---|---|---|
| 临时切换 Agent | 本次命令指定执行主体，不改变默认配置 | openclaw agent –agent <agentId> –message “…” |
| 临时切换 session | 在某个 Agent 下继续指定对话上下文 | –session-key <key> 或 agent:<agentId>:<key> |
| 固定切换 Agent：Bash 层 | 用 alias 或 function 固定常用入口，不改 OpenClaw 配置 | ~/.bashrc 中定义 oc-coordinator、oc-executor、oc-reviewer |
| 固定切换 Agent：通道层 | 把 Feishu、微信、Telegram 等入口固定路由到某个 Agent | openclaw agents bind –agent coordinator –bind feishu:* |
| 固定默认 Agent | 修改未指定 Agent 时的默认落点 | 备份并修改 ~/.openclaw/openclaw.json 中 agents.list[].default |
| openclaw chat 固定 Agent | 进入对应 Agent workspace 后启动交互式 chat | cd ~/.openclaw/workspace-executor && openclaw chat –session main |
最重要的区别：切换 Agent 是换执行主体；切换 session 是换上下文；切换 binding 是换外部入口路由；切换 default 是换未指定 Agent 时的默认落点。
三、概念表：Agent、session、binding、default、workspace
| 概念 | 解决的问题 | 不是什么 | 操作方式 |
|---|---|---|---|
| Agent | 决定由哪个执行主体处理任务，例如 coordinator、executor、reviewer | 不是 session，也不是 Bash shell 目录 | openclaw agent –agent executor –message “…” |
| session | 保存某个 Agent 下的一段对话上下文，便于继续任务 | 不是全局记忆，也不等于 Agent 本体 | –session-key mp-publish-r6；openclaw chat –session main |
| binding | 把外部通道入口固定路由到指定 Agent | 不是改变 CLI 默认 Agent | openclaw agents bind –agent coordinator –bind feishu:* |
| default agent | 当命令或入口没有显式指定 Agent 时使用的默认 Agent | 不是所有 session 的归属 | 修改 agents.list[].default，改前备份 |
| workspace | Agent 的默认工作目录，影响相对路径、项目文件、规则文件 | 不是 session key | cd ~/.openclaw/workspace-executor 后运行 openclaw chat |
| Gateway daemon | OpenClaw 后台服务底座，维持连接、状态、工具链 | 不是 CLI 本身 | openclaw gateway status / restart |
| CLI/TUI | 用户在 Bash 中控制 OpenClaw 的前台入口 | 不是后台服务 | openclaw agent、openclaw chat、openclaw tui |
在日常理解上，可以把 CLI 看作前台控制入口，把 Gateway daemon 看作后台服务底座，把 Agent 看作执行主体，把 session 看作某个主体下的任务上下文。
四、只读预检查：任何切换前先确认状态
echo "===== gateway =====" openclaw gateway status echo "===== agents =====" openclaw agents list openclaw agents list --bindings echo "===== sessions =====" openclaw sessions --all-agents --limit 30
这一步的目的不是修改配置，而是建立当前状态模型。先确认 Gateway、Agent 列表、绑定关系和 session 列表，才能避免把命令发给错误 Agent 或错误 session。
openclaw agents list --bindings --json openclaw sessions --all-agents --json
五、临时切换 Agent：单次命令指定 –agent
临时切换只影响本次命令，不改变默认 Agent，也不改变通道绑定。适合临时测试 coordinator、executor、reviewer 的响应。
5.1 调用 coordinator
openclaw agent --agent coordinator --message "请汇总当前任务状态，只读分析，不修改任何文件。"
5.2 调用 executor
openclaw agent --agent executor --message "请只读检查当前工作目录结构，不要执行写入动作。"
5.3 调用 reviewer
openclaw agent --agent reviewer --message "请审查 executor 的方案是否存在权限、路径、回滚风险。"
图 2：临时切换 Agent 与 session 的流程。
六、临时切换 session：同一 Agent 下换上下文
6.1 查看某个 Agent 的 session
openclaw sessions --agent coordinator --limit 30 openclaw sessions --agent executor --limit 30 openclaw sessions --agent reviewer --limit 30
6.2 用普通 session key 继续
openclaw agent --agent executor --session-key mp-publish-r6 --message "继续该 session，先总结当前进度与下一步只读检查项。"
此时可理解为 OpenClaw 将 session 归入 executor 名下，即 agent:executor:mp-publish-r6。
6.3 用完整 agent-prefixed session key 继续
openclaw agent --agent executor --session-key agent:executor:mp-publish-r6 --message "继续该任务。"
注意：如果 session key 已经写成 agent:
七、临时创建一个新 session
创建新 session 的稳妥方式，是给一个以前没有用过的 session key。
RUN_ID="review-$(date +%Y%m%d_%H%M%S)" openclaw agent --agent reviewer --session-key "$RUN_ID" --message "新建独立审查 session。请审查当前方案，只输出风险清单。"
openclaw sessions --agent reviewer --limit 20
| 命名类型 | 示例 |
|---|---|
| 按任务类型 | mp-publish-20260616_1530 |
| 按网关审查 | gateway-audit-20260616_1535 |
| 按审查任务 | review-20260616_1540 |
| 按阶段 | mp-publish-r6、triad-debug-review |
八、观察某个 session 的执行轨迹
8.1 查看最近 session 轨迹
openclaw sessions tail --agent executor
8.2 跟踪指定 session
openclaw sessions tail --session-key "agent:executor:mp-publish-r6" --tail 50 --follow
该操作适合观察 trajectory 事件，但不应把它误解为切换 Agent。它是对指定 session 的执行轨迹查看。
图 6：session 生命周期、命名规则、继续任务与观察轨迹。
九、固定切换 Agent：方案 A，Bash 别名和函数
这是日常最安全的固定方式。它只影响 Ubuntu Bash 的命令习惯，不改 OpenClaw 配置，不影响飞书、微信、Telegram 等入口。
cat >> ~/.bashrc <<'EOF'
# OpenClaw agent shortcuts
alias oc-coordinator='openclaw agent --agent coordinator'
alias oc-executor='openclaw agent --agent executor'
alias oc-reviewer='openclaw agent --agent reviewer'
ocmsg() {
local agent="$1"
shift
openclaw agent --agent "$agent" --message "$*"
}
ocsession() {
local agent="$1"
local session="$2"
shift 2
openclaw agent --agent "$agent" --session-key "$session" --message "$*"
}
EOF
source ~/.bashrc
9.1 使用方式
oc-coordinator --message "请汇总当前 OpenClaw 状态。" oc-executor --message "只读检查当前目录。" oc-reviewer --message "审查 executor 输出。"
ocmsg coordinator "请汇总当前任务状态。" ocmsg executor "只读检查当前目录。" ocmsg reviewer "审查当前方案风险。"
ocsession executor mp-publish-r6 "继续该任务，先输出当前阶段判断。"
9.2 删除这些别名
nano ~/.bashrc source ~/.bashrc
删除 ~/.bashrc 中刚才追加的 alias/function 段，再重新 source 即可。
图 3：固定切换 Agent 的三条路径。
十、固定切换 Agent：方案 B，固定某个通道入口到某个 Agent
该方案适合把飞书、微信、Telegram、Discord 等外部入口固定路由到某个 Agent。日常建议把外部入口优先绑定到 coordinator，而不是直接绑定 executor。
10.1 查看当前 bindings
openclaw agents bindings openclaw agents bindings --json openclaw agents bindings --agent coordinator
10.2 把某个通道固定到 coordinator
openclaw agents bind --agent coordinator --bind feishu:*
10.3 其他绑定示例
openclaw agents bind --agent coordinator --bind telegram:ops openclaw agents bind --agent reviewer --bind discord:guild-a
10.4 重启并验证
openclaw gateway restart openclaw agents list --bindings openclaw channels status --probe
10.5 取消绑定
openclaw agents unbind --agent coordinator --bind feishu:* openclaw agents unbind --agent coordinator --all
图 7：固定切换与配置修改的安全边界、验证和回滚路径。
十一、固定切换 Agent：方案 C，修改默认 Agent
该方案影响较大：它会改变没有显式指定 Agent 时的默认落点。只有在明确要长期改变默认 Agent 时才使用。
11.1 先备份配置
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak.$(date +%Y%m%d_%H%M%S)
11.2 查看当前 agents 配置
openclaw config get agents.list --json nano ~/.openclaw/openclaw.json
11.3 修改示例
{
agents: {
list: [
{
id: "coordinator",
default: true,
workspace: "~/.openclaw/workspace-coordinator"
},
{
id: "executor",
workspace: "~/.openclaw/workspace-executor"
},
{
id: "reviewer",
workspace: "~/.openclaw/workspace-reviewer"
}
]
}
}
11.4 校验并重启
openclaw config validate openclaw gateway restart openclaw agents list --bindings
11.5 测试默认 Agent
openclaw agent --message "请说明你当前是哪个 Agent，并报告 workspace。"
十二、固定切换 session：Bash 层绑定固定任务上下文
session 不建议无限复用。更稳的做法是按项目、阶段、职责建立固定 session key。
cat >> ~/.bashrc <<'EOF'
mp_executor() {
openclaw agent --agent executor --session-key mp-publish-main --message "$*"
}
mp_reviewer() {
openclaw agent --agent reviewer --session-key mp-publish-review --message "$*"
}
EOF
source ~/.bashrc
mp_executor "继续微信公众号自动发布任务，先汇总当前阶段。" mp_reviewer "审查 executor 的最新方案。"
12.1 查看固定 session
openclaw sessions --agent executor --limit 50 | grep mp-publish-main openclaw sessions tail --session-key agent:executor:mp-publish-main --tail 80
十三、三 Agent 推荐工作流
当前 coordinator / executor / reviewer 不建议随意平级乱用。推荐结构是：用户或外部入口先进入 coordinator，由 coordinator 拆解和分派；executor 执行具体命令；reviewer 审查风险；最后回到 coordinator 汇总。
图 5：三 Agent 日常协作结构。
13.1 普通任务入口：只发 coordinator
openclaw agent --agent coordinator --session-key openclaw-main --message "任务：检查当前 OpenClaw 多 Agent 状态。要求：只读检查，禁止修改配置。"
13.2 executor 只做执行
openclaw agent --agent executor --session-key openclaw-exec --message "根据 coordinator 的任务说明，只读检查当前目录和配置。"
13.3 reviewer 只做审查
openclaw agent --agent reviewer --session-key openclaw-review --message "审查 executor 的检查结果，指出风险和遗漏。"
13.4 coordinator 汇总
openclaw agent --agent coordinator --session-key openclaw-main --message "整合 executor 与 reviewer 的结果，输出下一步状态门控方案。"
十四、openclaw chat 固定 Agent：必须区别于 openclaw agent
关键判断：openclaw chat 本质上是 TUI/local 入口，不是 openclaw agent –agent
14.1 先确认 openclaw chat 是否支持 –agent
openclaw chat --help
如果没有 –agent 选项，就不要写 openclaw chat –agent executor。此时应采用 workspace 或 –session agent:executor:main。
14.2 方法一：进入指定 Agent 的 workspace 后启动 openclaw chat
openclaw agents list --bindings openclaw config get agents.list --json
cd ~/.openclaw/workspace-coordinator openclaw chat --session main cd ~/.openclaw/workspace-executor openclaw chat --session main cd ~/.openclaw/workspace-reviewer openclaw chat --session main
这种方式最稳，因为 workspace 不只影响 session，还影响相对路径、项目文件、AGENTS.md、SOUL.md、USER.md、工具执行默认目录。
14.3 方法二：用 agent-prefixed session 显式指定 Agent
openclaw chat --session agent:executor:main openclaw chat --session agent:coordinator:main openclaw chat --session agent:reviewer:main
该方式不需要 cd 到 workspace，但当前 shell 的工作目录仍可能不是目标 Agent 的 workspace。涉及相对路径或文件工具时，建议优先使用方法一。
图 4：openclaw chat 固定 Agent 的推荐方式。
十五、把 openclaw chat 固定成 Bash 快捷命令
cat >> ~/.bashrc <<'EOF'
# ===== OpenClaw fixed chat entries =====
oc-chat-coordinator() {
cd ~/.openclaw/workspace-coordinator || return 1
openclaw chat --session main
}
oc-chat-executor() {
cd ~/.openclaw/workspace-executor || return 1
openclaw chat --session main
}
oc-chat-reviewer() {
cd ~/.openclaw/workspace-reviewer || return 1
openclaw chat --session main
}
EOF
source ~/.bashrc
oc-chat-coordinator oc-chat-executor oc-chat-reviewer
15.1 更稳版本：固定 Agent + 固定 session 名
cat >> ~/.bashrc <<'EOF'
mp-chat-coordinator() {
cd ~/.openclaw/workspace-coordinator || return 1
openclaw chat --session mp-publish-main
}
mp-chat-executor() {
cd ~/.openclaw/workspace-executor || return 1
openclaw chat --session mp-publish-exec
}
mp-chat-reviewer() {
cd ~/.openclaw/workspace-reviewer || return 1
openclaw chat --session mp-publish-review
}
EOF
source ~/.bashrc
mp-chat-coordinator mp-chat-executor mp-chat-reviewer
| session 命名规则 | 示例 |
|---|---|
| <项目>-main | mp-publish-main |
| <项目>-exec | mp-publish-exec |
| <项目>-review | mp-publish-review |
| 开放调试 | openclaw-gateway-main、triad-debug-review |
十六、直接用 agent-prefixed session 的快捷命令
cat >> ~/.bashrc <<'EOF'
oc-chat-coordinator-direct() {
openclaw chat --session agent:coordinator:main
}
oc-chat-executor-direct() {
openclaw chat --session agent:executor:main
}
oc-chat-reviewer-direct() {
openclaw chat --session agent:reviewer:main
}
EOF
source ~/.bashrc
oc-chat-executor-direct
该方案不如 cd workspace + openclaw chat 稳，因为 session 指向了 Agent，但当前 shell 工作目录仍可能是别处。
十七、连接 Gateway 的 TUI，而不是 local embedded chat
openclaw chat 通常等价于本地 local TUI。如果要连接正在运行的 Gateway，应使用 openclaw tui –url。
openclaw tui --url ws://127.0.0.1:18789 --session agent:executor:main
openclaw tui --url ws://127.0.0.1:18789 --token "<你的gateway token>" --session agent:executor:main
安全注意：正文模板中不得写入真实 gateway token、API Key、cookie、AppSecret。实际使用时只在本地命令行临时填入。
十八、tmux 固定三 Agent 窗口
tmux new -s openclaw-triad
窗口 1：coordinator
cd ~/.openclaw/workspace-coordinator openclaw chat --session triad-main
新建窗口
Ctrl+b 然后按 c
窗口 2：executor
cd ~/.openclaw/workspace-executor openclaw chat --session triad-exec
窗口 3：reviewer
cd ~/.openclaw/workspace-reviewer openclaw chat --session triad-review
退出但保持运行
Ctrl+b 然后按 d
重新进入
tmux attach -t openclaw-triad
十九、推荐最终 Bash 配置
cat >> ~/.bashrc <<'EOF'
# ===== OpenClaw triad fixed chat =====
triad-coordinator() {
cd ~/.openclaw/workspace-coordinator || return 1
openclaw chat --session triad-main
}
triad-executor() {
cd ~/.openclaw/workspace-executor || return 1
openclaw chat --session triad-exec
}
triad-reviewer() {
cd ~/.openclaw/workspace-reviewer || return 1
openclaw chat --session triad-review
}
mp-coordinator() {
cd ~/.openclaw/workspace-coordinator || return 1
openclaw chat --session mp-publish-main
}
mp-executor() {
cd ~/.openclaw/workspace-executor || return 1
openclaw chat --session mp-publish-exec
}
mp-reviewer() {
cd ~/.openclaw/workspace-reviewer || return 1
openclaw chat --session mp-publish-review
}
EOF
source ~/.bashrc
triad-coordinator triad-executor triad-reviewer mp-coordinator mp-executor mp-reviewer
二十、最小可复制命令清单
20.1 查看
openclaw gateway status openclaw agents list --bindings openclaw sessions --all-agents --limit 30
20.2 临时切换 Agent
openclaw agent --agent coordinator --message "汇总当前状态。" openclaw agent --agent executor --message "只读检查当前目录。" openclaw agent --agent reviewer --message "审查当前方案。"
20.3 临时切换 Agent + session
openclaw agent --agent executor --session-key mp-publish-r6 --message "继续该任务。" openclaw agent --agent reviewer --session-key mp-review-r6 --message "审查该任务。"
20.4 固定 Bash 快捷入口
cat >> ~/.bashrc <<'EOF' alias oc-coordinator='openclaw agent --agent coordinator' alias oc-executor='openclaw agent --agent executor' alias oc-reviewer='openclaw agent --agent reviewer' EOF source ~/.bashrc
20.5 固定通道路由
openclaw agents bindings openclaw agents bind --agent coordinator --bind feishu:* openclaw gateway restart openclaw agents list --bindings openclaw channels status --probe
20.6 openclaw chat 固定 executor
cd ~/.openclaw/workspace-executor openclaw chat --session mp-publish-exec
二十一、常见错误与修正
| 错误 | 后果 | 正确处理 |
|---|---|---|
| 以为 cd 能切换 Agent | 只改变 Bash 当前目录，不改变 openclaw agent 单轮命令主体 | openclaw agent 明确写 –agent；openclaw chat 可通过进入 workspace 影响选择 |
| 以为 session 是全局的 | 实际 session 归属于某个 Agent store | 使用 agent:<agentId>:<key> 或同时写 –agent 与 –session-key |
| 不写 –agent 直接发任务 | 会落到默认 Agent，可能不是目标 Agent | 日常脚本显式写 –agent coordinator/executor/reviewer |
| 把 Feishu 固定到 executor | 绕过 coordinator，总控失效，审查链断裂 | 外部入口优先绑定 coordinator |
| 多个 Agent 共用 agentDir | auth/session 冲突，任务状态污染 | 每个 Agent 独立 workspace、agentDir、sessions |
| 直接手改配置但不备份 | 配置错后难回滚 | 先备份 openclaw.json |
| 所有任务塞进 main | session 污染严重 | 按项目或阶段命名 session |
| openclaw chat –agent executor | 可能报 unknown option | 用 cd workspace 或 –session agent:executor:main |
| 用 openclaw chat 期待 Gateway-only 能力 | local mode 下可能不可用 | 改用 openclaw tui –url … |
二十二、风险、边界与操作原则
默认只读：凡涉及系统、Agent、网络、token、权限、服务、文件修改，应先只读检查，不直接重启、删除、旋转 token 或修改配置。
计划先行：修改前应先说明用途、位置、只读/写入性质、执行与停止条件。出现 STOP 条件时应停止。
最小权限：不要让 Agent 默认操作 /mnt/c/Users、Windows 系统目录、真实生产项目、含 API Key 的目录。先用测试 workspace。
可回滚：修改 openclaw.json、~/.bashrc、bindings、token、Gateway 配置之前，先备份或至少输出当前配置。
二十三、原始问答保留：本聊天轮次整理
23.1 用户问题一
在Ubuntu bash ，openclaw 中，如何切换不同的Agent ？
23.2 答复一的核心内容
回答指出：在 Ubuntu bash 里，切换不同 Agent 的核心命令不是 cd、不是切换 shell session，而是在 OpenClaw CLI 调用时指定 –agent
openclaw agents list openclaw agents list --bindings openclaw agents bindings openclaw agent --agent coordinator --message "说明当前可用 Agent、会话和任务状态。" openclaw agent --agent executor --message "在只读模式下检查当前工作目录结构。" openclaw agent --agent reviewer --message "审查 executor 最近一次输出是否存在风险。" openclaw sessions --all-agents openclaw sessions --agent executor openclaw agent --agent executor --session-key incident-42 --message "继续刚才的任务，先总结当前进度。" openclaw agent --agent executor --session-key agent:executor:incident-42 --message "继续该会话。"
该轮还强调：Agent 是主体；session 是该主体下面的对话状态。日常任务优先给 coordinator，需要直接测试执行时才单独调用 executor，需要审查时调用 reviewer。
openclaw agents bind --agent coordinator --bind feishu:* openclaw agents bindings openclaw agents unbind --agent coordinator --bind feishu:*
23.3 用户问题二
详细描述一下，在Ubuntu Bash中临时、固定切换Agent，session的操作步骤。
23.4 答复二的核心内容
回答进一步区分：临时切换 Agent 用 openclaw agent –agent
该轮还提供了完整的预检查、session 轨迹查看、Bash alias/function、bindings、default agent 修改、固定 session、三 Agent 工作流、最小复制命令和常见错误表。上述内容已在本文第四至二十二节完整展开。
23.5 用户问题三
如果在 bash 中开启 openclaw chat 指定 固定的 Agent ，该如何处理？
23.6 答复三的核心内容
回答指出：openclaw chat 本质上是 openclaw tui –local 的别名，不是 openclaw agent –agent
cd ~/.openclaw/workspace-executor openclaw chat --session mp-publish-exec openclaw chat --session agent:executor:main openclaw tui --url ws://127.0.0.1:18789 --session agent:executor:main
该轮还给出 Bash 函数、直接 session 快捷命令、tmux 三窗口和最终 triad/mp 两组固定 chat 入口。本文第十四至十九节已经按操作手册形式保留。
二十四、最终实用结论
CLI 单轮：openclaw agent –agent executor –message “…”。
CLI 续接：openclaw agent –agent executor –session-key mp-publish-main –message “…”。
chat 固定：cd ~/.openclaw/workspace-executor && openclaw chat –session mp-publish-exec。
通道入口：外部入口优先绑定 coordinator，不建议直接绑定 executor。
# 最稳的一句话命令
cd ~/.openclaw/workspace-executor
openclaw chat --session mp-publish-exec