Бот Feishu

Feishu (Lark) — это корпоративная платформа командного чата, используемая компаниями для обмена сообщениями и совместной работы. Этот плагин подключает OpenClaw к боту Feishu/Lark с использованием подписки на события WebSocket платформы, благодаря чему сообщения могут приниматься без публикации публичного URL вебхука.

Требуется плагин

Установите плагин Feishu:

openclaw plugins install @openclaw/feishu

Локальная установка (при запуске из git-репозитория):

openclaw plugins install ./extensions/feishu

Быстрый старт

Существует два способа добавить канал Feishu:

Метод 1: мастер онбординга (рекомендуется)

Если вы только что установили OpenClaw, запустите мастер:

openclaw onboard

Мастер проведёт вас через следующие шаги:

Создание приложения Feishu и сбор учётных данных
Настройка учётных данных приложения в OpenClaw
Запуск Gateway (шлюза)

✅ После настройки проверьте статус Gateway (шлюза):

openclaw gateway status
openclaw logs --follow

Метод 2: настройка через CLI

Если вы уже завершили начальную установку, добавьте канал через CLI:

openclaw channels add

Выберите Feishu, затем введите App ID и App Secret. ✅ После настройки управляйте Gateway (шлюзом):

openclaw gateway status
openclaw gateway restart
openclaw logs --follow

Шаг 1: Создание приложения Feishu

1. Откройте Feishu Open Platform

Перейдите на Feishu Open Platform и войдите в систему. Арендаторы Lark (глобальная версия) должны использовать https://open.larksuite.com/app и установить domain: "lark" в конфигурации Feishu.

2. Создайте приложение

Нажмите Create enterprise app
Заполните название и описание приложения
Выберите иконку приложения

3. Скопируйте учётные данные

В разделе Credentials & Basic Info скопируйте:

App ID (формат: cli_xxx)
App Secret

❗ Важно: храните App Secret в тайне. Get credentials

4. Настройте разрешения

В разделе Permissions нажмите Batch import и вставьте:

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

5. Включите возможность бота

В App Capability > Bot:

Включите возможность бота
Задайте имя бота

6. Настройте подписку на события

⚠️ Важно: перед настройкой подписки на события убедитесь, что:

Вы уже выполнили openclaw channels add для Feishu
Gateway (шлюз) запущен (openclaw gateway status)

В разделе Event Subscription:

Выберите Use long connection to receive events (WebSocket)
Добавьте событие: im.message.receive_v1

⚠️ Если Gateway (шлюз) не запущен, настройка долгого соединения может не сохраниться. Configure event subscription

7. Опубликуйте приложение

Создайте версию в Version Management & Release
Отправьте на проверку и опубликуйте
Дождитесь одобрения администратора (корпоративные приложения обычно одобряются автоматически)

Шаг 2: Настройка OpenClaw

Настройка с помощью мастера (рекомендуется)

openclaw channels add

Выберите Feishu и вставьте ваши App ID и App Secret.

Настройка через конфигурационный файл

Отредактируйте ~/.openclaw/openclaw.json:

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "My AI assistant",
        },
      },
    },
  },
}

Настройка через переменные окружения

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

Домен Lark (глобальная версия)

Если ваш арендатор использует Lark (международная версия), установите домен lark (или полную строку домена). Это можно задать в channels.feishu.domain или для каждой учётной записи отдельно (channels.feishu.accounts.<id>.domain).

{
  channels: {
    feishu: {
      domain: "lark",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
        },
      },
    },
  },
}

Шаг 3: Запуск и тестирование

1. Запустите Gateway (шлюз)

openclaw gateway

2. Отправьте тестовое сообщение

В Feishu найдите вашего бота и отправьте сообщение.

3. Подтвердите сопряжение

По умолчанию бот отвечает кодом сопряжения. Подтвердите его:

openclaw pairing approve feishu <CODE>

После подтверждения вы можете общаться в обычном режиме.

Обзор

Канал бота Feishu: бот Feishu, управляемый Gateway (шлюзом)
Детерминированная маршрутизация: ответы всегда возвращаются в Feishu
Изоляция сеансов: личные сообщения используют основной сеанс; группы изолированы
WebSocket‑подключение: длительное соединение через SDK Feishu, публичный URL не требуется

Контроль доступа

Прямые сообщения

По умолчанию: dmPolicy: "pairing" (неизвестные пользователи получают код сопряжения)

Подтверждение сопряжения:

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

Режим списка разрешённых: установите channels.feishu.allowFrom со списком разрешённых Open ID

Групповые чаты

1. Политика групп (channels.feishu.groupPolicy):

"open" = разрешить всем в группах (по умолчанию)
"allowlist" = разрешить только groupAllowFrom
"disabled" = отключить групповые сообщения

2. Требование упоминания (channels.feishu.groups.<chat_id>.requireMention):

true = требовать @упоминание (по умолчанию)
false = отвечать без упоминаний

