agents - OpenClaw

ワークスペース、認証、ルーティングが分離された個別のエージェントを管理します。関連ドキュメント:

マルチエージェントルーティング: マルチエージェントルーティング
エージェントワークスペース: エージェントワークスペース

実行例

openclaw agents list
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

ルーティングバインディング (Routing bindings)

ルーティングバインディングを使用して、インバウンドのチャネルトラフィックを特定のエージェントに固定します。バインディングの一覧表示:

openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json

バインディングの追加:

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

accountId を省略した形式 (--bind <channel>) で実行すると、OpenClaw はチャネルのデフォルト設定やプラグインのセットアップ情報からアカウント ID を自動的に解決しようと試みます。

バインディングのスコープ動作

accountId のないバインディングは、そのチャネルのデフォルトアカウントにのみ一致します。
accountId: "*" は、そのチャネルのすべてのアカウントに一致するフォールバック設定となり、明示的なアカウント指定よりも優先度が低くなります。
すでに特定のチャネルに対して accountId なしのバインディングが存在する状態で、後から明示的または自動解決された accountId を指定して再度バインドした場合、OpenClaw は重複を作成せずに既存のバインディングをアップグレード（書き換え）します。

例:

# 最初にチャネル全体（デフォルトアカウント）をバインド
openclaw agents bind --agent work --bind telegram

# その後、特定のアカウントスコープにアップグレード
openclaw agents bind --agent work --bind telegram:ops

アップグレード後は、そのバインディングによるルーティング対象は telegram:ops に限定されます。もしデフォルトアカウントのルーティングも継続したい場合は、--bind telegram:default のように明示的に追加してください。バインディングの削除:

openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all

アイデンティティファイル (Identity files)

各エージェントのワークスペースルートに IDENTITY.md を置くことができます:

パスの例: ~/.openclaw/workspace/IDENTITY.md
set-identity --from-identity コマンドを実行すると、ワークスペースルート (または --identity-file で指定したファイル) から情報を読み取ります。

アバター（画像）のパスは、ワークスペースルートからの相対パスとして解決されます。

アイデンティティの設定

set-identity は agents.list[].identity の各フィールドを書き換えます:

name (名前)
theme (テーマ)
emoji (絵文字)
avatar (アバター画像。ワークスペース相対パス、http(s) URL、または data URI)

IDENTITY.md から読み込む例:

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

各フィールドを明示的に指定して上書きする例:

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

構成ファイルの記述例:

{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}

​実行例

​ルーティングバインディング (Routing bindings)

​バインディングのスコープ動作

​アイデンティティファイル (Identity files)

​アイデンティティの設定

実行例

ルーティングバインディング (Routing bindings)

バインディングのスコープ動作

アイデンティティファイル (Identity files)

アイデンティティの設定