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 ile eşdeğerdir.

İlgili:

• Çoklu ajan yönlendirmesi
• Ajan çalışma alanı
• Skills yapılandırması: Skills 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ı da 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 geçirilmesi, komutu etkileşimsiz yola geçirir.
• Etkileşimsiz mod için hem ajan adı hem de --workspace gereklidir.
• main ayrılmıştır ve yeni ajan kimliği olarak kullanılamaz.
• Etkileşimli mod, bir kimlik bilgisi copyToAgents: false ile bunu devre dışı bırakmadığı sürece yalnızca taşınabilir statik kimlik bilgilerini (api_key ve statik token profilleri) kopyalayarak kimlik doğrulamasını başlangıç durumuna getirir; bir sağlayıcı copyToAgents: true ile etkinleştirmediği sürece OAuth yenileme belirteci profilleri kopyalanmaz. Kopyalama yapılmadığında OAuth, yalnızca gerçek main ajan deposundan okuma yoluyla devralma üzerinden kullanılabilir 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ı kullanır), --bind <channel[:accountId]> (tekrarlanabilir), --json.

agents unbind

Seçenekler: --agent <id> (varsayılan olarak geçerli varsayılan ajanı kullanır), --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.
• Gateway erişilebilir olduğunda 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 erişilemezse CLI, çevrimdışı yerel yolu kullanır.
• Başka bir ajanı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 alanlarını bildirir.

Yönlendirme bağlamaları

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

Ayrıca ajan başına farklı görünür Skills istiyorsanız openclaw.json içinde agents.defaults.skills ve agents.list[].skills alanlarını 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 değerini (--bind <channel>) belirtmezseniz 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 seçeneğini belirtmezseniz 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 içermeyen eşleşen bir kanal bağlaması zaten varsa ve daha sonra açıkça belirtilmiş 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şopenclaw agents bind --agent work --bind telegram:* # belirli bir hesapla eşleşopenclaw 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 kapsamındadı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ça belirtilen bir --identity-file dosyasından) okur.

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

Kimliği ayarlama

set-identity, alanları agents.list[].identity içine yazar: name, theme, emoji, avatar (çalışma alanına göreli 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 seçeneğini geçirmenizi ister.
• Yerel, çalışma alanına göreli 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ına göre 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
• Çoklu ajan yönlendirmesi
• Ajan çalışma alanı