openclaw agents

Kelola agen terisolasi (ruang kerja + autentikasi + perutean).

Terkait:

• Perutean multi-agen
• Ruang kerja agen
• Konfigurasi Skills: konfigurasi visibilitas skill.

Contoh

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

Binding perutean

Gunakan binding perutean untuk menetapkan lalu lintas kanal masuk ke agen tertentu.

Jika Anda juga menginginkan skill yang terlihat berbeda per agen, konfigurasikan agents.defaults.skills dan agents.list[].skills di openclaw.json. Lihat Konfigurasi Skills dan Referensi konfigurasi.

Daftar binding:

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

Tambahkan binding:

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

Anda juga dapat menambahkan binding saat membuat agen:

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

Jika Anda menghilangkan accountId (--bind <channel>), OpenClaw menyelesaikannya dari hook penyiapan plugin, binding akun paksa, atau jumlah akun yang dikonfigurasi untuk kanal tersebut.

Jika Anda menghilangkan --agent untuk bind atau unbind, OpenClaw menargetkan agen default saat ini.

Format --bind

Perilaku cakupan binding

• Binding tersimpan tanpa accountId hanya mencocokkan akun default kanal.
• accountId: "*" adalah fallback seluruh kanal (semua akun) dan kurang spesifik dibandingkan binding akun eksplisit.
• Jika agen yang sama sudah memiliki binding kanal yang cocok tanpa accountId, dan Anda kemudian membuat binding dengan accountId eksplisit atau terselesaikan, OpenClaw meningkatkan binding yang ada tersebut di tempat, bukan menambahkan duplikat.

Contoh:

# 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

Setelah peningkatan, perutean untuk binding tersebut dicakup ke telegram:alerts. Jika Anda juga menginginkan perutean akun default, tambahkan secara eksplisit (misalnya --bind telegram:default).

Hapus binding:

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

unbind menerima --all atau satu atau beberapa nilai --bind, bukan keduanya.

Permukaan perintah

agents

Menjalankan openclaw agents tanpa subperintah setara dengan openclaw agents list.

agents list

Opsi:

• --json
• --bindings: sertakan aturan perutean lengkap, bukan hanya hitungan/ringkasan per agen

agents add [name]

Opsi:

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

Catatan:

• Meneruskan flag penambahan eksplisit apa pun mengalihkan perintah ke jalur non-interaktif.
• Mode non-interaktif memerlukan nama agen dan --workspace.
• main dicadangkan dan tidak dapat digunakan sebagai id agen baru.
• Dalam mode interaktif, penyemaian autentikasi hanya menyalin profil statis portabel (api_key dan token statis secara default). Profil token refresh OAuth tetap tersedia hanya melalui pewarisan baca-tembus dari penyimpanan agen main yang sebenarnya. Jika agen default yang dikonfigurasi bukan main, masuk secara terpisah untuk profil OAuth pada agen baru.

agents bindings

Opsi:

• --agent <id>
• --json

agents bind

Opsi:

• --agent <id> (default ke agen default saat ini)
• --bind <channel[:accountId]> (dapat diulang)
• --json

agents unbind

Opsi:

• --agent <id> (default ke agen default saat ini)
• --bind <channel[:accountId]> (dapat diulang)
• --all
• --json

agents delete <id>

Opsi:

• --force
• --json

Catatan:

• main tidak dapat dihapus.
• Tanpa --force, konfirmasi interaktif diperlukan.
• Direktori ruang kerja, status agen, dan transkrip sesi dipindahkan ke Tong Sampah, bukan dihapus permanen.
• Ketika Gateway dapat dijangkau, penghapusan dikirim melalui Gateway sehingga pembersihan konfigurasi dan penyimpanan sesi berbagi penulis yang sama dengan lalu lintas runtime. Jika Gateway tidak dapat dijangkau, CLI kembali ke jalur lokal offline.
• Jika ruang kerja agen lain adalah path yang sama, berada di dalam ruang kerja ini, atau berisi ruang kerja ini, ruang kerja dipertahankan dan --json melaporkan workspaceRetained, workspaceRetainedReason, dan workspaceSharedWith.

File identitas

Setiap ruang kerja agen dapat menyertakan IDENTITY.md di root ruang kerja:

• Contoh path: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity membaca dari root ruang kerja (atau --identity-file eksplisit)

Path avatar diselesaikan relatif terhadap root ruang kerja.

Tetapkan identitas

set-identity menulis kolom ke agents.list[].identity:

• name
• theme
• emoji
• avatar (path relatif ruang kerja, URL http(s), atau URI data)

Opsi:

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

Catatan:

• --agent atau --workspace dapat digunakan untuk memilih agen target.
• Jika Anda mengandalkan --workspace dan beberapa agen berbagi ruang kerja tersebut, perintah gagal dan meminta Anda meneruskan --agent.
• File gambar avatar lokal relatif ruang kerja dibatasi hingga 2 MB. URL HTTP(S) dan URI data: tidak diperiksa dengan batas ukuran file lokal.
• Ketika tidak ada kolom identitas eksplisit yang diberikan, perintah membaca data identitas dari IDENTITY.md.

Muat dari IDENTITY.md:

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

Timpa kolom secara eksplisit:

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

Contoh konfigurasi:

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

Terkait

• Referensi CLI
• Perutean multi-agen
• Ruang kerja agen