OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Agen

openclaw agents

Kelola agen terisolasi (ruang kerja + autentikasi + perutean). Menjalankan openclaw agents tanpa subperintah setara dengan openclaw agents list.

Terkait:

Contoh

bash
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

Cakupan perintah

agents list

Opsi: --json, --bindings (sertakan aturan perutean lengkap, bukan hanya jumlah/ringkasan per agen).

agents add [name]

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

  • Meneruskan tanda tambah eksplisit apa pun akan mengalihkan perintah ke jalur noninteraktif.
  • Mode noninteraktif memerlukan nama agen dan --workspace.
  • main dicadangkan dan tidak dapat digunakan sebagai ID agen baru.
  • Mode interaktif menginisialisasi autentikasi dengan hanya menyalin kredensial statis portabel (profil api_key dan token statis), kecuali kredensial menolak penyalinan dengan copyToAgents: false; profil token penyegaran OAuth tidak disalin kecuali penyedia mengizinkannya dengan copyToAgents: true. Tanpa salinan, OAuth tetap tersedia hanya melalui pewarisan baca-langsung dari penyimpanan agen main yang sebenarnya. Jika agen default yang dikonfigurasi bukan main, masuklah secara terpisah untuk profil OAuth pada agen baru.

agents bindings

Opsi: --agent <id>, --json.

agents bind

Opsi: --agent <id> (default-nya agen default saat ini), --bind <channel[:accountId]> (dapat diulang), --json.

agents unbind

Opsi: --agent <id> (default-nya agen default saat ini), --bind <channel[:accountId]> (dapat diulang), --all, --json. Menerima --all atau satu atau beberapa nilai --bind, tidak keduanya.

agents set-identity

Opsi: --agent <id>, --workspace <dir>, --identity-file <path>, --from-identity, --name <name>, --theme <theme>, --emoji <emoji>, --avatar <value>, --json. Lihat Atur identitas di bawah.

agents delete <id>

Opsi: --force, --json.

  • main tidak dapat dihapus.
  • Tanpa --force, konfirmasi interaktif diperlukan (gagal dalam sesi non-TTY; jalankan kembali dengan --force).
  • Ruang kerja, status agen, dan direktori transkrip sesi dipindahkan ke Sampah, bukan dihapus permanen.
  • Saat Gateway dapat dijangkau, penghapusan dirutekan melalui Gateway agar pembersihan konfigurasi dan penyimpanan sesi menggunakan penulis yang sama dengan lalu lintas waktu proses. Jika Gateway tidak dapat dijangkau, CLI beralih ke jalur lokal luring.
  • Jika ruang kerja agen lain menggunakan jalur yang sama, berada di dalam ruang kerja ini, atau mencakup ruang kerja ini, ruang kerja akan dipertahankan, dan --json melaporkan workspaceRetained, workspaceRetainedReason, dan workspaceSharedWith.

Pengikatan perutean

Gunakan pengikatan perutean untuk menyematkan lalu lintas kanal masuk ke agen tertentu.

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

Cantumkan pengikatan:

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

Tambahkan pengikatan:

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

Anda juga dapat menambahkan pengikatan saat membuat agen:

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

Jika Anda menghilangkan accountId (--bind <channel>), OpenClaw menentukannya dari kait penyiapan plugin, pengikatan akun paksa, atau jumlah akun kanal yang dikonfigurasi.

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

Format --bind

Format Arti
--bind <channel>:* Cocokkan semua akun pada kanal.
--bind <channel>:<account> Cocokkan satu akun.
--bind <channel> Cocokkan hanya akun default, kecuali CLI dapat menentukan cakupan akun khusus plugin dengan aman.

Perilaku cakupan pengikatan

  • Pengikatan tersimpan tanpa accountId hanya cocok dengan akun default kanal.
  • accountId: "*" adalah pengaturan cadangan seluruh kanal (semua akun) dan kurang spesifik dibandingkan pengikatan akun eksplisit.
  • Jika agen yang sama sudah memiliki pengikatan kanal yang cocok tanpa accountId, lalu Anda kemudian mengikat dengan accountId eksplisit atau yang telah ditentukan, OpenClaw meningkatkan pengikatan yang ada tersebut secara langsung alih-alih menambahkan duplikat.

Contoh:

bash
# cocokkan semua akun pada kanalopenclaw agents bind --agent work --bind telegram:* # cocokkan akun tertentuopenclaw agents bind --agent work --bind telegram:ops # pengikatan awal hanya untuk kanalopenclaw agents bind --agent work --bind telegram # kemudian tingkatkan menjadi pengikatan dengan cakupan akunopenclaw agents bind --agent work --bind telegram:alerts

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

Hapus pengikatan:

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

Berkas identitas

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

  • Contoh jalur: ~/.openclaw/workspace/IDENTITY.md
  • set-identity --from-identity membaca dari akar ruang kerja (atau --identity-file yang ditentukan secara eksplisit).

Jalur avatar ditentukan relatif terhadap akar ruang kerja dan tidak dapat keluar darinya, bahkan melalui tautan simbolis.

Atur identitas

set-identity menulis bidang ke dalam agents.list[].identity: name, theme, emoji, avatar (jalur relatif ruang kerja, URL http(s), atau URI data).

  • --agent atau --workspace memilih agen target. Jika --workspace cocok dengan lebih dari satu agen, perintah akan gagal dan meminta Anda meneruskan --agent.
  • Berkas gambar avatar lokal yang jalurnya relatif terhadap ruang kerja dibatasi hingga 2 MB. URL HTTP(S) dan URI data: tidak diperiksa terhadap batas ukuran berkas lokal.
  • Jika tidak ada bidang identitas eksplisit yang diberikan, perintah membaca data identitas dari IDENTITY.md.

Muat dari IDENTITY.md:

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

Timpa bidang secara eksplisit:

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

Contoh konfigurasi:

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

Terkait

Was this useful?
On this page

On this page