Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw channels
Керуйте обліковими записами чат-каналів і їхнім станом виконання на Gateway.
Пов’язана документація:
- Посібники з каналів: Канали
- Конфігурація Gateway: Конфігурація
Поширені команди
channels list показує лише чат-канали: за замовчуванням налаштовані облікові записи зі статусними тегами installed, configured і enabled для кожного облікового запису. Передайте --all, щоб також показати вбудовані канали, які ще не мають налаштованого облікового запису, і встановлювані канали каталогу, яких ще немає на диску. Провайдери автентифікації (OAuth + ключі API) і знімки використання/квот модельних провайдерів тут більше не друкуються; використовуйте openclaw models auth list для профілів автентифікації провайдерів і openclaw status або openclaw models list для використання.
Стан / можливості / розв’язання / журнали
channels status:--channel <name>,--probe,--timeout <ms>,--jsonchannels capabilities:--channel <name>,--account <id>(лише з--channel),--target <dest>,--timeout <ms>,--jsonchannels resolve:<entries...>,--channel <name>,--account <id>,--kind <auto|user|group>,--jsonchannels logs:--channel <name|all>,--lines <n>,--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
не з’явиться до наступної вхідної або вихідної події розмови.
Додавання / видалення облікових записів
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, де це підтримується
openclaw channels add без прапорців, інтерактивний майстер може запитати:
- ідентифікатори облікових записів для кожного вибраного каналу
- необов’язкові відображувані імена для цих облікових записів
Route these channel accounts to agents now?
openclaw agents bindings, openclaw agents bind і openclaw agents unbind (див. агенти).
Коли ви додаєте нестандартний обліковий запис до каналу, який досі використовує верхньорівневі налаштування одного облікового запису, OpenClaw переносить верхньорівневі значення з областю дії облікового запису в карту облікових записів каналу перед записом нового облікового запису. Більшість каналів розміщують ці значення в channels.<channel>.accounts.default, але вбудовані канали можуть натомість зберегти наявний відповідний перенесений обліковий запис. Matrix — поточний приклад: якщо один іменований обліковий запис уже існує або defaultAccount вказує на наявний іменований обліковий запис, перенесення зберігає цей обліковий запис замість створення нового accounts.default.
Поведінка маршрутизації залишається узгодженою:
- Наявні прив’язки лише до каналу (без
accountId) і надалі збігаються зі стандартним обліковим записом. channels addне створює автоматично й не переписує прив’язки в неінтерактивному режимі.- Інтерактивне налаштування може необов’язково додати прив’язки з областю дії облікового запису.
openclaw doctor --fix, щоб перемістити значення з областю дії облікового запису в перенесений обліковий запис, вибраний для цього каналу. Більшість каналів переносять у accounts.default; Matrix натомість може зберегти наявну іменовану/стандартну ціль.
Вхід і вихід (інтерактивно)
channels loginпідтримує--verbose.channels loginіlogoutможуть визначити канал, коли налаштована лише одна підтримувана ціль входу.channels logoutвіддає перевагу live-шляху Gateway, коли він доступний, тому вихід зупиняє будь-який активний слухач перед очищенням стану автентифікації каналу. Якщо локальний Gateway недоступний, він повертається до локального очищення автентифікації.- Запускайте
channels loginз термінала на хості Gateway. Agentexecблокує цей інтерактивний потік входу; channel-native інструменти входу агента, як-отwhatsapp_login, слід використовувати з чату, коли вони доступні.
Усунення несправностей
- Запустіть
openclaw status --deepдля широкої перевірки. - Використовуйте
openclaw doctorдля керованих виправлень. openclaw channels listбільше не друкує знімки використання/квот модельних провайдерів. Для них використовуйтеopenclaw status(огляд) абоopenclaw models list(для кожного провайдера).openclaw channels statusповертається до підсумків лише з конфігурації, коли Gateway недоступний. Якщо облікові дані підтримуваного каналу налаштовані через SecretRef, але недоступні в поточному шляху команди, він повідомляє цей обліковий запис як налаштований із примітками про погіршений стан, а не показує його як неналаштований.
Перевірка можливостей
Отримайте підказки щодо можливостей провайдера (intents/scopes, де доступно) плюс статичну підтримку функцій:--channelнеобов’язковий; пропустіть його, щоб перелічити кожен канал (включно з extensions).--accountчинний лише з--channel.--targetприймаєchannel:<id>або сирий числовий ідентифікатор каналу та застосовується лише до Discord. Для голосових каналів Discord перевірка дозволів позначає відсутніViewChannel,Connect,Speak,SendMessagesіReadMessageHistory.- Перевірки залежать від провайдера: Discord intents + необов’язкові дозволи каналу; Slack bot + user scopes; прапорці бота Telegram + Webhook; версія демона Signal; токен застосунку Microsoft Teams + ролі/області Graph (анотовано, де відомо). Канали без перевірок повідомляють
Probe: unavailable.
Розв’язання імен в ідентифікатори
Розв’язуйте імена каналів/користувачів в ідентифікатори за допомогою каталогу провайдера:- Використовуйте
--kind user|group|auto, щоб примусово задати тип цілі. - Розв’язання віддає перевагу активним збігам, коли кілька записів мають однакове ім’я.
channels resolveдоступний лише для читання. Якщо вибраний обліковий запис налаштований через SecretRef, але ці облікові дані недоступні в поточному шляху команди, команда повертає погіршені нерозв’язані результати з примітками замість переривання всього запуску.channels resolveне встановлює Plugin каналів. Використовуйтеchannels add --channel <name>перед розв’язанням імен для встановлюваного каналу каталогу.