openclaw channels
Керуйте обліковими записами чат-каналів і їхнім станом виконання в Gateway.
Пов’язана документація:
- Посібники з каналів: Канали
- Налаштування Gateway: Конфігурація
Поширені команди
Статус / можливості / зіставлення / журнали
channels status:--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 — це шлях живої перевірки: на доступному gateway команда запускає для кожного облікового запису перевірки probeAccount і, за потреби, auditAccount, тому вивід може містити стан транспорту разом із результатами перевірок, наприклад works, probe failed, audit ok або audit failed.
Якщо gateway недоступний, channels status повертається до зведень лише на основі конфігурації замість виводу живих перевірок.
Додавання / видалення облікових записів
openclaw channels add --help показує прапорці для кожного каналу окремо (token, приватний ключ, app token, шляхи signal-cli тощо).
Поширені поверхні неінтерактивного додавання включають:
- канали з токеном бота:
--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для автентифікації на основі змінних середовища для облікового запису за замовчуванням там, де це підтримується
openclaw channels add без прапорців, інтерактивний майстер може запитати:
- ідентифікатори облікових записів для кожного вибраного каналу
- необов’язкові відображувані імена для цих облікових записів
Bind configured channel accounts to agents now?
openclaw agents bindings, openclaw agents bind і openclaw agents unbind (див. agents).
Коли ви додаєте не типовий обліковий запис до каналу, який досі використовує однокористувацькі параметри верхнього рівня, OpenClaw піднімає значення верхнього рівня з областю дії облікового запису до мапи облікових записів каналу перед записом нового облікового запису. Для більшості каналів ці значення потрапляють у channels.<channel>.accounts.default, але вбудовані канали можуть натомість зберегти наявний відповідний піднятий обліковий запис. Поточний приклад — Matrix: якщо вже існує один іменований обліковий запис або defaultAccount вказує на наявний іменований обліковий запис, підняття зберігає цей обліковий запис замість створення нового accounts.default.
Поведінка маршрутизації залишається сталою:
- Наявні прив’язки лише до каналу (без
accountId) і далі відповідають обліковому запису за замовчуванням. channels addне створює і не переписує прив’язки автоматично в неінтерактивному режимі.- Інтерактивне налаштування може за бажанням додати прив’язки з областю дії облікового запису.
openclaw doctor --fix, щоб перенести значення з областю дії облікового запису в піднятий обліковий запис, вибраний для цього каналу. Для більшості каналів підняття відбувається в accounts.default; Matrix може зберегти наявну іменовану/типову ціль.
Вхід / вихід (інтерактивно)
channels loginпідтримує--verbose.channels login/logoutможуть визначити канал автоматично, якщо налаштовано лише одну підтримувану ціль входу.
Усунення проблем
- Виконайте
openclaw status --deepдля широкої перевірки. - Використовуйте
openclaw doctorдля покрокового виправлення. openclaw channels listвиводитьClaude: HTTP 403 ... user:profile→ знімку використання потрібна область діїuser:profile. Використайте--no-usage, або надайте ключ сесіїclaude.ai(CLAUDE_WEB_SESSION_KEY/CLAUDE_WEB_COOKIE), або повторно автентифікуйтеся через Claude CLI.openclaw channels statusповертається до зведень лише на основі конфігурації, коли gateway недоступний. Якщо облікові дані підтримуваного каналу налаштовані через SecretRef, але недоступні в поточному шляху команди, цей обліковий запис буде позначено як налаштований із примітками про деградацію, а не як не налаштований.
Перевірка можливостей
Отримайте підказки щодо можливостей провайдера (інтенти/області дії, де доступно) разом зі статичною підтримкою функцій:--channelнеобов’язковий; якщо його не вказати, буде показано всі канали (включно з extensions).--accountдопустимий лише разом із--channel.--targetприймаєchannel:<id>або необроблений числовий ідентифікатор каналу й застосовується лише до Discord.- Перевірки залежать від провайдера: інтенти Discord + необов’язкові дозволи каналу; області дії бота та користувача Slack; прапорці бота Telegram + Webhook; версія демона Signal;
app tokenMicrosoft Teams + ролі/області дії Graph (із примітками там, де це відомо). Канали без перевірок показуютьProbe: unavailable.
Зіставлення імен з ID
Зіставляйте назви каналів/користувачів з ID за допомогою каталогу провайдера:- Використовуйте
--kind user|group|auto, щоб примусово задати тип цілі. - Якщо кілька записів мають однакову назву, зіставлення надає перевагу активним збігам.
channels resolveпрацює лише на читання. Якщо вибраний обліковий запис налаштовано через SecretRef, але ці облікові дані недоступні в поточному шляху команди, команда повертає деградовані нерозв’язані результати з примітками замість переривання всього виконання.