--- read_when: - Ви хочете додати/видалити облікові записи каналів (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Matrix) - Ви хочете перевірити стан каналу або стежити за журналами каналу summary: Довідник CLI для `openclaw channels` (облікові записи, статус, вхід/вихід, журнали) title: Канали x-i18n: generated_at: "2026-05-11T20:26:30Z" model: gpt-5.5 provider: openai source_hash: 58a964b4db9526defab6ee47b7a99c11086e345d42c8d20f5262fc134337947f source_path: cli/channels.md workflow: 16 --- # `openclaw channels` Керуйте обліковими записами чат-каналів і їхнім станом виконання на Gateway. Пов’язана документація: - Посібники з каналів: [Канали](/uk/channels) - Конфігурація Gateway: [Конфігурація](/uk/gateway/configuration) ## Поширені команди ```bash openclaw channels list openclaw channels list --all openclaw channels status openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 openclaw channels capabilities --channel discord --target channel: openclaw channels resolve --channel slack "#general" "@jane" openclaw channels logs --channel all ``` `channels list` показує лише чат-канали: за замовчуванням налаштовані облікові записи зі статусними тегами `installed`, `configured` і `enabled` для кожного облікового запису. Передайте `--all`, щоб також показати вбудовані канали, які ще не мають налаштованого облікового запису, і встановлювані канали каталогу, яких ще немає на диску. Провайдери автентифікації (OAuth + ключі API) і знімки використання/квот модельних провайдерів тут більше не друкуються; використовуйте `openclaw models auth list` для профілів автентифікації провайдерів і `openclaw status` або `openclaw models list` для використання. ## Стан / можливості / розв’язання / журнали - `channels status`: `--channel `, `--probe`, `--timeout `, `--json` - `channels capabilities`: `--channel `, `--account ` (лише з `--channel`), `--target `, `--timeout `, `--json` - `channels resolve`: ``, `--channel `, `--account `, `--kind `, `--json` - `channels logs`: `--channel `, `--lines `, `--json` `channels status --probe` — це live-шлях: на доступному Gateway він запускає перевірки `probeAccount` і необов’язкові `auditAccount` для кожного облікового запису, тому вивід може містити стан транспорту плюс результати перевірок, як-от `works`, `probe failed`, `audit ok` або `audit failed`. Якщо Gateway недоступний, `channels status` повертається до підсумків лише з конфігурації замість live-виводу перевірки. Не використовуйте `openclaw sessions`, Gateway `sessions.list` або інструмент агента `sessions_list` як сигнал стану сокета каналу. Ці поверхні повідомляють збережені рядки розмов, а не стан виконання провайдера. Після перезапуску провайдера Discord під’єднаний, але тихий обліковий запис може бути справним, хоча жоден рядок сесії Discord не з’явиться до наступної вхідної або вихідної події розмови. ## Додавання / видалення облікових записів ```bash openclaw channels add --channel telegram --token openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY" openclaw channels remove --channel telegram --delete ``` `openclaw channels add --help` показує прапорці для кожного каналу (токен, приватний ключ, токен застосунку, шляхи signal-cli тощо). `channels remove` працює лише з установленими/налаштованими Plugin каналів. Для встановлюваних каналів каталогу спочатку використайте `channels add`. Для Plugin каналів із runtime-підтримкою `channels remove` також просить запущений Gateway зупинити вибраний обліковий запис перед оновленням конфігурації, тому вимкнення або видалення облікового запису не залишає старий слухач активним до перезапуску. Поширені неінтерактивні поверхні додавання: - канали з bot-token: `--token`, `--bot-token`, `--app-token`, `--token-file` - поля транспорту Signal/iMessage: `--signal-number`, `--cli-path`, `--http-url`, `--http-host`, `--http-port`, `--db-path`, `--service`, `--region` - поля Google Chat: `--webhook-path`, `--webhook-url`, `--audience-type`, `--audience` - поля Matrix: `--homeserver`, `--user-id`, `--access-token`, `--password`, `--device-name`, `--initial-sync-limit` - поля Nostr: `--private-key`, `--relay-urls` - поля Tlon: `--ship`, `--url`, `--code`, `--group-channels`, `--dm-allowlist`, `--auto-discover-channels` - `--use-env` для автентифікації стандартного облікового запису через env, де це підтримується Якщо Plugin каналу потрібно встановити під час команди додавання, керованої прапорцями, OpenClaw використовує стандартне джерело встановлення каналу, не відкриваючи інтерактивний запит установлення Plugin. Коли ви запускаєте `openclaw channels add` без прапорців, інтерактивний майстер може запитати: - ідентифікатори облікових записів для кожного вибраного каналу - необов’язкові відображувані імена для цих облікових записів - `Route these channel accounts to agents now?` Якщо ви підтвердите прив’язування зараз, майстер запитає, який агент має володіти кожним налаштованим обліковим записом каналу, і запише прив’язки маршрутизації на рівні облікового запису. Ви також можете керувати тими самими правилами маршрутизації пізніше за допомогою `openclaw agents bindings`, `openclaw agents bind` і `openclaw agents unbind` (див. [агенти](/uk/cli/agents)). Коли ви додаєте нестандартний обліковий запис до каналу, який досі використовує верхньорівневі налаштування одного облікового запису, OpenClaw переносить верхньорівневі значення з областю дії облікового запису в карту облікових записів каналу перед записом нового облікового запису. Більшість каналів розміщують ці значення в `channels..accounts.default`, але вбудовані канали можуть натомість зберегти наявний відповідний перенесений обліковий запис. Matrix — поточний приклад: якщо один іменований обліковий запис уже існує або `defaultAccount` вказує на наявний іменований обліковий запис, перенесення зберігає цей обліковий запис замість створення нового `accounts.default`. Поведінка маршрутизації залишається узгодженою: - Наявні прив’язки лише до каналу (без `accountId`) і надалі збігаються зі стандартним обліковим записом. - `channels add` не створює автоматично й не переписує прив’язки в неінтерактивному режимі. - Інтерактивне налаштування може необов’язково додати прив’язки з областю дії облікового запису. Якщо ваша конфігурація вже була в змішаному стані (іменовані облікові записи наявні, а верхньорівневі значення одного облікового запису все ще встановлені), запустіть `openclaw doctor --fix`, щоб перемістити значення з областю дії облікового запису в перенесений обліковий запис, вибраний для цього каналу. Більшість каналів переносять у `accounts.default`; Matrix натомість може зберегти наявну іменовану/стандартну ціль. ## Вхід і вихід (інтерактивно) ```bash openclaw channels login --channel whatsapp openclaw channels logout --channel whatsapp ``` - `channels login` підтримує `--verbose`. - `channels login` і `logout` можуть визначити канал, коли налаштована лише одна підтримувана ціль входу. - `channels logout` віддає перевагу live-шляху Gateway, коли він доступний, тому вихід зупиняє будь-який активний слухач перед очищенням стану автентифікації каналу. Якщо локальний Gateway недоступний, він повертається до локального очищення автентифікації. - Запускайте `channels login` з термінала на хості Gateway. Agent `exec` блокує цей інтерактивний потік входу; channel-native інструменти входу агента, як-от `whatsapp_login`, слід використовувати з чату, коли вони доступні. ## Усунення несправностей - Запустіть `openclaw status --deep` для широкої перевірки. - Використовуйте `openclaw doctor` для керованих виправлень. - `openclaw channels list` більше не друкує знімки використання/квот модельних провайдерів. Для них використовуйте `openclaw status` (огляд) або `openclaw models list` (для кожного провайдера). - `openclaw channels status` повертається до підсумків лише з конфігурації, коли Gateway недоступний. Якщо облікові дані підтримуваного каналу налаштовані через SecretRef, але недоступні в поточному шляху команди, він повідомляє цей обліковий запис як налаштований із примітками про погіршений стан, а не показує його як неналаштований. ## Перевірка можливостей Отримайте підказки щодо можливостей провайдера (intents/scopes, де доступно) плюс статичну підтримку функцій: ```bash openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 ``` Примітки: - `--channel` необов’язковий; пропустіть його, щоб перелічити кожен канал (включно з extensions). - `--account` чинний лише з `--channel`. - `--target` приймає `channel:` або сирий числовий ідентифікатор каналу та застосовується лише до Discord. Для голосових каналів Discord перевірка дозволів позначає відсутні `ViewChannel`, `Connect`, `Speak`, `SendMessages` і `ReadMessageHistory`. - Перевірки залежать від провайдера: Discord intents + необов’язкові дозволи каналу; Slack bot + user scopes; прапорці бота Telegram + Webhook; версія демона Signal; токен застосунку Microsoft Teams + ролі/області Graph (анотовано, де відомо). Канали без перевірок повідомляють `Probe: unavailable`. ## Розв’язання імен в ідентифікатори Розв’язуйте імена каналів/користувачів в ідентифікатори за допомогою каталогу провайдера: ```bash openclaw channels resolve --channel slack "#general" "@jane" openclaw channels resolve --channel discord "My Server/#support" "@someone" openclaw channels resolve --channel matrix "Project Room" ``` Примітки: - Використовуйте `--kind user|group|auto`, щоб примусово задати тип цілі. - Розв’язання віддає перевагу активним збігам, коли кілька записів мають однакове ім’я. - `channels resolve` доступний лише для читання. Якщо вибраний обліковий запис налаштований через SecretRef, але ці облікові дані недоступні в поточному шляху команди, команда повертає погіршені нерозв’язані результати з примітками замість переривання всього запуску. - `channels resolve` не встановлює Plugin каналів. Використовуйте `channels add --channel ` перед розв’язанням імен для встановлюваного каналу каталогу. ## Пов’язане - [Довідник CLI](/uk/cli) - [Огляд каналів](/uk/channels)