メインコンテンツへスキップ

​
openclaw agents

分離されたagent（workspace + auth + routing）を管理します。 関連:

​
例

openclaw agents list
openclaw agents list --bindings
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive
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

​
ルーティングbinding

受信channelトラフィックを特定のagentに固定するには、ルーティングbindingを使用します。 agentごとに表示されるSkillsも変えたい場合は、 openclaw.jsonでagents.defaults.skillsとagents.list[].skillsを 設定してください。詳細はSkills configおよび Configuration Referenceを参照してください。 bindingを一覧表示するには: 
openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json
bindingを追加するには: 
openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a
accountId（--bind <channel>）を省略すると、OpenClawは利用可能な場合、channelデフォルトとpluginセットアップhookからそれを解決します。 bindまたはunbindで--agentを省略すると、OpenClawは現在のdefault agentを対象にします。

​
bindingスコープの挙動

  • accountIdなしのbindingは、そのchannelのdefault accountにのみ一致します。
  • accountId: "*"はchannel全体のフォールバック（すべてのaccounts）であり、明示的なaccount bindingより具体性が低くなります。
  • 同じagentに対してaccountIdなしの一致するchannel bindingがすでに存在し、後から明示的または解決済みのaccountIdでbindingした場合、OpenClawは重複を追加する代わりに既存のbindingをその場でアップグレードします。
例: 
# 初期のchannelのみbinding
openclaw agents bind --agent work --bind telegram

# 後でaccountスコープbindingにアップグレード
openclaw agents bind --agent work --bind telegram:ops
アップグレード後、そのbindingのルーティングはtelegram:opsにスコープされます。default accountのルーティングも必要な場合は、明示的に追加してください（たとえば--bind telegram:default）。 bindingを削除するには: 
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all
unbindは--allまたは1つ以上の--bind値のいずれかを受け付けます。両方は指定できません。

​
コマンドサーフェス

​
agents

サブコマンドなしでopenclaw agentsを実行することは、openclaw agents listと同等です。

​
agents list

オプション:
  • --json
  • --bindings: agentごとの件数/要約だけでなく、完全なルーティングルールを含める

​
agents add [name]

オプション:
  • --workspace <dir>
  • --model <id>
  • --agent-dir <dir>
  • --bind <channel[:accountId]>（繰り返し可）
  • --non-interactive
  • --json
注:
  • 明示的なaddフラグを1つでも渡すと、コマンドは非対話パスに切り替わります。
  • 非対話モードでは、agent名と--workspaceの両方が必要です。
  • mainは予約済みで、新しいagent idとしては使用できません。

​
agents bindings

オプション:
  • --agent <id>
  • --json

​
agents bind

オプション:
  • --agent <id>（デフォルトは現在のdefault agent）
  • --bind <channel[:accountId]>（繰り返し可）
  • --json

​
agents unbind

オプション:
  • --agent <id>（デフォルトは現在のdefault agent）
  • --bind <channel[:accountId]>（繰り返し可）
  • --all
  • --json

​
agents delete <id>

オプション:
  • --force
  • --json
注:
  • mainは削除できません。
  • --forceがない場合、対話的な確認が必要です。
  • Workspace、agent state、およびsession transcriptディレクトリは、完全削除ではなくTrashに移動されます。

​
Identityファイル

各agent workspaceには、workspaceルートにIDENTITY.mdを含めることができます。
  • 例のパス: ~/.openclaw/workspace/IDENTITY.md
  • set-identity --from-identityはworkspaceルートから読み取ります（または明示的な--identity-file）
avatarパスはworkspaceルートからの相対パスとして解決されます。

​
identityを設定する

set-identityは、agents.list[].identityに次のフィールドを書き込みます。
  • name
  • theme
  • emoji
  • avatar（workspace相対パス、http(s) URL、またはdata URI）
オプション:
  • --agent <id>
  • --workspace <dir>
  • --identity-file <path>
  • --from-identity
  • --name <name>
  • --theme <theme>
  • --emoji <emoji>
  • --avatar <value>
  • --json
注:
  • 対象agentの選択には--agentまたは--workspaceを使用できます。
  • --workspaceに依存していて、複数のagentsがそのworkspaceを共有している場合、コマンドは失敗し、--agentを渡すよう求められます。
  • 明示的なidentityフィールドが指定されていない場合、コマンドはIDENTITY.mdからidentityデータを読み取ります。
IDENTITY.mdから読み込むには: 
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
フィールドを明示的に上書きするには: 
openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png
Configサンプル: 
{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}