Skip to main content

​
openclaw agents

管理隔離的代理程式（工作區 + 驗證 + 路由）。執行 openclaw agents 而不指定子命令，等同於 openclaw agents list。 相關內容：

​
範例

​
命令介面

​
agents list

選項：--json、--bindings（包含完整路由規則，而不只是每個代理程式的數量／摘要）。

​
agents add [name]

選項：--workspace <dir>、--model <id>、--agent-dir <dir>、--bind <channel[:accountId]>（可重複指定）、--non-interactive、--json。
  • 傳入任何明確的新增旗標，都會將命令切換至非互動式路徑。
  • 非互動模式同時需要代理程式名稱與 --workspace。
  • main 是保留值，不能用作新的代理程式 ID。
  • 互動模式會播種驗證資料，方式是只複製可攜式的靜態認證資訊（api_key 與靜態 token 設定檔），除非某項認證資訊透過 copyToAgents: false 選擇退出；除非提供者透過 copyToAgents: true 選擇加入，否則不會複製 OAuth 重新整理權杖設定檔。若未複製，OAuth 只能透過從實際 main 代理程式儲存區唯讀繼承來使用。如果設定的預設代理程式不是 main，請在新代理程式上分別登入 OAuth 設定檔。

​
agents bindings

選項：--agent <id>、--json。

​
agents bind

選項：--agent <id>（預設為目前的預設代理程式）、--bind <channel[:accountId]>（可重複指定）、--json。

​
agents unbind

選項：--agent <id>（預設為目前的預設代理程式）、--bind <channel[:accountId]>（可重複指定）、--all、--json。接受 --all 或一個以上的 --bind 值，但不能同時使用兩者。

​
agents set-identity

選項：--agent <id>、--workspace <dir>、--identity-file <path>、--from-identity、--name <name>、--theme <theme>、--emoji <emoji>、--avatar <value>、--json。請參閱下方的設定身分。

​
agents delete <id>

選項：--force、--json。
  • main 無法刪除。
  • 未使用 --force 時，需要互動式確認（在非 TTY 工作階段中會失敗；請使用 --force 重新執行）。
  • 工作區、代理程式狀態和工作階段逐字稿目錄會移至垃圾桶，而不是永久刪除。若垃圾桶無法使用，代理程式設定仍會成功刪除，並回報需要手動清理的路徑。
  • 當閘道可連線時，刪除會透過閘道路由，讓設定與工作階段儲存區的清理使用與執行階段流量相同的寫入器。若閘道無法連線，命令列介面會退回離線本機路徑。
  • 如果另一個代理程式的工作區使用相同路徑、位於此工作區內，或包含此工作區，則會保留該工作區，而 --json 會回報 workspaceRetained、workspaceRetainedReason 和 workspaceSharedWith。

​
路由繫結

使用路由繫結，將傳入的頻道流量固定導向特定代理程式。 如果也希望每個代理程式顯示不同的 Skill，請在 openclaw.json 中設定 agents.defaults.skills 和 agents.entries.*.skills。請參閱 Skills 設定和設定參考。 列出繫結：
新增繫結：
建立代理程式時也可以新增繫結：
如果省略 accountId（--bind <channel>），OpenClaw 會從外掛設定鉤子、強制帳號繫結或頻道設定的帳號數量解析該值。 如果為 bind 或 unbind 省略 --agent，OpenClaw 會以目前的預設代理程式為目標。

​
--bind 格式

​
繫結範圍行為

  • 儲存的繫結若不含 accountId，只會比對頻道的預設帳號。
  • accountId: "*" 是整個頻道的備援（所有帳號），其明確程度低於明確的帳號繫結。
  • 如果同一個代理程式已有不含 accountId 的相符頻道繫結，而你之後使用明確或已解析的 accountId 進行繫結，OpenClaw 會就地升級現有繫結，而不是新增重複項目。
範例：
升級後，該繫結的路由範圍會限定為 telegram:alerts。如果也需要預設帳號路由，請明確新增（例如 --bind telegram:default）。 移除繫結：

​
身分檔案

每個代理程式工作區都可以在工作區根目錄包含一個 IDENTITY.md：
  • 範例路徑：~/.openclaw/workspace/IDENTITY.md
  • set-identity --from-identity 會從工作區根目錄（或明確指定的 --identity-file）讀取。
頭像路徑會相對於工作區根目錄解析，即使透過符號連結也無法逸出該目錄。

​
設定身分

set-identity 會將欄位寫入 agents.entries.*.identity：name、theme、emoji、avatar（工作區相對路徑、http(s) URL 或資料 URI）。
  • --agent 或 --workspace 用於選取目標代理程式。如果 --workspace 符合多個代理程式，命令會失敗並要求你傳入 --agent。
  • 本機工作區相對頭像圖片檔案的大小上限為 2 MB。HTTP(S) URL 和 data: URI 不受本機檔案大小限制檢查。
  • 未提供明確的身分欄位時，命令會從 IDENTITY.md 讀取身分資料。
從 IDENTITY.md 載入：
明確覆寫欄位：
設定範例：

​
相關內容