Пример
Алиса может отправлять сообщения OpenClaw в Telegram и Discord:
Сеанс не создаётся заново. История переписки остаётся привязанной к тому же
сеансу.
Зачем это использовать
Используйте докинг, когда задача начинается в одном приложении для общения, но следующие ответы должны поступать в другое. Типичный сценарий:- Запустите задачу агента из Telegram.
- Перейдите в Discord, где вы координируете работу.
- Отправьте
/dock_discordиз личного чата Telegram. - Продолжайте использовать тот же сеанс 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, от привязанного отправителя.