检查配置是否正确加载
openclaw config get channels.feishu
### 9.1.12 配置参考
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| `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.dmPolicy` | 私聊策略 | `pairing` |
| `channels.feishu.allowFrom` | 私聊白名单(open_id 列表) | - |
| `channels.feishu.groupPolicy` | 群组策略 | `open` |
| `channels.feishu.groupAllowFrom` | 群组白名单 | - |
| `channels.feishu.groups.<chat_id>.requireMention` | 是否需要 @提及 | `true` |
| `channels.feishu.textChunkLimit` | 消息分块大小 | `2000` |
| `channels.feishu.mediaMaxMb` | 媒体大小限制 | `30` |
| `channels.feishu.streaming` | 启用流式卡片输出 | `true` |
| `channels.feishu.blockStreaming` | 启用块级流式 | `true` |
#### dmPolicy 策略说明
| 值 | 行为 |
|----|------|
| `"pairing"` | **默认**。未知用户收到配对码,管理员批准后才能对话 |
| `"allowlist"` | 仅 `allowFrom` 列表中的用户可对话,其他静默忽略 |
| `"open"` | 允许所有人对话(需在 allowFrom 中加 `"*"`) |
| `"disabled"` | 完全禁止私聊 |
### 9.1.13 支持的消息类型
#### 接收
- ✅ 文本消息
- ✅ 图片
- ✅ 文件
- ✅ 音频
- ✅ 视频
- ✅ 表情包
#### 发布送
- ✅ 文本消息
- ✅ 图片
- ✅ 文件
- ✅ 音频
- ⚠️ 富文本(部分支持)
### 9.1.14 与飞书生态集成
**集成飞书文档**
功能:
- 创建文档
- 编辑文档
- 分分享文档
- 权限管理
示例:
你:把这段内内容保存到飞书文档
OpenClaw:已保存到飞书文档 ✅
链接:https://...
**集成飞书多维表格**
功能:
- 创建表格
- 添加数据
- 查询数据
- 数据分析
示例:
你:把发布票信息添加到多维表格
OpenClaw:已添加3条记附录 ✅
**集成飞书日历**
功能:
- 创建日程
- 修改日程
- 删除日程
- 日程提醒
示例:
你:明天下午3点开会
OpenClaw:已添加到飞书日历 ✅
---
### 9.1.15 实战案例:配置双机器人
> 💡 **真实案例**:本节展示一个实际的双机器人配置案例,适用于需要分离不同功能或团队的场景。
#### 场景说明
某团队需要两个飞书机器人:
- **机器人1**:用于日常怎么办公和通用任务
- **机器人2**:用于特定项目或测试环境
#### 完整配置步骤
**1. 在飞书开放平台创建两个应用**
分别创建两个企业自建应用,获取:
- 机器人1:App ID `cli_xxxxxxxxxxxxxxxx`,App Secret
- 机器人2:App ID `cli_yyyyyyyyyyyyyyyy`,App Secret
**2. 配置 OpenClaw**
编辑 `~/.openclaw/openclaw.json`:
```json
{
"meta": {
"lastTouchedVersion": "2026.2.6-3",
"lastTouchedAt": "2026-02-08T09:49:58.322Z"
},
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"bot1": {
"appId": "cli_xxxxxxxxxxxxxxxx",
"appSecret": "your-app-secret-1",
"botName": "OpenClaw助手1",
"enabled": true
},
"bot2": {
"appId": "cli_yyyyyyyyyyyyyyyy",
"appSecret": "your-app-secret-2",
"botName": "OpenClaw助手2",
"enabled": true
}
},
"domain": "feishu",
"groupPolicy": "open",
"connectionMode": "websocket",
"requireMention": true,
"renderMode": "auto",
"streaming": true,
"blockStreaming": true,
"replyToMode": "all"
}
},
"gateway": {
"port": 18789,
"mode": "local",
"bind": "lan",
"auth": {
"mode": "token",
"token": "your-secure-random-token-here"
}
},
"agents": {
"defaults": {
"model": {
"primary": "your-model-provider/your-model"
},
"workspace": "/path/to/your/workspace",
"compaction": {
"mode": "safeguard"
},
"maxConcurrent": 4
}
},
"plugins": {
"entries": {
"feishu": {
"enabled": true
}
}
}
}3. 配置飞书应用权限
为两个应用分别配置权限(批量导入 JSON,参见 9.1.3 节)。
4. 配置事件订阅
为两个应用分别配置:
- 选择 使用长连接接收事件
- 添加事件:
im.message.receive_v1
5. 启动网关
bash