Cli 导读

用 `openclaw agents` 管理独立工作区、身份和路由

每个 agent 就是一个独立的“工作区+认证+路由”单元。最该先看 `openclaw agents add` 如何创建带绑定和 workspace 的 agent,以及 `openclaw agents bind` 如何把频道流量固定到指定 agent。容易搞错的是绑定升级:先绑 `telegram` 再绑 `telegram:ops` 会原地升级而非新增,默认账号路由需要显式添加 `--bind telegram:default`。

先讲这一页到底在解决什么

用 `openclaw agents` 管理独立工作区、身份和路由

每个 agent 就是一个独立的“工作区+认证+路由”单元。最该先看 `openclaw agents add` 如何创建带绑定和 workspace 的 agent,以及 `openclaw agents bind` 如何把频道流量固定到指定 agent。容易搞错的是绑定升级:先绑 `telegram` 再绑 `telegram:ops` 会原地升级而非新增,默认账号路由需要显式添加 `--bind telegram:default`。

原文共 15 节,先看 Start Here 路径:/cli/agents 查看官方原文

第一站

🪑 先把桌子摆出来,再决定谁坐哪张

官方最先给你的例子,基本都在做同一件事:新增、查看、删除、绑定、改身份。

📋

openclaw agents list

像先看看现在屋里已经摆了几张桌子。

openclaw agents add work --workspace ...

像给新工位再摆一张桌子,并把它放进自己的房间里。

🪪

openclaw agents set-identity

像给这张桌子发名牌、贴头像、配主题色。

🗑

openclaw agents delete work

像把不用的桌子搬走,不让它继续占位置。

第二站

🏠 每个 agent 都有自己的小房间,房间里还会装自己的记忆和凭证

官方说得很直白:这是 isolated agents。不是所有人挤在一个大屋里,而是各自有自己的空间。

🛏 workspace

像这位 agent 自己睡的小房间。它的配置、文件和节奏都可以单独放。

🔐 auth

像房间门口自己的钥匙。不同 agent 可以用不同的门票和凭证。

🧭 routing

像给门口贴路线牌,告诉外面的消息该进哪间房。

⭐ 一句话

agent 不是一张简单名单,它是一套独立小家当。

第三站

🧷 Routing bindings 像“把某条门口小路钉到某一张桌子上”

这部分是这页最核心的动作之一。你想让某个通道来的消息,直接去某个 agent,就要用 binding。

📍

bind

像在门口写:“这条路来的信,直接送到 work 桌。”

🧽

unbind

像把那张路线牌撕掉,别再往这里送。

👀

bindings

像先看看现在门口都钉了哪些牌子。

📌

一句话先记住

binding 是给消息走路的,不是给 agent 起名字的。

第四站

🎯 accountId 这一段,像“同一扇门里还有不同小班次”

官方特地提醒:一个 channel 里可能有默认账号,也可能有更细的账号 scope。没写清楚时,它会尽量帮你补默认值。

🔁 channel-only binding

像先钉一块大牌子:“这条通道来的信,先送给这张桌。”

🏷 account-scoped binding

像再细一点,直接写到“这个频道里的哪一班车 / 哪一个账号”。

accountId: "*"

像一块“所有班次都算”的大篮子,但它不如明确账号那么具体。

🎈 一句话

默认绑定像粗一点的路标,账号绑定像更细的门牌。

第五站

🪞 `IDENTITY.md` 这页像“工位自我介绍小卡片”

每个 agent 工作区里都可以放一份自己的身份说明。它决定名字、主题、表情、头像。

📄

IDENTITY.md

像桌上贴的一张自我介绍卡:“我是谁,我长什么样,我是什么风格”。

🖼

avatar

像头像牌。可以是工作区里的图、网址,或者直接的一张小图卡。

🎨

name / theme / emoji

像给这个工位穿衣服、挑颜色、贴表情。

📌

一句话

身份不是装饰,它会让不同工位一眼就认出来。

第六站

🧾 `set-identity` 像“把名牌真的写进每张桌子的抽屉里”

这条命令不是改外观那么简单,它会把身份字段写进配置里,成为以后一直能认出来的标签。

--from-identity

像直接从 IDENTITY.md 抄一份到配置里,不用你手动一条条填。

--agent main

像只给主桌换名牌,不碰别的桌。

--name / --emoji / --avatar

像给这张桌子定名字、贴表情、挂头像。

🎈 一句话

set-identity 不是改一句自我介绍,而是真的把身份写进家里。

第七站

🧹 删除 agent 不是删掉一段记忆,而是把不用的桌子搬走

官方给了 delete 作为最后一条常见动作。它是把不需要的工位从清单里移除,不让它继续参与路由。

openclaw agents delete work

像把 work 这张桌子撤走,让房间里不再留它的位置。

🧭 路由也会跟着变

桌子没了,门口那条路自然也不能再往它身上送。

别和 unbind 混了

unbind 是拆路标,delete 是拆桌子。动作力度不一样。

🎈 一句话

delete 是把工位从系统里移走,不是把名字随便擦一下。

最后总结

🎈 把 openclaw agents 压成一句话

openclaw agents 就是在管一排独立小工位:建桌子、写名牌、绑门路、拆路标、搬走不用的桌子,让不同任务能在不同房间里各自安静地干活。