Ana içeriğe atla

​
openclaw agents

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

​
Örnekler

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

​
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 bindings
openclaw agents bindings --agent work
openclaw 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

BiçimAnlam
--bind <channel>:*Kanaldaki tüm hesapları eşleştirir.
--bind <channel>:<account>Tek bir hesabı eşleştirir.
--bind <channel>CLI plugin’e özgü bir hesap kapsamını güvenle çözemezse yalnızca varsayılan hesabı eşleştirir.

​
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 channel
openclaw agents bind --agent work --bind telegram:*

# match a specific account
openclaw agents bind --agent work --bind telegram:ops

# initial channel-only binding
openclaw agents bind --agent work --bind telegram

# later upgrade to account-scoped binding
openclaw 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:ops
openclaw 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