OmeniaClaw channels

Kelola akun saluran chat dan status runtime-nya di Gateway.

Dokumen terkait:

• Panduan saluran: Saluran
• Konfigurasi Gateway: Konfigurasi

Perintah umum

OmeniaClaw channels listOmeniaClaw channels list --allOmeniaClaw channels statusOmeniaClaw channels capabilitiesOmeniaClaw channels capabilities --channel discord --target channel:123OmeniaClaw channels capabilities --channel discord --target channel:<voice-channel-id>OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw channels logs --channel all

channels list hanya menampilkan saluran chat: akun yang dikonfigurasi secara default, dengan tag status installed, configured, dan enabled per akun. Berikan --all untuk juga menampilkan saluran bawaan yang belum memiliki akun terkonfigurasi dan saluran katalog yang dapat diinstal yang belum ada di disk. Penyedia auth (OAuth + kunci API) dan snapshot penggunaan/kuota penyedia model tidak lagi dicetak di sini; gunakan OmeniaClaw models auth list untuk profil auth penyedia dan OmeniaClaw status atau OmeniaClaw models list untuk penggunaan.

Status / kapabilitas / resolve / log

• channels status: --channel <name>, --probe, --timeout <ms>, --json
• channels capabilities: --channel <name>, --account <id> (hanya dengan --channel), --target <dest>, --timeout <ms>, --json
• channels resolve: <entries...>, --channel <name>, --account <id>, --kind <auto|user|group>, --json
• channels logs: --channel <name|all>, --lines <n>, --json

channels status --probe adalah jalur live: pada gateway yang dapat dijangkau, perintah ini menjalankan pemeriksaan probeAccount per akun dan auditAccount opsional, sehingga output dapat menyertakan status transport plus hasil probe seperti works, probe failed, audit ok, atau audit failed. Jika gateway tidak dapat dijangkau, channels status kembali ke ringkasan khusus konfigurasi alih-alih output probe live.

Jangan gunakan OmeniaClaw sessions, Gateway sessions.list, atau alat agen sessions_list sebagai sinyal kesehatan soket saluran. Permukaan tersebut melaporkan baris percakapan tersimpan, bukan status runtime penyedia. Setelah penyedia Discord dimulai ulang, akun yang terhubung tetapi diam mungkin sehat meskipun tidak ada baris sesi Discord yang muncul sampai peristiwa percakapan masuk atau keluar berikutnya.

Menambah / menghapus akun

OmeniaClaw channels add --channel telegram --token <bot-token>OmeniaClaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"OmeniaClaw channels remove --channel telegram --delete

channels remove hanya beroperasi pada plugin saluran yang terinstal/terkonfigurasi. Gunakan channels add terlebih dahulu untuk saluran katalog yang dapat diinstal. Untuk plugin saluran yang didukung runtime, channels remove juga meminta Gateway yang sedang berjalan untuk menghentikan akun yang dipilih sebelum memperbarui konfigurasi, sehingga menonaktifkan atau menghapus akun tidak membiarkan listener lama tetap aktif sampai mulai ulang.

Permukaan penambahan non-interaktif yang umum meliputi:

• saluran bot-token: --token, --bot-token, --app-token, --token-file
• Kolom transport Signal/iMessage: --signal-number, --cli-path, --http-url, --http-host, --http-port, --db-path, --service, --region
• Kolom Google Chat: --webhook-path, --webhook-url, --audience-type, --audience
• Kolom Matrix: --homeserver, --user-id, --access-token, --password, --device-name, --initial-sync-limit
• Kolom Nostr: --private-key, --relay-urls
• Kolom Tlon: --ship, --url, --code, --group-channels, --dm-allowlist, --auto-discover-channels
• --use-env untuk auth akun default yang didukung env jika didukung

Jika plugin saluran perlu diinstal selama perintah penambahan berbasis flag, OmeniaClaw menggunakan sumber instal default saluran tersebut tanpa membuka prompt instal plugin interaktif.

Saat Anda menjalankan OmeniaClaw channels add tanpa flag, wizard interaktif dapat meminta:

• ID akun per saluran yang dipilih
• nama tampilan opsional untuk akun tersebut
• Route these channel accounts to agents now?

Jika Anda mengonfirmasi pengikatan sekarang, wizard menanyakan agen mana yang harus memiliki setiap akun saluran terkonfigurasi dan menulis binding routing berskala akun.

Anda juga dapat mengelola aturan routing yang sama nanti dengan OmeniaClaw agents bindings, OmeniaClaw agents bind, dan OmeniaClaw agents unbind (lihat agen).

