Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
Lark Integration — это инструмент для подключения Lark (Feishu) к OpenClaw с помощью webhook-моста, обеспечивающего двусторонний обмен сообщениями с поддержкой богатого контента.
Обзор
Интеграция позволяет использовать Lark/Feishu как полноценный канал коммуникации для AI-агентов. Решение поддерживает текстовые сообщения, расширенные посты (с изображениями и ссылками), а также работу с изображениями, обеспечивая гибкое взаимодействие между пользователем и системой. :
В основе лежит мост между webhook Lark и WebSocket-шлюзом OpenClaw, который обеспечивает передачу сообщений в обе стороны и обработку контента в реальном времени. :
Быстрый старт
# 1. Установка учетных данных
echo "FEISHU_APP_ID=cli_xxx" >> ~/.openclaw/workspace/.env
mkdir -p ~/.openclaw/secrets
echo "your_app_secret" > ~/.openclaw/secrets/feishu_app_secret
# 2. Запуск моста
cd skills/lark-integration/scripts
node bridge-webhook.mjs
# 3. Настройка webhook в Lark
# https://open.larksuite.com → Your App → Event Subscriptions
# URL: http://YOUR_SERVER_IP:3000/webhookАрхитектура
Lark App ──webhook──► Bridge (порт 3000) ──WebSocket──► OpenClaw Gateway
│ │
◄────────── Ответ ──────────────────┘Такой подход позволяет разделить обработку событий и транспорт сообщений, обеспечивая стабильную и масштабируемую интеграцию.
Поддерживаемые типы сообщений
- text — двусторонняя передача обычного текста
- post — входящие сообщения с форматированным контентом (изображения, ссылки)
- image — получение одиночных изображений
- reply — отправка ответов (включая карточки через feishu-card)
Автоопределение платформы
Интеграция автоматически определяет региональную платформу по URL:
*.larksuite.com→ международная версия*.feishu.cn→ китайская версия
Конфигурация
Переменные окружения
- FEISHU_APP_ID — ID приложения в Lark (обязательный)
- FEISHU_APP_SECRET_PATH — путь к секрету (по умолчанию ~/.openclaw/secrets/…)
- WEBHOOK_PORT — порт webhook (по умолчанию 3000)
- FEISHU_THINKING_THRESHOLD_MS — задержка перед отображением “Thinking…”
- FEISHU_ENCRYPT_KEY — ключ шифрования (если используется)
- OPENCLAW_AGENT_ID — ID агента для маршрутизации сообщений
Права приложения Lark
Для корректной работы необходимо включить соответствующие разрешения в консоли разработчика Lark:
- im:message — отправка и получение сообщений
- im:message:send_as_bot — отправка сообщений от имени бота
- im:resource — доступ к ресурсам сообщений (изображения)
Дополнительные возможности
Интеграция поддерживает работу с документами Lark (документы, wiki, таблицы, bitable), а также обработку изображений с преобразованием в base64 для передачи через шлюз. :
В групповых чатах можно настроить поведение бота — например, отвечать только при упоминании или наличии ключевых слов, что снижает уровень шума и повышает релевантность ответов. :
Когда использовать
- Подключение Lark/Feishu как канала общения для AI-агента
- Обработка сообщений с изображениями и форматированным контентом
- Отправка ответов пользователям прямо в Lark
- Работа с документами и данными внутри экосистемы Lark
- Отладка и настройка интеграции сообщений
Благодаря простоте настройки и широким возможностям, Lark Integration становится удобным инструментом для построения коммуникации между пользователями и AI-системами.
Файл из источника