openclaw agents

Yalıtılmış ajanları (çalışma alanları + kimlik doğrulama + yönlendirme) yönetin. Alt komut olmadan openclaw agents çalıştırmak, openclaw agents list çalıştırmaya eşdeğerdir.

İlgili:

• Çok ajanlı yönlendirme
• Ajan ç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

Komut yüzeyi

agents list

Seçenekler: --json, --bindings (yalnızca ajan başına sayımları/özetleri değil, tüm yönlendirme kurallarını dahil eder).

agents add [name]

Seçenekler: --workspace <dir>, --model <id>, --agent-dir <dir>, --bind <channel[:accountId]> (tekrarlanabilir), --non-interactive, --json.

• Herhangi bir açık ekleme bayrağının iletilmesi, komutu etkileşimsiz yola geçirir.
• Etkileşimsiz mod hem bir ajan adı hem de --workspace gerektirir.
• main ayrılmıştır ve yeni ajan kimliği olarak kullanılamaz.
• Etkileşimli mod, bir kimlik bilgisi copyToAgents: false ile kapsam dışında kalmayı seçmediği sürece yalnızca taşınabilir statik kimlik bilgilerini (api_key ve statik token profilleri) kopyalayarak kimlik doğrulamasını başlangıç durumuna getirir; OAuth yenileme belirteci profilleri, bir sağlayıcı copyToAgents: true ile dahil olmayı seçmediği sürece kopyalanmaz. Kopya olmadan OAuth, yalnızca gerçek main ajan deposundan okuma yoluyla devralma üzerinden kullanılabilir durumda kalır. Yapılandırılmış varsayılan ajan main değilse yeni ajandaki OAuth profilleri için ayrıca oturum açın.

agents bindings

Seçenekler: --agent <id>, --json.

agents bind

Seçenekler: --agent <id> (varsayılan olarak geçerli varsayılan ajan), --bind <channel[:accountId]> (tekrarlanabilir), --json.

agents unbind

Seçenekler: --agent <id> (varsayılan olarak geçerli varsayılan ajan), --bind <channel[:accountId]> (tekrarlanabilir), --all, --json. --all veya bir ya da daha fazla --bind değeri kabul eder; ikisini birlikte kabul etmez.

agents set-identity

Seçenekler: --agent <id>, --workspace <dir>, --identity-file <path>, --from-identity, --name <name>, --theme <theme>, --emoji <emoji>, --avatar <value>, --json. Aşağıdaki Kimliği ayarlama bölümüne bakın.

agents delete <id>

Seçenekler: --force, --json.

• main silinemez.
• --force olmadan etkileşimli onay gerekir (TTY olmayan bir oturumda başarısız olur; --force ile yeniden çalıştırın).
• Çalışma alanı, ajan durumu ve oturum dökümü dizinleri kalıcı olarak silinmek yerine Çöp Kutusu'na taşınır. Çöp Kutusu kullanılamıyorsa ajan yapılandırmasının silinmesi yine de başarılı olur ve elle temizlenmesi gereken yollar bildirilir.
• Gateway'e erişilebildiğinde silme işlemi Gateway üzerinden yönlendirilir; böylece yapılandırma ve oturum deposu temizliği, çalışma zamanı trafiğiyle aynı yazıcıyı paylaşır. Gateway'e erişilemiyorsa CLI, çevrimdışı yerel yola geri döner.
• Başka bir ajanın çalışma alanı aynı yoldaysa, 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 değerlerini bildirir.

Yönlendirme bağlamaları

Gelen kanal trafiğini belirli bir ajana sabitlemek için yönlendirme bağlamalarını kullanın.

Ajan başına farklı görünür skill'ler de istiyorsanız openclaw.json içinde agents.defaults.skills ve agents.entries.*.skills yapılandırın. Skills yapılandırması ve Yapılandırma başvurusu bölümlerine bakın.

Bağlamaları listeleyin:

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

Bağlamalar ekleyin:

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

Bir ajan oluştururken de bağlamalar ekleyebilirsiniz:

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

accountId (--bind <channel>) belirtilmezse OpenClaw bunu Plugin kurulum kancalarından, zorunlu hesap bağlamasından veya kanalın yapılandırılmış hesap sayısından çözümler.

bind veya unbind için --agent belirtilmezse OpenClaw geçerli varsayılan ajanı hedefler.

--bind biçimi

Bağlama kapsamı davranışı

• accountId içermeyen kayıtlı bir bağlama yalnızca kanalın varsayılan hesabıyla eşleşir.
• accountId: "*", kanal genelindeki geri dönüş seçeneğidir (tüm hesaplar) ve açık bir hesap bağlamasından daha az özeldir.
• Aynı ajanda accountId olmadan eşleşen bir kanal bağlaması zaten varsa ve daha sonra açık veya çözümlenmiş bir accountId ile bağlama yaparsanız OpenClaw, yinelenen bir bağlama eklemek yerine mevcut bağlamayı yerinde yükseltir.

Örnekler:

# kanaldaki tüm hesaplarla eşleştiropenclaw agents bind --agent work --bind telegram:* # belirli bir hesapla eşleştiropenclaw agents bind --agent work --bind telegram:ops # başlangıçtaki yalnızca kanal bağlamasıopenclaw agents bind --agent work --bind telegram # daha sonra hesap kapsamlı bağlamaya yükseltopenclaw agents bind --agent work --bind telegram:alerts

Yükseltmeden sonra bu bağlamanın yönlendirmesi telegram:alerts ile kapsamlandırılır. Varsayılan hesap yönlendirmesini de istiyorsanız bunu açıkça ekleyin (örneğin --bind telegram:default).

Bağlamaları kaldırın:

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

Kimlik dosyaları

Her ajan ç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 yolundan) okur.

Avatar yolları çalışma alanı köküne göre çözümlenir ve sembolik bağlantı üzerinden bile bunun dışına çıkamaz.

Kimliği ayarlama

set-identity, agents.entries.*.identity içine şu alanları yazar: name, theme, emoji, avatar (çalışma alanına göre yol, http(s) URL'si veya veri URI'si).

• --agent veya --workspace hedef ajanı seçer. --workspace birden fazla ajanla eşleşirse komut başarısız olur ve --agent iletmenizi ister.
• Çalışma alanına göre belirtilen yerel avatar görüntüsü dosyaları 2 MB ile sınırlıdır. HTTP(S) URL'leri ve data: URI'leri yerel dosya boyutu sınırına göre denetlenmez.
• Açık kimlik alanları sağlanmadığında komut, kimlik verilerini IDENTITY.md konumundan okur.

IDENTITY.md kaynağı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: "uzay ıstakozu",          emoji: "🦞",          avatar: "avatars/openclaw.png",        },      },    ],  },}

İlgili

• CLI başvurusu
• Çok ajanlı yönlendirme
• Ajan çalışma alanı