channels
Управляйте учетными записями каналов чата и их статусом выполнения на Шлюзе. Связанная документация:
- Руководства по каналам: Каналы
- Конфигурация Шлюза: Конфигурация
Часто используемые команды
openclaw channels list
openclaw channels status
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels logs --channel all
Добавить / удалить учетные записи
openclaw channels add --channel telegram --token <bot-token>
openclaw channels remove --channel telegram --delete
Совет: openclaw channels add --help показывает флаги для каждого канала (токен, токен приложения, пути signal-cli и т.д.). Когда вы запускаете openclaw channels add без флагов, интерактивный мастер может запросить:
- идентификаторы учетных записей для выбранного канала
- необязательные отображаемые имена для этих учетных записей
Привязать настроенные учетные записи каналов к агентам сейчас?
Если вы подтвердите привязку сейчас, мастер спросит, какому агенту должна принадлежать каждая настроенная учетная запись канала, и запишет правила маршрутизации с областью действия учетной записи. Вы также можете управлять этими же правилами маршрутизации позже с помощью команд openclaw agents bindings, openclaw agents bind и openclaw agents unbind (см. agents). Когда вы добавляете нестандартную учетную запись в канал, который все еще использует настройки верхнего уровня для одной учетной записи (записей channels.<channel>.accounts еще нет), OpenClaw перемещает значения верхнего уровня для одной учетной записи с областью действия учетной записи в channels.<channel>.accounts.default, а затем записывает новую учетную запись. Это сохраняет исходное поведение учетной записи при переходе к форме с несколькими учетными записями. Поведение маршрутизации остается согласованным:
- Существующие привязки только к каналу (без
accountId) продолжают соответствовать учетной записи по умолчанию. channels addне создает автоматически и не перезаписывает привязки в неинтерактивном режиме.- Интерактивная настройка может при необходимости добавлять привязки с областью действия учетной записи.
Если ваша конфигурация уже находилась в смешанном состоянии (присутствуют именованные учетные записи, отсутствует default, а значения верхнего уровня для одной учетной записи все еще установлены), запустите openclaw doctor --fix, чтобы переместить значения с областью действия учетной записи в accounts.default.
Вход / выход (интерактивно)
openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp
Устранение неполадок
- Запустите
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 Code CLI.openclaw channels statusпереходит к сводкам только по конфигурации, когда шлюз недоступен. Если учетные данные поддерживаемого канала настроены через SecretRef, но недоступны в текущем пути выполнения команды, он сообщает об этой учетной записи как настроенной с примечаниями о снижении функциональности, вместо того чтобы показывать ее как ненастроенную.
Проверка возможностей
Получение подсказок о возможностях провайдера (интенты/области действия, где доступно) плюс статическая поддержка функций:
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
Примечания:
--channelявляется необязательным; опустите его, чтобы вывести список всех каналов (включая расширения).--targetпринимаетchannel:<id>или числовой идентификатор канала и применяется только к Discord.- Проверки специфичны для провайдера: интенты Discord + необязательные разрешения канала; области действия бота и пользователя Slack; флаги бота Telegram + вебхук; версия демона Signal; токен приложения MS Teams + роли/области действия Graph (с аннотациями, где известно). Каналы без проверок сообщают
Probe: unavailable.
Преобразование имен в ID
Преобразование имен каналов/пользователей в ID с использованием каталога провайдера:
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, но эти учетные данные недоступны в текущем пути выполнения команды, команда возвращает ухудшенные неразрешенные результаты с примечаниями вместо прерывания всего запуска.