飞书通道
配置飞书（Lark）作为智能体的消息通道。
概述
飞书是字节跳动推出的企业协作平台。TPCLAW 支持通过飞书长连接方式接入，无需公网 IP 和域名，扫码即可完成绑定。
支持的功能
- 接收和发送消息
- 消息卡片和富文本消息
- 群聊和私聊消息
- 文件和图片消息
- 多账号支持
前置条件
- 拥有飞书账号
- 已部署并启动 TPCLAW 服务
飞书长连接模式无需公网 IP、无需配置域名和事件订阅，适合个人和小团队快速接入。
配置步骤
第一步：进入通道管理
点击左侧菜单「设置」→ 选择「通道管理」标签页。
在通道配置页面中找到「飞书长连接」区域，点击「+ 添加账号」按钮。
第二步：扫码绑定
弹出添加飞书账号对话框后，使用飞书手机端扫描二维码完成绑定。
二维码有有效期限制，请在有效期内完成扫码。如果二维码过期，关闭弹窗重新打开即可刷新。
扫码成功后，飞书应用中会出现 TPCLaw 机器人。
第三步：配置绑定和策略
扫码完成后，在通道管理页面可以编辑账号配置。
绑定智能体
默认情况下，飞书账号会绑定到主智能体。你也可以将不同的飞书机器人绑定到不同的智能体。
编辑账号配置
点击账号的编辑按钮，可以配置以下内容：
| 配置项 | 说明 |
|---|---|
| 账号名称 | 标识该飞书账号的名称 |
| 启用状态 | 开关控制该账号是否生效 |
| 私聊策略 | 私聊消息的接收策略（允许所有 / 仅白名单 / 禁用） |
| 群聊策略 | 群聊消息的接收策略（允许所有 / 仅白名单 / 禁用） |
| App ID | 飞书应用的应用标识（扫码后自动填充） |
| App Secret | 飞书应用密钥（留空保持原值） |
| 加载历史 | 开启后每次对话会加载历史消息作为上下文 |
| 绑定智能体 | 该飞书账号绑定的智能体 |
第四步：开始使用
配置完成后，在飞书中打开 TPCLaw 机器人即可开始对话。
消息策略说明
| 策略值 | 说明 |
|---|---|
| 允许所有 | 接收所有用户/群组的消息 |
| 仅白名单 | 仅接收白名单中的用户/群组消息 |
| 禁用 | 不处理该类型的消息 |
多账号配置
TPCLAW 支持添加多个飞书账号，每个账号可以绑定不同的智能体：
- 添加多个飞书机器人账号
- 为每个账号设置独立的私聊/群聊策略
- 将不同账号绑定到不同智能体
典型场景：
- 账号 A → 绑定「客服智能体」，仅允许群聊
- 账号 B → 绑定「代码助手智能体」，允许私聊
手动配置
如果扫码方式不可用，可以点击添加账号弹窗底部的「手动设置机器人」链接，手动填写 App ID 和 App Secret。
获取 App ID 和 App Secret
- 访问 飞书开放平台
- 创建企业自建应用
- 在应用的「凭证与基础信息」页面获取 App ID 和 App Secret
故障排查
消息未收到
- 检查账号的启用状态是否开启
- 确认消息策略配置正确（非「禁用」）
- 检查飞书应用是否正常运行
- 查看 TPCLAW 服务日志
扫码失败
- 确认二维码未过期
- 检查网络连通性
- 尝试关闭弹窗重新打开获取新二维码
消息发送失败
- 检查 App Secret 配置是否正确
- 确认飞书应用权限配置
- 查看服务日志
YAML 配置参考
除了通过控制台界面配置外，也可以直接编辑配置文件：
yaml
channels:
feishu:
enabled: true
accounts:
default:
name: "默认飞书"
enabled: true
app_id: "cli_xxxxxxxxxxxx"
app_secret: "xxxxxxxxxxxxxxxx"
encrypt_key: "" # 可选，消息加密 Key
verifier: "" # 可选，消息验证 Token
dm_policy: "allow" # 私聊策略：allow / disabled
group_policy: "allow" # 群聊策略：allow / disabled绑定配置
yaml
bindings:
- agent_id: "main"
match:
default: true
channel: "feishu"
account_id: "default"