OmeniaClaw agents

Kelola agen terisolasi (workspace + auth + perutean).

Terkait:

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

Contoh

OmeniaClaw agents listOmeniaClaw agents list --bindingsOmeniaClaw agents add work --workspace ~/.OmeniaClaw/workspace-workOmeniaClaw agents add ops --workspace ~/.OmeniaClaw/workspace-ops --bind telegram:ops --non-interactiveOmeniaClaw agents bindingsOmeniaClaw agents bind --agent work --bind telegram:opsOmeniaClaw agents unbind --agent work --bind telegram:opsOmeniaClaw agents set-identity --workspace ~/.OmeniaClaw/workspace --from-identityOmeniaClaw agents set-identity --agent main --avatar avatars/OmeniaClaw.pngOmeniaClaw agents delete work

Binding perutean

Gunakan binding perutean untuk menetapkan trafik kanal masuk ke agen tertentu.

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

Cantumkan binding:

OmeniaClaw agents bindingsOmeniaClaw agents bindings --agent workOmeniaClaw agents bindings --json

Tambahkan binding:

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

Jika Anda menghilangkan accountId (--bind <channel>), OmeniaClaw menyelesaikannya dari default kanal dan hook penyiapan Plugin jika tersedia.

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

Perilaku cakupan binding

• Binding tanpa accountId hanya cocok dengan 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, OmeniaClaw meningkatkan binding yang ada tersebut di tempat alih-alih menambahkan duplikat.

Contoh:

# initial channel-only bindingOmeniaClaw agents bind --agent work --bind telegram # later upgrade to account-scoped bindingOmeniaClaw agents bind --agent work --bind telegram:ops

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

Hapus binding:

OmeniaClaw agents unbind --agent work --bind telegram:opsOmeniaClaw agents unbind --agent work --all

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

Permukaan perintah

agents

Menjalankan OmeniaClaw agents tanpa subperintah setara dengan OmeniaClaw agents list.

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

Catatan:

• Meneruskan flag tambah 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 auth hanya menyalin profil statis portabel (api_key dan token statis secara default). Profil token penyegaran OAuth tetap tersedia hanya melalui pewarisan baca-langsung 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 workspace, status agen, dan transkrip sesi dipindahkan ke Trash, bukan dihapus permanen.
• Ketika Gateway dapat dijangkau, penghapusan dikirim melalui Gateway sehingga pembersihan konfigurasi dan penyimpanan sesi berbagi penulis yang sama dengan trafik runtime. Jika Gateway tidak dapat dijangkau, CLI beralih ke jalur lokal offline.
• Jika workspace agen lain adalah jalur yang sama, berada di dalam workspace ini, atau berisi workspace ini, workspace dipertahankan dan --json melaporkan workspaceRetained, workspaceRetainedReason, dan workspaceSharedWith.

File identitas

Setiap workspace agen dapat menyertakan IDENTITY.md di root workspace:

• Contoh jalur: ~/.OmeniaClaw/workspace/IDENTITY.md
• set-identity --from-identity membaca dari root workspace (atau --identity-file eksplisit)

Jalur avatar diselesaikan relatif terhadap root workspace.

Atur identitas

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

• name
• theme
• emoji
• avatar (jalur relatif workspace, URL http(s), atau data URI)

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 workspace tersebut, perintah gagal dan meminta Anda meneruskan --agent.
• Jika tidak ada bidang identitas eksplisit yang diberikan, perintah membaca data identitas dari IDENTITY.md.

Muat dari IDENTITY.md:

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

Timpa bidang secara eksplisit:

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

Contoh konfigurasi:

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

Terkait

• Referensi CLI
• Perutean multi-agen
• Workspace agen