飞书机器人接入OpenClaw：千问3.5-35B-A3B-FP8实现群聊问答自动化
飞书机器人接入OpenClaw：千问3.5-35B-A3B-FP8实现群聊问答自动化
1. 为什么选择OpenClaw+飞书+千问3.5组合？
去年我在团队内部尝试用各种工具搭建智能问答系统时，发现三个核心痛点：一是公有云API调用成本高且数据要出域，二是现有框架对多模态支持有限，三是与企业IM的深度整合需要大量开发。直到遇到OpenClaw这个本地化智能体框架，配合飞书的开放能力和千问3.5的多模态理解，终于找到了一个平衡隐私性、功能性和易用性的解决方案。
这个组合最吸引我的特点是：
- 数据不出域：所有对话记录和文件都在企业飞书和本地服务器间流转
- 多模态原生支持：千问3.5-35B-A3B-FP8能直接理解群聊中的图片内容
- 零代码配置：OpenClaw的飞书插件提供开箱即用的消息通道
实际使用一个月后，这套系统已经能自动处理我们技术群里80%的常见问答，比如报错截图诊断、代码片段解释等。下面分享从零开始的完整接入过程。
2. 环境准备与基础配置
2.1 硬件与网络要求
我的测试环境是一台Ubuntu 22.04服务器（4核CPU/16GB内存），需要注意三个关键点：
- 服务器需要固定公网IP（飞书回调要求）
- 开放18789端口（OpenClaw网关默认端口）
- 确保能稳定访问千问3.5镜像服务（内网或VPN连接）
如果使用云主机，记得在安全组放行TCP 18789端口。我在阿里云上测试时，就因为忘记这个设置导致飞书消息无法回调，排查了半小时。
2.2 OpenClaw核心组件安装
推荐使用Docker compose方式部署，避免依赖冲突：
version: '3' services: openclaw: image: registry.cn-hangzhou.aliyuncs.com/openclaw/openclaw-gateway:latest ports: - "18789:18789" volumes: - ./config:/root/.openclaw environment: - TZ=Asia/Shanghai启动后访问http://服务器IP:18789能看到OpenClaw控制台即表示成功。我第一次运行时遇到权限问题，发现是config目录没给写权限，用chmod -R 777 config解决了。
3. 飞书通道深度配置
3.1 创建企业自建应用
在飞书开放平台（https://open.feishu.cn/）的操作比想象中复杂，关键步骤有：
- 进入"开发者后台"→"企业自建应用"→"创建应用"
- 在"凭证与基础信息"页记下
App ID和App Secret - 到"事件订阅"添加
接收消息v2.0权限 - 在"安全设置"添加服务器IP白名单
最容易出错的环节是事件订阅的请求地址格式，必须是：
https://你的域名或IP:18789/feishu/event我一开始漏了/feishu/event后缀，导致飞书一直提示"回调地址验证失败"。
3.2 OpenClaw飞书插件安装
在服务器上执行：
openclaw plugins install @m1heng-clawd/feishu openclaw plugins list # 确认插件状态然后修改config/openclaw.json，增加飞书配置段：
{ "channels": { "feishu": { "enabled": true, "appId": "cli_xxxxxx", "appSecret": "xxxxxx", "encryptKey": "", "verificationToken": "", "connectionMode": "websocket" } } }特别注意：如果使用WebSocket模式（推荐），需要确保服务器能主动连接飞书WS服务。我在腾讯云上测试时发现出方向端口被限制，临时改用HTTP模式才成功。
4. 千问3.5模型对接实战
4.1 模型服务配置
假设千问3.5服务部署在内网http://192.168.1.100:8080，修改openclaw.json的模型配置：
{ "models": { "providers": { "qwen35": { "baseUrl": "http://192.168.1.100:8080/v1", "apiKey": "sk-任意字符串", "api": "openai-completions", "models": [ { "id": "qwen3.5-35b-a3b-fp8", "name": "千问3.5多模态", "contextWindow": 32768, "vision": true } ] } } } }关键参数说明：
vision: true启用多模态能力apiKey可以随意填写（本地模型通常不校验）baseUrl必须包含/v1后缀
4.2 多模态能力测试
重启服务后，在飞书群里尝试发送带图片的消息：
@机器人 请分析这张架构图 [图片]正常流程下会看到：
- OpenClaw日志显示收到图片URL
- 千问3.5服务日志显示图片下载请求
- 10-30秒后返回图文分析结果
性能提示：千问3.5处理高分辨率图片较慢，建议在飞书后台"应用设置"→"消息卡片"中开启"压缩图片"选项。
5. 典型问题排查指南
5.1 消息收不到回调
检查清单：
openclaw gateway status确认服务运行curl -X POST http://localhost:18789/feishu/event测试本地端点- 飞书后台"事件订阅"显示"验证成功"
- 服务器时间与北京时间误差在1分钟内
5.2 图片解析失败
可能原因：
- 千问3.5服务内存不足（需至少12GB空闲内存）
- 图片URL不可达（飞书图片需要配置IP白名单）
- 模型未启用vision能力
可以通过openclaw debug --task "图片URL"进行隔离测试。
6. 进阶使用技巧
6.1 定制化回复模板
在config目录新建templates/feishu.json：
{ "error": { "text": "处理失败，请稍后再试", "color": "red" }, "analyzing": { "text": "正在分析图片...", "color": "blue" } }6.2 敏感词过滤
通过skills机制添加预处理：
clawhub install content-filter然后在飞书配置中增加：
{ "skills": { "preprocess": ["content-filter"] } }获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。