前置条件
- 一个飞书企业版或旗舰版账号（拥有管理员权限）
- 知小秘 服务已部署运行（HTTP 端口
4096） - 服务器公网可访问（用于飞书回调）
配置步骤
步骤 2
启用机器人功能
在应用管理页面左侧菜单中，找到"应用功能" → "机器人"，点击"启用"按钮。
这样飞书用户就可以搜索到该机器人并与之对话。
步骤 3
配置权限
在左侧菜单中，找到"安全设置" → "权限管理"，添加以下权限：
im:message— 发送和接收消息im:chat— 获取群组信息contact:user.base— 获取用户基本信息
添加完成后，点击"发布"按钮提交审核，审核通过后应用上线。
步骤 4
获取凭证信息
在左侧菜单"凭证与基础信息"中，获取以下信息：
- App ID — 应用的唯一标识
- App Secret — 应用的密钥，用于 API 调用签名
⚠️ 注意：App Secret 请妥善保管，不要泄露给他人。
步骤 5
配置事件回调
在左侧菜单"事件与回调"中，配置"回调地址"：
http://your-server-domain:4096/feishu/event将 your-server-domain 替换为 知小秘 服务器的公网域名或 IP 地址。
添加以下事件订阅：
im.message.receive_v1— 接收用户消息
步骤 6
配置 知小秘 飞书插件
在 知小秘 服务器上，编辑飞书插件配置文件（通常位于 /opt/opencode/source/.opencode/feishu.json）：
{
"appId": "你的 App ID",
"appSecret": "你的 App Secret",
"port": 4096,
"botName": "知小秘",
"domain": "your-server-domain"
}配置完成后，重启飞书插件服务：
systemctl restart opencode-feishu步骤 7
验证集成
在飞书中搜索你创建的机器人，发送消息测试：
- 发送"列出技能" — 查看可用的 AI 技能列表
- 发送"生成一个公司主页" — 测试页面生成功能
- 发送"帮我写代码" — 测试编码功能
如果机器人正常回复，说明集成成功。
常见问题
机器人收不到消息
检查以下配置：
- 事件回调地址是否正确且公网可访问
- 服务是否已重启（
systemctl restart opencode-feishu） - 飞书应用是否已发布上线
消息发送失败
检查权限配置是否完整，确保 im:message 权限已添加并发布。
回调地址验证失败
飞书开发者后台会发送一个验证请求到回调地址，知小秘 飞书插件会自动处理。如果验证失败，请检查端口是否开放。