Почему Feishu?
Feishu (飞书), известный на международном рынке как Lark, — это корпоративная платформа для совместной работы от ByteDance, широко используемая в китайских технологических компаниях, стартапах и всё чаще в Юго-Восточной Азии. С версии OpenClaw v2026.2.2 Feishu стал первым официально поддерживаемым китайским чат-клиентом платформы.
- •Публичный URL не требуется — без ngrok, без домена, без вебхук-сервера
- •Работает за файрволами — соединение исходящее с вашей машины
- •Низкая задержка — двунаправленный обмен сообщениями в реальном времени
- •Поддержка богатого контента — текст, изображения, файлы, аудио, видео и стикеры
Предварительные требования
- •OpenClaw v2026.2.2 или новее
- •Корпоративный аккаунт Feishu/Lark (бесплатный тариф подходит)
- •Доступ администратора для создания приложений на Feishu Open Platform
Шаг 1: создание приложения Feishu
- 1.Перейдите на Feishu Open Platform (или Lark Developer Console для международных тенантов)
- 2.Нажмите Create Custom App
- 3.Задайте имя приложения (например, «OpenClaw Agent») и описание
- 4.Загрузите иконку (логотип-лобстер OpenClaw отлично подходит)
- 5.Скопируйте App ID (формат:
cli_xxx) и App Secret со страницы учётных данных
Шаг 2: настройка разрешений приложения
В настройках разрешений вашего приложения включите следующие области:
| Разрешение | Назначение |
|---|---|
im:message | Отправка и получение сообщений |
im:message.group_at_msg | Получение @упоминаний в групповых чатах |
im:resource | Доступ к изображениям и файлам |
contact:user.id:readonly | Идентификация пользователей |
После добавления разрешений нажмите Publish для отправки на проверку. В большинстве корпоративных тенантов самостоятельно созданные приложения утверждаются автоматически.
Шаг 3: включение подписки на события
- 1.В настройках приложения перейдите в Event Subscriptions
- 2.Выберите WebSocket Mode (длинное соединение) — это критически важно. НЕ используйте режим вебхуков, так как он требует публичного URL.
- 3.Подпишитесь на следующие события:
Шаг 4: настройка OpenClaw
Добавьте учётные данные Feishu в конфигурацию OpenClaw. Отредактируйте ~/.openclaw/.env:
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=your_app_secret_here
Или, если используете конфигурационный файл OpenClaw (~/.openclaw/config.yaml):
channels:
feishu:
enabled: true
appId: cli_xxxxxxxxxxxxx
appSecret: your_app_secret_here
Перезапустите OpenClaw:
openclaw restart
Вы должны увидеть сообщение в логах, подтверждающее, что WebSocket-соединение с Feishu установлено.
Шаг 5: проверка соединения
Откройте Feishu и найдите ваше приложение в списке чатов (поищите по имени приложения, заданному на шаге 1). Отправьте сообщение:
> Привет!
- •Текстовые сообщения
- •Изображения (агент может их анализировать, если используется модель с поддержкой зрения)
- •Файлы (агент может читать документы)
- •Голосовые сообщения (транскрибируются и обрабатываются как текст)
Настройка групповых чатов
OpenClaw поддерживает групповые чаты Feishu с тремя режимами доступа:
| Режим | Поведение |
|---|---|
open (по умолчанию) | Любой участник группы может обратиться к боту через @упоминание |
allowlist | Только одобренные пользователи могут взаимодействовать, даже с @упоминанием |
disabled | Групповые сообщения полностью игнорируются |
Настройка в config.yaml:
channels:
feishu:
groupAccess: open # or "allowlist" or "disabled"
allowedUsers: # only used with "allowlist" mode
- user_id_1
- user_id_2
В групповых чатах агент отвечает только при @упоминании, предотвращая шум в загруженных каналах.
Потоковые ответы
OpenClaw поддерживает потоковую передачу ответов AI в Feishu с использованием интерактивных карточек. Вместо ожидания полного ответа агент отправляет начальную карточку и обновляет её в реальном времени по мере генерации текста AI. Это обеспечивает гораздо лучший пользовательский опыт для длинных ответов.
Потоковая передача включена по умолчанию. Чтобы отключить её:
channels:
feishu:
streaming: false
Поддерживаемые типы сообщений
| Направление | Поддерживаемые типы |
|---|---|
| Входящие (пользователь -> агент) | Текст, форматированный текст (post), изображения, файлы, аудио, видео, стикеры |
| Исходящие (агент -> пользователь) | Текст, изображения, файлы, аудио, интерактивные карточки |
Устранение неполадок
Ошибка «App not found»: убедитесь, что приложение опубликовано и одобрено в вашем тенанте Feishu. Самостоятельно созданные приложения в корпоративных тенантах обычно утверждаются автоматически, но некоторые организации требуют одобрения администратора.
Агент не отвечает: проверьте логи OpenClaw (openclaw logs) на наличие ошибок WebSocket-соединения. Убедитесь, что App ID и App Secret указаны правильно.
Сообщения не приходят в групповых чатах: убедитесь, что бот добавлен в группу и что пользователь правильно @упоминает бота. Проверьте настройку groupAccess.
Обрывы соединения: WebSocket-соединение переподключается автоматически. Если обрывы частые, проверьте стабильность сети или настройки файрвола.
Использование моста от сообщества (альтернатива)
Если вам нужны возможности, выходящие за рамки нативной интеграции, поддерживаемый сообществом мост feishu-openclaw от AlexAnys предлагает дополнительные возможности, такие как пользовательское форматирование сообщений и расширенное управление группами. Настройка занимает около 5 минут и не требует публичного сервера.
Полную документацию смотрите в официальном руководстве по каналу Feishu.