onebots

简体中文

English

简体中文

English

主题

飞书/Lark 适配器配置 ​

飞书适配器配置说明，同时支持飞书（国内版）和 Lark（国际版）。

配置项 ​

app_id ​

  • 类型: string
  • 必填: ✅
  • 说明: 飞书/Lark 应用 App ID

app_secret ​

  • 类型: string
  • 必填: ✅
  • 说明: 飞书/Lark 应用 App Secret

encrypt_key ​

  • 类型: string
  • 必填: ❌
  • 说明: 事件加密密钥（启用加密模式时必填）

verification_token ​

  • 类型: string
  • 必填: ❌
  • 说明: 事件验证 Token

endpoint ​

  • 类型: string
  • 必填: ❌
  • 默认值: https://open.feishu.cn/open-apis
  • 说明: API 端点地址，用于切换飞书/Lark 或私有化部署
端点URL说明
飞书（默认）https://open.feishu.cn/open-apis国内版
Larkhttps://open.larksuite.com/open-apis国际版

配置示例 ​

飞书（国内版） ​

yaml
feishu.my_bot:
  app_id: 'cli_xxxxxxxxxxxxx'
  app_secret: 'your_app_secret'
  encrypt_key: 'your_encrypt_key'  # 可选
  verification_token: 'your_verification_token'  # 可选
  # endpoint 可省略，默认为飞书国内版

Lark（国际版） ​

yaml
feishu.lark_bot:
  app_id: 'cli_xxxxxxxxxxxxx'
  app_secret: 'your_app_secret'
  endpoint: 'https://open.larksuite.com/open-apis'  # Lark 端点

TypeScript 配置 ​

typescript
import { FeishuEndpoint } from '@onebots/adapter-feishu';

// Lark（国际版）
{
  account_id: 'lark_bot',
  app_id: 'cli_xxx',
  app_secret: 'xxx',
  endpoint: FeishuEndpoint.LARK,
}

获取应用凭证 ​

飞书（国内版） ​

  1. 访问 飞书开放平台
  2. 创建企业自建应用
  3. 在"应用信息"中获取 App ID 和 App Secret
  4. 在"事件订阅"中配置 Webhook URL：http://your-server:port/feishu/{account_id}/webhook
  5. 获取 Encrypt Key 和 Verification Token（如果启用加密）
  6. 配置应用权限（消息收发、通讯录等）

Lark（国际版） ​

  1. 访问 Lark Developer
  2. 创建应用并获取凭证
  3. 配置方式与飞书相同

Webhook 地址 ​

配置事件订阅 URL 为：

http://your-domain:port/feishu/{account_id}/webhook

例如：

http://bot.example.com:6727/feishu/my_bot/webhook

相关链接 ​