Saat Anda menambahkan akun non-default ke saluran yang masih menggunakan pengaturan tingkat atas akun tunggal, OmeniaClaw mempromosikan nilai tingkat atas berskala akun ke dalam peta akun saluran sebelum menulis akun baru. Sebagian besar saluran menempatkan nilai tersebut di channels.<channel>.accounts.default, tetapi saluran bawaan dapat mempertahankan akun promosi yang sudah ada dan cocok. Matrix adalah contoh saat ini: jika satu akun bernama sudah ada, atau defaultAccount menunjuk ke akun bernama yang sudah ada, promosi mempertahankan akun tersebut alih-alih membuat accounts.default baru.

Perilaku routing tetap konsisten:

• Binding khusus saluran yang sudah ada (tanpa accountId) tetap cocok dengan akun default.
• channels add tidak membuat atau menulis ulang binding secara otomatis dalam mode non-interaktif.
• Penyiapan interaktif dapat secara opsional menambahkan binding berskala akun.

Jika konfigurasi Anda sudah berada dalam status campuran (akun bernama ada dan nilai akun tunggal tingkat atas masih ditetapkan), jalankan OmeniaClaw doctor --fix untuk memindahkan nilai berskala akun ke akun promosi yang dipilih untuk saluran tersebut. Sebagian besar saluran dipromosikan ke accounts.default; Matrix dapat mempertahankan target bernama/default yang sudah ada sebagai gantinya.

Login dan logout (interaktif)

OmeniaClaw channels login --channel whatsappOmeniaClaw channels logout --channel whatsapp

• channels login mendukung --verbose.
• channels login dan logout dapat menyimpulkan saluran saat hanya satu target login yang didukung dikonfigurasi.
• channels logout mengutamakan jalur Gateway live saat dapat dijangkau, sehingga logout menghentikan listener aktif apa pun sebelum membersihkan status auth saluran. Jika Gateway lokal tidak dapat dijangkau, perintah ini kembali ke pembersihan auth lokal.
• Jalankan channels login dari terminal pada host gateway. exec agen memblokir alur login interaktif ini; alat login agen bawaan saluran, seperti whatsapp_login, harus digunakan dari chat jika tersedia.

Pemecahan masalah

• Jalankan OmeniaClaw status --deep untuk probe luas.
• Gunakan OmeniaClaw doctor untuk perbaikan terpandu.
• OmeniaClaw channels list tidak lagi mencetak snapshot penggunaan/kuota penyedia model. Untuk itu, gunakan OmeniaClaw status (ringkasan) atau OmeniaClaw models list (per penyedia).
• OmeniaClaw channels status kembali ke ringkasan khusus konfigurasi saat gateway tidak dapat dijangkau. Jika kredensial saluran yang didukung dikonfigurasi melalui SecretRef tetapi tidak tersedia di jalur perintah saat ini, perintah ini melaporkan akun tersebut sebagai terkonfigurasi dengan catatan terdegradasi alih-alih menampilkannya sebagai tidak terkonfigurasi.

Probe kapabilitas

Ambil petunjuk kapabilitas penyedia (intent/scope jika tersedia) plus dukungan fitur statis:

OmeniaClaw channels capabilitiesOmeniaClaw channels capabilities --channel discord --target channel:123

Catatan:

• --channel bersifat opsional; hilangkan untuk mencantumkan setiap saluran (termasuk ekstensi).
• --account hanya valid dengan --channel.
• --target menerima channel:<id> atau ID saluran numerik mentah dan hanya berlaku untuk Discord. Untuk saluran suara Discord, pemeriksaan izin menandai ViewChannel, Connect, Speak, SendMessages, dan ReadMessageHistory yang hilang.
• Probe bersifat spesifik penyedia: intent Discord + izin saluran opsional; bot Slack + scope pengguna; flag bot Telegram + webhook; versi daemon Signal; token aplikasi Microsoft Teams + peran/scope Graph (diberi anotasi jika diketahui). Saluran tanpa probe melaporkan Probe: unavailable.

Resolve nama ke ID

Resolve nama saluran/pengguna ke ID menggunakan direktori penyedia:

OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw channels resolve --channel discord "My Server/#support" "@someone"OmeniaClaw channels resolve --channel matrix "Project Room"

Catatan:

• Gunakan --kind user|group|auto untuk memaksa jenis target.
• Resolusi mengutamakan kecocokan aktif saat beberapa entri memiliki nama yang sama.
• channels resolve bersifat hanya baca. Jika akun yang dipilih dikonfigurasi melalui SecretRef tetapi kredensial tersebut tidak tersedia di jalur perintah saat ini, perintah mengembalikan hasil tidak terselesaikan yang terdegradasi dengan catatan alih-alih membatalkan seluruh proses.
• channels resolve tidak menginstal plugin saluran. Gunakan channels add --channel <name> sebelum me-resolve nama untuk saluran katalog yang dapat diinstal.

Terkait

• Referensi CLI
• Gambaran umum saluran