Примеры конфигурации групп

Разрешить все группы, требовать @упоминание (по умолчанию)

{
  channels: {
    feishu: {
      groupPolicy: "open",
      // Default requireMention: true
    },
  },
}

Разрешить все группы, без требования @упоминания

{
  channels: {
    feishu: {
      groups: {
        oc_xxx: { requireMention: false },
      },
    },
  },
}

Разрешить только определённых пользователей в группах

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["ou_xxx", "ou_yyy"],
    },
  },
}

Получение ID групп и пользователей

ID групп (chat_id)

ID групп выглядят как oc_xxx. Метод 1 (рекомендуется)

Запустите Gateway (шлюз) и @упомяните бота в группе
Выполните openclaw logs --follow и найдите chat_id

Метод 2 Используйте отладчик API Feishu для получения списка групповых чатов.

ID пользователей (open_id)

ID пользователей выглядят как ou_xxx. Метод 1 (рекомендуется)

Запустить шлюз и БМ бота
Выполните openclaw logs --follow и найдите open_id

Метод 2 Проверьте запросы на сопряжение для получения Open ID пользователей:

openclaw pairing list feishu

Часто используемые команды

Команда	Описание
`/status`	Показать статус бота
`/reset`	Сбросить сеанс
`/model`	Показать/сменить модель

Примечание: Feishu пока не поддерживает нативные меню команд, поэтому команды необходимо отправлять текстом.

Команды управления Gateway (шлюзом)

Команда	Описание
`openclaw gateway status`	Показать статус Gateway (шлюза)
`openclaw gateway install`	Установить/запустить сервис Gateway
`openclaw gateway stop`	Остановить сервис Gateway
`openclaw gateway restart`	Перезапустить сервис Gateway
`openclaw logs --follow`	Просмотр логов Gateway

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

Бот не отвечает в групповых чатах

Убедитесь, что бот добавлен в группу
Убедитесь, что вы @упоминаете бота (поведение по умолчанию)
Проверьте, что groupPolicy не установлен в "disabled"
Проверьте логи: openclaw logs --follow

Бот не получает сообщения

Убедитесь, что приложение опубликовано и одобрено
Убедитесь, что подписка на события включает im.message.receive_v1
Убедитесь, что включено долгое соединение
Убедитесь, что разрешения приложения настроены полностью
Убедитесь, что Gateway (шлюз) запущен: openclaw gateway status
Проверьте логи: openclaw logs --follow

Утечка App Secret

Сбросьте App Secret в Feishu Open Platform
Обновите App Secret в вашей конфигурации
Перезапустите Gateway (шлюз)

Ошибки отправки сообщений

Убедитесь, что у приложения есть разрешение im:message:send_as_bot
Убедитесь, что приложение опубликовано
Проверьте логи для получения подробных ошибок

Расширенная конфигурация

Несколько учётных записей

