--message
像你写在纸条上的任务内容。
Cli 导读
用 openclaw agent 发消息给 Agent，先选会话还是直接指定 Agent
核心动作是 `openclaw agent --message "..."`，必须带 `--to`、`--session-id` 或 `--agent` 三者之一来定位会话。最容易踩的坑是 `--channel` 和 `--reply-channel` 只管回复投递，不影响会话路由；想强制走本地 Agent 加 `--local`，但插件注册表仍会预加载。
先讲这一页到底在解决什么
用 openclaw agent 发消息给 Agent，先选会话还是直接指定 Agent
核心动作是 `openclaw agent --message "..."`，必须带 `--to`、`--session-id` 或 `--agent` 三者之一来定位会话。最容易踩的坑是 `--channel` 和 `--reply-channel` 只管回复投递，不影响会话路由；想强制走本地 Agent 加 `--local`，但插件注册表仍会预加载。
第一站
📨 它最像“派一张任务单”，不是打开长期控制台
官方开头就说了：通过 Gateway 跑一轮 agent turn。翻成人话，就是这次派单、这次处理、这次回结果。
--agent ops
像在纸条上写明“请交给运维工位”。
--session-id 1234
像指定“放进这个旧抽屉里继续做”，不是开一个全新抽屉。
一句话
这条命令干的是“派单”，不是“常驻值班”。
第二站
🎯 目标可以有三层：交给谁、放哪个抽屉、要不要把结果送出去
这三个开关很容易混，但其实各管各的。
--agent像决定由哪位工人接单。
--session-id像决定把纸条塞进哪一个旧抽屉，还是接着之前那条线继续做。
--deliver像决定结果是只在后台写完，还是要真的递到外面的人手里。
--reply-channel / --reply-to像在派单单子上再写明：“做完以后，把结果投到这个回信箱里。”
第三站
🧠 --thinking medium 这种参数，像告诉工人“这次想深一点还是快一点”
官方例子里用了 thinking，这很有代表性。因为有时候你不是换工人，而是在调这轮工作的脑力档位。
--thinking medium像说：“这次别太草，也别太磨，走中档思考。”
同一 agent，不同任务
像还是同一个工人，但这次让他做汇总，下次让他出报告，脑力姿势可以变。
不是永久改人格
这更像这张工单上的临时要求，不一定把整个工位永久改掉。
🎈 一句话
这类参数更像“这次怎么干”，不是“以后都这么干”。
第四站
🔐 SecretRef 那段的重点是：就算会重生模型清单，也不把真钥匙写进纸面
官方这里讲的是一个很工程、但很重要的安全习惯。
models.json regeneration像有时候派单前，会顺手把工具目录重新整理一下。
non-secret markers
但它只会把“钥匙放在哪”的标签写下，不会把真钥匙直接抄进去。
source-authoritative
像它只认原始仓库里的标签，不认你临时从口袋里掏出的秘密内容。
📌 一句话
整理目录可以，别把真实密码抄到公开纸面上。
最后总结
🎈 把 openclaw agent 这页压成一句话
openclaw agent 就是一张派单台：把某段任务交给某个 agent、某个会话去处理，再决定结果要不要递到外面去。
如果你下一页只想继续看一页，我建议看 /cli/agents。因为知道“这次把单子派给谁”以后，下一步自然就是“这些工位平时怎么被创建和管理”。