Перейти к основному содержимому

Команды CLI

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..accounts еще нет), OpenClaw перемещает значения верхнего уровня для одной учетной записи с областью действия учетной записи в channels..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: или числовой идентификатор канала и применяется только к 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, но эти учетные данные недоступны в текущем пути выполнения команды, команда возвращает ухудшенные неразрешенные результаты с примечаниями вместо прерывания всего запуска.

browserclawbot