Как подключить OpenClaw к Telegram-боту

Что нужно перед началом

После того как ваш OpenClaw уже работает и Telegram выбран в качестве канала связи, нужно настроить доступ агента к боту. Сделать это можно несколькими способами. В этой статье мы рассмотрим два основных варианта: через политику dmPolicy pairing и через dmPolicy allowlist. Эта инструкция подойдет тем, кто уже установил OpenClaw на сервер и завершил базовую настройку агента. Если OpenClaw у вас еще не установлен, сначала нужно выполнить его установку и запустить Gateway. Если вы только планируете развернуть OpenClaw для своих задач, но не знаете как это сделать, обратите внимание на нашу статью по установке и настройке OpenClaw.

Как работает dmPolicy в OpenClaw

Параметр dmPolicy управляет доступом к личным сообщениям Telegram-бота. Именно он определяет, кто сможет общаться с агентом через Telegram.

OpenClaw поддерживает несколько вариантов этой политики:

• pairing — стандартный режим;
• allowlist — доступ разрешен только тем Telegram ID, которые явно добавлены в список;
• open — доступ открыт всем, использовать не рекомендуется;
• disabled — доступ к боту полностью отключен.

Настройки каналов задаются в файле:

~/.openclaw/openclaw.json

В блоке channels находятся параметры, связанные с Telegram-ботом, включая токен бота и политику доступа. По умолчанию параметр dmPolicy обычно установлен в значение pairing. Это означает, что для начала работы с агентом нужно сначала подтвердить свой Telegram-аккаунт.

Подключение через dmPolicy pairing

Режим pairing — это стандартный и самый простой способ привязать Telegram-аккаунт к вашему OpenClaw. Сначала откройте Telegram-бота, которого вы создали для работы с OpenClaw, и отправьте команду:

/start

Если вы раньше еще не работали с этим ботом, он покажет сообщение, в котором будут указаны ваш Telegram ID и специальный код для подключения аккаунта к OpenClaw.

После этого нужно скопировать команду вида:

openclaw pairing approve <8-символьный-код>

Эту команду нужно выполнить в терминале на сервере, где установлен OpenClaw. Если все прошло успешно, OpenClaw вернет сообщение о том, что ваш Telegram-аккаунт подтвержден. В ответе будет указан Telegram ID, которому разрешен доступ к агенту.

После этого можно проверить работу бота: отправьте ему любое сообщение в Telegram. Если настройка выполнена правильно, агент начнет отвечать через бот.

Таким образом, режим pairing позволяет быстро подключить личный Telegram-аккаунт без ручного редактирования списка разрешенных пользователей.

Ограничение доступа через dmPolicy allowlist

Второй способ — использование политики dmPolicy allowlist. Этот вариант более безопасен, чем pairing, потому что агент будет принимать сообщения только от тех Telegram-аккаунтов, которые вы явно разрешили в конфигурации.

Для этого откройте файл openclaw.json, измените значение dmPolicy на allowlist и добавьте массив allowFrom, в котором нужно указать Telegram ID пользователей, которым разрешено взаимодействовать с ботом.

Пример логики настройки:

1. dmPolicy меняется на allowlist;
2. в allowFrom добавляются разрешенные Telegram ID;
3. ID указываются с префиксом tg.

После внесения изменений сохраните файл и перезапустите службу OpenClaw на сервере, чтобы новая конфигурация вступила в силу. Например, для перезапуска службы можно использовать команду:

sudo systemctl restart openclaw-gateway.service

После этого агент будет принимать сообщения только от указанных аккаунтов. Если потребуется, в список allowFrom можно добавить и другие Telegram ID, например чтобы открыть доступ нескольким пользователям.

Как узнать свой Telegram ID

Если вы не знаете свой Telegram ID, его можно узнать с помощью бота @userinfobot.

Для этого:

1. откройте бота в Telegram;
2. отправьте команду /start;
3. получите в ответ сообщение, в котором будет указан ваш Telegram ID.

После этого вы сможете использовать этот ID в настройках allowFrom.

Заключение

Для подключения OpenClaw к Telegram-боту можно использовать два основных подхода. Режим pairing удобен для быстрого старта и привязки одного аккаунта без ручной правки конфигурации. Режим allowlist подходит в тех случаях, когда нужен более строгий контроль доступа и вы хотите явно указать, кто именно может общаться с агентом.

Если вам нужен простой личный доступ к боту, обычно достаточно pairing. Если же бот будет использоваться в более чувствительном или рабочем сценарии, лучше сразу выбрать allowlist.

Для работы OpenClaw с Telegram-ботом удобно использовать наши дешевые VPS сервера, которые вы можете заказать здесь.