​

Бот Feishu

​

Вбудований плагін

openclaw plugins install @openclaw/feishu

​

Швидкий старт

​

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

openclaw onboard

1. Створення застосунку Feishu і збір облікових даних
2. Налаштування облікових даних застосунку в OpenClaw
3. Запуск gateway

• openclaw gateway status
• openclaw logs --follow

​

Метод 2: налаштування через CLI

openclaw channels add

• openclaw gateway status
• openclaw gateway restart
• openclaw logs --follow

​

Крок 1: Створіть застосунок Feishu

​

1. Відкрийте платформу Feishu Open Platform

​

2. Створіть застосунок

1. Натисніть Create enterprise app
2. Заповніть назву й опис застосунку
3. Виберіть піктограму застосунку

​

3. Скопіюйте облікові дані

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

​

4. Налаштуйте дозволи

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card: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. Увімкніть можливість бота

1. Увімкніть можливість бота
2. Установіть ім’я бота

​

6. Налаштуйте підписку на події

1. Ви вже виконали openclaw channels add для Feishu
2. Gateway запущено (openclaw gateway status)

1. Виберіть Use long connection to receive events (WebSocket)
2. Додайте подію: im.message.receive_v1
3. (Необов’язково) Для робочих процесів із коментарями Drive також додайте: drive.notice.comment_add_v1

​

7. Опублікуйте застосунок

1. Створіть версію в Version Management & Release
2. Надішліть на перевірку та опублікуйте
3. Дочекайтеся схвалення адміністратора (застосунки підприємства зазвичай схвалюються автоматично)

​

Крок 2: Налаштуйте OpenClaw

​

Налаштування за допомогою майстра (рекомендовано)

openclaw channels add

​

Налаштування через файл конфігурації

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

​

Verification Token і Encrypt Key (режим webhook)

1. У Feishu Open Platform відкрийте свій застосунок
2. Перейдіть до Development → Events & Callbacks (开发配置 → 事件与回调)
3. Відкрийте вкладку Encryption (加密策略)
4. Скопіюйте Verification Token і Encrypt Key

​

Налаштування через змінні середовища

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

​

Домен Lark (глобальний)

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

​

Прапорці оптимізації квот

• typingIndicator (за замовчуванням true): якщо false, пропускаються виклики реакції набору тексту.
• resolveSenderNames (за замовчуванням true): якщо false, пропускаються виклики пошуку профілю відправника.

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          typingIndicator: true,
          resolveSenderNames: false,
        },
      },
    },
  },
}

​

Крок 3: Запуск і тестування

​

1. Запустіть gateway

openclaw gateway

​

2. Надішліть тестове повідомлення

​

3. Схваліть pairing

openclaw pairing approve feishu <CODE>

​

Огляд

• Канал бота Feishu: бот Feishu, керований gateway
• Детермінована маршрутизація: відповіді завжди повертаються до Feishu
• Ізоляція сесій: особисті повідомлення використовують спільну основну сесію; групи ізольовані
• Підключення WebSocket: довге з’єднання через SDK Feishu, без потреби в публічному URL

​

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

​

Особисті повідомлення

• За замовчуванням: dmPolicy: "pairing" (невідомі користувачі отримують код pairing)
• Схвалити pairing:
  openclaw pairing list feishu
  openclaw pairing approve feishu <CODE>
  
• Режим allowlist: установіть channels.feishu.allowFrom із дозволеними Open ID

​

Групові чати

• "open" = дозволити всім у групах
• "allowlist" = дозволити лише groupAllowFrom
• "disabled" = вимкнути групові повідомлення

• явне true = вимагати @mention
• явне false = відповідати без згадок
• якщо не задано й groupPolicy: "open" = за замовчуванням false
• якщо не задано й groupPolicy не дорівнює "open" = за замовчуванням true

​

Приклади конфігурації груп

​

Дозволити всі групи, @mention не потрібен (за замовчуванням для відкритих груп)

{
  channels: {
    feishu: {
      groupPolicy: "open",
    },
  },
}

​

Дозволити всі групи, але все одно вимагати @mention

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

​

Дозволити лише певні групи

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Feishu group IDs (chat_id) look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

​

Обмежити, які відправники можуть писати в групі (allowlist відправників)

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Feishu user IDs (open_id) look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Отримання ID групи/користувача

​

ID групи (chat_id)