{
  channels: {
    feishu: {
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "Primary bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          botName: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

Ограничения сообщений

textChunkLimit: размер чанка исходящего текста (по умолчанию: 2000 символов)
mediaMaxMb: лимит загрузки/скачивания медиа (по умолчанию: 30 МБ)

Вещание

Feishu поддерживает потоковые ответы через интерактивные карточки. При включении бот обновляет карточку по мере генерации текста.

{
  channels: {
    feishu: {
      streaming: true, // enable streaming card output (default true)
      blockStreaming: true, // enable block-level streaming (default true)
    },
  },
}

Установите streaming: false, чтобы дождаться полного ответа перед отправкой.

Маршрутизация нескольких агентов

Используйте bindings для маршрутизации личных сообщений Feishu или групп к разным агентам.

{
  agents: {
    list: [
      { id: "main" },
      {
        id: "clawd-fan",
        workspace: "/home/user/clawd-fan",
        agentDir: "/home/user/.openclaw/agents/clawd-fan/agent",
      },
      {
        id: "clawd-xi",
        workspace: "/home/user/clawd-xi",
        agentDir: "/home/user/.openclaw/agents/clawd-xi/agent",
      },
    ],
  },
  bindings: [
    {
      agentId: "main",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "clawd-fan",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_yyy" },
      },
    },
    {
      agentId: "clawd-xi",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

Поля маршрутизации:

match.channel: "feishu"
match.peer.kind: “direct” или “group”
match.peer.id: Open ID пользователя (ou_xxx) или ID группы (oc_xxx)

См. Получение ID групп и пользователей для советов по поиску.

Справочник конфигурации

Полная конфигурация: Конфигурация Gateway Ключевые параметры:

Параметр	Описание	По умолчанию
`channels.feishu.enabled`	Включить/отключить канал	`true`
`channels.feishu.domain`	Домен API (`feishu` или `lark`)	`feishu`
`channels.feishu.accounts.<id>.appId`	App ID	-
`channels.feishu.accounts.<id>.appSecret`	App Secret	-
`channels.feishu.accounts.<id>.domain`	Переопределение домена API для учётной записи	`feishu`
`channels.feishu.dmPolicy`	Политика ТМ	`pairing`
`channels.feishu.allowFrom`	Список разрешённых для ЛС (open_id)	-
`channels.feishu.groupPolicy`	Политика групп	`open`
`channels.feishu.groupAllowFrom`	Список разрешённых групп	-
`channels.feishu.groups.<chat_id>.requireMention`	Требовать @упоминание	`true`
`channels.feishu.groups.<chat_id>.enabled`	Включить группы	`true`
`channels.feishu.textChunkLimit`	Размер чанка сообщения	`2000`
`channels.feishu.mediaMaxMb`	Лимит размера медиа	`30`
`channels.feishu.streaming`	Включить вывод потоковых карточек	`true`
`channels.feishu.blockStreaming`	Включить block streaming	`true`

Справочник dmPolicy

Значение	Поведение
`"pairing"`	По умолчанию. Неизвестные пользователи получают код сопряжения; требуется подтверждение
`"allowlist"`	Общаться могут только пользователи из `allowFrom`
`"open"`	Разрешить всех пользователей (требуется `"*"` в allowFrom)
`"disabled"`	Отключить ЛС

Поддерживаемые типы сообщений

Получить

✅ Текст
✅ Форматированный текст (post)
✅ Изображения
✅ Файлы
✅ Аудио
✅ Видео
✅ Стикеры

Отправка

✅ Текст
✅ Изображения
✅ Файлы
✅ Аудио
⚠️ Форматированный текст (частичная поддержка)

Обзор

Платформы обмена сообщениями

Конфигурация

​Бот Feishu

​Требуется плагин

​Быстрый старт

​Метод 1: мастер онбординга (рекомендуется)

​Метод 2: настройка через CLI

​Шаг 1: Создание приложения Feishu

​1. Откройте Feishu Open Platform

​2. Создайте приложение

​3. Скопируйте учётные данные

​4. Настройте разрешения

​5. Включите возможность бота

​6. Настройте подписку на события

​7. Опубликуйте приложение

​Шаг 2: Настройка OpenClaw

​Настройка с помощью мастера (рекомендуется)

​Настройка через конфигурационный файл

​Настройка через переменные окружения

​Домен Lark (глобальная версия)

​Шаг 3: Запуск и тестирование

​1. Запустите Gateway (шлюз)

​2. Отправьте тестовое сообщение

​3. Подтвердите сопряжение

​Обзор

​Контроль доступа

​Прямые сообщения

​Групповые чаты

​Примеры конфигурации групп

​Разрешить все группы, требовать @упоминание (по умолчанию)

​Разрешить все группы, без требования @упоминания

​Разрешить только определённых пользователей в группах

​Получение ID групп и пользователей

​ID групп (chat_id)

​ID пользователей (open_id)

​Часто используемые команды

​Команды управления Gateway (шлюзом)

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

​Бот не отвечает в групповых чатах

​Бот не получает сообщения

​Утечка App Secret

​Ошибки отправки сообщений

​Расширенная конфигурация

​Несколько учётных записей

​Ограничения сообщений

​Вещание

​Маршрутизация нескольких агентов

​Справочник конфигурации

​Справочник dmPolicy

​Поддерживаемые типы сообщений

​Получить

​Отправка

Бот Feishu

Требуется плагин

Быстрый старт

Метод 1: мастер онбординга (рекомендуется)

Метод 2: настройка через CLI

Шаг 1: Создание приложения Feishu

1. Откройте Feishu Open Platform

2. Создайте приложение

3. Скопируйте учётные данные

4. Настройте разрешения

5. Включите возможность бота

6. Настройте подписку на события

7. Опубликуйте приложение

Шаг 2: Настройка OpenClaw

Настройка с помощью мастера (рекомендуется)

Настройка через конфигурационный файл

Настройка через переменные окружения

Домен Lark (глобальная версия)

Шаг 3: Запуск и тестирование

1. Запустите Gateway (шлюз)

2. Отправьте тестовое сообщение

3. Подтвердите сопряжение

Обзор

Контроль доступа

Прямые сообщения

Групповые чаты

Примеры конфигурации групп

Разрешить все группы, требовать @упоминание (по умолчанию)

Разрешить все группы, без требования @упоминания

Разрешить только определённых пользователей в группах

Получение ID групп и пользователей

ID групп (chat_id)

ID пользователей (open_id)

Часто используемые команды

Команды управления Gateway (шлюзом)

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

Бот не отвечает в групповых чатах

Бот не получает сообщения

Утечка App Secret

Ошибки отправки сообщений

Расширенная конфигурация

Несколько учётных записей

Ограничения сообщений

Вещание

Маршрутизация нескольких агентов

Справочник конфигурации

Справочник dmPolicy

Поддерживаемые типы сообщений

Получить

Отправка