Skip to main content
Докинг канала — это переадресация вызовов для одного сеанса OpenClaw. Он сохраняет тот же контекст разговора, но изменяет место доставки будущих ответов для этого сеанса. Докинг работает только из личного чата; его нельзя выполнить из группового чата.

Пример

Алиса может отправлять сообщения OpenClaw в Telegram и Discord:
Если Алиса отправит следующую команду из личного чата Telegram:
OpenClaw сохранит контекст текущего сеанса и изменит маршрут ответов: Сеанс не создаётся заново. История переписки остаётся привязанной к тому же сеансу.

Зачем это использовать

Используйте докинг, когда задача начинается в одном приложении для общения, но следующие ответы должны поступать в другое. Типичный сценарий:
  1. Запустите задачу агента из Telegram.
  2. Перейдите в Discord, где вы координируете работу.
  3. Отправьте /dock_discord из личного чата Telegram.
  4. Продолжайте использовать тот же сеанс OpenClaw, но получайте будущие ответы в Discord.

Обязательная конфигурация

Для докинга требуется session.identityLinks. Исходный отправитель и целевой собеседник должны входить в одну группу идентичности:
Значения представляют собой идентификаторы собеседников с префиксом канала: Канонический ключ (alice выше) — это только общее имя группы идентичности. Команды докинга используют значения с префиксом канала, чтобы подтвердить, что исходный отправитель и целевой собеседник — один и тот же человек.

Команды

OpenClaw создаёт по одной команде /dock-<channel> для каждого загруженного плагина канала, поддерживающего нативные команды, поэтому список растёт по мере добавления плагинов. Встроенные плагины, которые поддерживают эту функцию в настоящее время: Форма с символом подчёркивания также используется как имя нативной команды на платформах вроде Telegram, которые напрямую предоставляют команды с косой чертой.

Что изменяется

Докинг обновляет поля доставки активного сеанса: Эти поля сохраняются в хранилище сеансов и используются для доставки последующих ответов в рамках этого сеанса.

Что не изменяется

Докинг не выполняет следующие действия:
  • создание учётных записей каналов
  • подключение нового бота Discord, Telegram, Slack или Mattermost
  • предоставление пользователю доступа
  • обход списков разрешений каналов или политик личных сообщений
  • перенос истории переписки в другой сеанс
  • объединение сеансов не связанных между собой пользователей
Он изменяет только маршрут доставки для текущего сеанса.

Устранение неполадок

Команда сообщает, что отправитель не привязан. Добавьте текущего отправителя и целевого собеседника в одну группу session.identityLinks. Например, если отправитель Telegram 123 должен выполнить докинг к собеседнику Discord 456, укажите и telegram:123, и discord:456. Команда сообщает, что докинг доступен только из личных чатов. Отправьте команду докинга из личного чата с OpenClaw, а не из группового чата. Команда сообщает, что активный сеанс отсутствует. Выполните докинг из существующего сеанса личного чата. Команде требуется запись активного сеанса, чтобы сохранить новый маршрут. Ответы по-прежнему поступают в старый канал. Убедитесь, что команда вернула сообщение об успешном выполнении, и проверьте, что идентификатор целевого собеседника совпадает с идентификатором, используемым этим каналом. Докинг изменяет только маршрут активного сеанса; другой сеанс по-прежнему может направлять ответы в другое место. Мне нужно переключиться обратно. Отправьте соответствующую команду для исходного канала, например /dock_telegram или /dock-telegram, от привязанного отправителя.