openclaw agents

Yalıtılmış aracıları yönetin (çalışma alanları + kimlik doğrulama + yönlendirme).

İlgili:

• Çok aracılı yönlendirme
• Aracı çalışma alanı
• Skills yapılandırması: skill görünürlüğü yapılandırması.

Örnekler

openclaw agents listopenclaw agents list --bindingsopenclaw agents add work --workspace ~/.openclaw/workspace-workopenclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactiveopenclaw agents bindingsopenclaw agents bind --agent work --bind telegram:opsopenclaw agents unbind --agent work --bind telegram:opsopenclaw agents set-identity --workspace ~/.openclaw/workspace --from-identityopenclaw agents set-identity --agent main --avatar avatars/openclaw.pngopenclaw agents delete work

Yönlendirme bağları

Gelen kanal trafiğini belirli bir aracıya sabitlemek için yönlendirme bağlarını kullanın.

Aracı başına farklı görünür Skills de istiyorsanız, openclaw.json içinde agents.defaults.skills ve agents.list[].skills yapılandırın. Bkz. Skills yapılandırması ve Yapılandırma başvurusu.

Bağları listeleyin:

openclaw agents bindingsopenclaw agents bindings --agent workopenclaw agents bindings --json

Bağ ekleyin:

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

Aracı oluştururken de bağ ekleyebilirsiniz:

openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*

accountId değerini atlarsanız (--bind <channel>), OpenClaw bunu plugin kurulum hook'larından, zorunlu hesap bağından veya kanalın yapılandırılmış hesap sayısından çözer.

bind veya unbind için --agent değerini atlarsanız, OpenClaw geçerli varsayılan aracıyı hedefler.

--bind biçimi

Bağ kapsamı davranışı

• accountId olmadan saklanan bir bağ yalnızca kanalın varsayılan hesabıyla eşleşir.
• accountId: "*" kanal genelinde geri dönüş değeridir (tüm hesaplar) ve açık bir hesap bağından daha az özeldir.
• Aynı aracının zaten accountId olmadan eşleşen bir kanal bağı varsa ve daha sonra açık veya çözülmüş bir accountId ile bağlarsanız, OpenClaw yinelenen bir bağ eklemek yerine mevcut bağı yerinde yükseltir.

Örnekler:

# match all accounts on the channelopenclaw agents bind --agent work --bind telegram:* # match a specific accountopenclaw agents bind --agent work --bind telegram:ops # initial channel-only bindingopenclaw agents bind --agent work --bind telegram # later upgrade to account-scoped bindingopenclaw agents bind --agent work --bind telegram:alerts

Yükseltmeden sonra, bu bağ için yönlendirme telegram:alerts kapsamına alınır. Varsayılan hesap yönlendirmesini de istiyorsanız, bunu açıkça ekleyin (örneğin --bind telegram:default).

Bağları kaldırın:

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

unbind, --all ya da bir veya daha fazla --bind değeri kabul eder; ikisini birlikte kabul etmez.

Komut yüzeyi

agents

Alt komut olmadan openclaw agents çalıştırmak, openclaw agents list ile eşdeğerdir.

agents list

Seçenekler:

• --json
• --bindings: yalnızca aracı başına sayımları/özetleri değil, tam yönlendirme kurallarını dahil et

agents add [name]

Seçenekler:

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (tekrarlanabilir)
• --non-interactive
• --json

Notlar:

• Açık herhangi bir ekleme bayrağı geçirmek, komutu etkileşimsiz yola geçirir.
• Etkileşimsiz mod hem bir aracı adı hem de --workspace gerektirir.
• main ayrılmıştır ve yeni aracı kimliği olarak kullanılamaz.
• Etkileşimli modda kimlik doğrulama tohumlama yalnızca taşınabilir statik profilleri (varsayılan olarak api_key ve statik token) kopyalar. OAuth yenileme belirteci profilleri yalnızca gerçek main aracı deposundan okuma yoluyla devralma ile kullanılabilir kalır. Yapılandırılmış varsayılan aracı main değilse, yeni aracıdaki OAuth profilleri için ayrıca oturum açın.

agents bindings

Seçenekler:

• --agent <id>
• --json

agents bind

Seçenekler:

• --agent <id> (geçerli varsayılan aracıya varsayılanlanır)
• --bind <channel[:accountId]> (tekrarlanabilir)
• --json

agents unbind

Seçenekler:

• --agent <id> (geçerli varsayılan aracıya varsayılanlanır)
• --bind <channel[:accountId]> (tekrarlanabilir)
• --all
• --json

agents delete <id>

Seçenekler:

• --force
• --json

Notlar:

• main silinemez.
• --force olmadan etkileşimli onay gerekir.
• Çalışma alanı, aracı durumu ve oturum dökümü dizinleri kalıcı olarak silinmez; Çöp Kutusu'na taşınır.
• Gateway erişilebilir olduğunda, silme işlemi Gateway üzerinden gönderilir; böylece yapılandırma ve oturum deposu temizliği çalışma zamanı trafiğiyle aynı yazıcıyı paylaşır. Gateway'e ulaşılamazsa CLI çevrimdışı yerel yola geri döner.
• Başka bir aracının çalışma alanı aynı yolsa, bu çalışma alanının içindeyse veya bu çalışma alanını içeriyorsa, çalışma alanı korunur ve --json workspaceRetained, workspaceRetainedReason ve workspaceSharedWith bildirir.

Kimlik dosyaları

Her aracı çalışma alanı, çalışma alanı kökünde bir IDENTITY.md içerebilir:

• Örnek yol: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity, çalışma alanı kökünden (veya açık bir --identity-file değerinden) okur

Avatar yolları çalışma alanı köküne göre çözülür.

Kimliği ayarla

set-identity, alanları agents.list[].identity içine yazar:

• name
• theme
• emoji
• avatar (çalışma alanına göre yol, http(s) URL'si veya veri URI'si)

Seçenekler:

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

Notlar:

• Hedef aracıyı seçmek için --agent veya --workspace kullanılabilir.
• --workspace kullanıyorsanız ve birden fazla aracı bu çalışma alanını paylaşıyorsa, komut başarısız olur ve --agent geçirmenizi ister.
• Yerel çalışma alanına göre avatar görüntü dosyaları 2 MB ile sınırlıdır. HTTP(S) URL'leri ve data: URI'leri yerel dosya boyutu sınırıyla denetlenmez.
• Açık kimlik alanları sağlanmadığında, komut kimlik verilerini IDENTITY.md dosyasından okur.

IDENTITY.md dosyasından yükleyin:

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

Alanları açıkça geçersiz kılın:

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

Yapılandırma örneği:

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

İlgili

• CLI başvurusu
• Çok aracılı yönlendirme
• Aracı çalışma alanı