1. Запустіть gateway і зробіть @mention бота в групі
2. Виконайте openclaw logs --follow і знайдіть chat_id

​

ID користувача (open_id)

1. Запустіть gateway і надішліть боту особисте повідомлення
2. Виконайте openclaw logs --follow і знайдіть open_id

openclaw pairing list feishu

​

Поширені команди

Примітка: Feishu ще не підтримує власні меню команд, тому команди потрібно надсилати як текст.

​

Команди керування gateway

​

Усунення несправностей

​

Бот не відповідає в групових чатах

1. Переконайтеся, що бота додано до групи
2. Переконайтеся, що ви використовуєте @mention бота (поведінка за замовчуванням)
3. Перевірте, що groupPolicy не встановлено в "disabled"
4. Перевірте журнали: openclaw logs --follow

​

Бот не отримує повідомлення

1. Переконайтеся, що застосунок опубліковано й схвалено
2. Переконайтеся, що підписка на події містить im.message.receive_v1
3. Переконайтеся, що long connection увімкнено
4. Переконайтеся, що дозволи застосунку повні
5. Переконайтеся, що gateway запущено: openclaw gateway status
6. Перевірте журнали: openclaw logs --follow

​

Витік App Secret

1. Скиньте App Secret у Feishu Open Platform
2. Оновіть App Secret у своїй конфігурації
3. Перезапустіть gateway

​

Збої під час надсилання повідомлень

1. Переконайтеся, що застосунок має дозвіл im:message:send_as_bot
2. Переконайтеся, що застосунок опубліковано
3. Перевірте журнали для детальних помилок

​

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

​

Кілька облікових записів

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

​

Обмеження повідомлень

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

​

Потокова передача

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

​

Сесії ACP

• особистих повідомлень
• розмов у темах груп

​

Постійні прив’язки ACP

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "direct", id: "ou_1234567890" },
      },
    },
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "group", id: "oc_group_chat:topic:om_topic_root" },
      },
      acp: { label: "codex-feishu-topic" },
    },
  ],
}

​

Прив’язаний до потоку запуск ACP із чату

/acp spawn codex --thread here

• --thread here працює для особистих повідомлень і тем Feishu.
• Подальші повідомлення в прив’язаному особистому повідомленні/темі напряму маршрутизуються до цієї сесії ACP.
• У v1 це не націлено на звичайні групові чати без тем.

​

Маршрутизація між кількома агентами

{
  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)

​

Довідник із конфігурації

​

Довідник dmPolicy

​

Підтримувані типи повідомлень

​

Отримання

• ✅ Текст
• ✅ Форматований текст (post)
• ✅ Зображення
• ✅ Файли
• ✅ Аудіо
• ✅ Відео/медіа
• ✅ Стікери

​

Надсилання

• ✅ Текст
• ✅ Зображення
• ✅ Файли
• ✅ Аудіо
• ✅ Відео/медіа
• ✅ Інтерактивні картки
• ⚠️ Форматований текст (форматування у стилі post і картки, але не довільні можливості авторингу Feishu)

​

Потоки та відповіді

• ✅ Вбудовані відповіді
• ✅ Відповіді в потоках тем, де Feishu надає reply_in_thread
• ✅ Відповіді з медіа залишаються прив’язаними до потоку під час відповіді на повідомлення потоку/теми

​

Коментарі Drive

• Підпишіться на drive.notice.comment_add_v1 у налаштуваннях підписки на події вашого застосунку Feishu (разом із уже наявним im.message.receive_v1)
• Інструмент Drive увімкнено за замовчуванням; вимкнути можна через channels.feishu.tools.drive: false

• текст коментаря та відправника
• метадані документа (назва, тип, URL)
• контекст потоку коментарів для відповідей у потоці

​

Поверхня дій runtime

• send
• read
• edit
• thread-reply
• pin
• list-pins
• unpin
• member-info
• channel-info
• channel-list
• react і reactions, коли реакції увімкнено в конфігурації
• дії коментарів feishu_drive: list_comments, list_comment_replies, add_comment, reply_comment

​

Пов’язане

• Огляд каналів — усі підтримувані канали
• Pairing — автентифікація особистих повідомлень і процес pairing
• Групи — поведінка групових чатів і вимога згадки
• Маршрутизація каналів — маршрутизація сесій для повідомлень
• Безпека — модель доступу та посилення захисту