飞书机器人接入文心AI自动回复实战指南
飞书机器人集成文心一言实现自动回复,关键在于打通三个核心链路:消息触发、大模型调用、结果回传。若任意环节断裂,自动回复即失效。务必确认机器人收到消息后能调用文心一言生成内容,并原路返回。
获取文心一言API密钥及权限
进入百度智能云控制台,在“文心一言”服务页面点击「应用管理」新建应用。应用名称可自定义(如“飞书客服助手”),填写用途描述,场景建议选择“智能客服”或“办公辅助”。提交后等待审核——未通过前无法获取有效API Key。审核通常1~3个工作日,状态变为“已上线”后,在应用详情页复制保存 API Key 和 Secret Key。注意密钥仅此可见,丢失需重新申请。
若使用飞书内置的“文心一言(内置)”节点(如n8n或飞书流程模板),则可跳过此步,系统自动处理鉴权。
配置飞书机器人并开启消息事件
登录飞书开放平台,进入「开发者后台」→「应用管理」,创建「自建应用」,类型选择「机器人」。填写名称与简介后保存,前往「凭证与基础信息」页面,记录 App ID 和 App Secret。
核心操作在「事件订阅」页面:开启「接收消息」事件,填写服务器URL(自建服务)或留空(无代码平台)。点击生成 Verification Token 和 Encrypt Key,务必复制保存——这是飞书验证请求合法性的唯一凭据。
在「机器人设置」页面,将机器人添加至目标群组,或设为“可被所有人@”。否则消息无法送达机器人,后续流程无效。
选择集成方案完成对接
以下提供三种常用方案,按需选择。
方法一:飞书流程模板(零代码,适合新手)
进入飞书管理后台→「流程中心」→「新建流程」,搜索并使用模板“机器人收到消息后自动回复”。选择数据源(如“通用文本”),进入编辑页,将「文心一言(内置)」节点拖拽至流程中,置于「飞书消息触发」之后、「飞书发送消息」之前。双击节点,在提示词框输入指令,例如:“你是一个专业客服,请用简洁中文回答用户问题,不解释原理,直接给出结论。”保存并启用流程即可。
方法二:通过n8n搭建自动化链路(需部署服务)
安装n8n并新建Workflow。添加「Feishu: Webhook」节点,填入飞书事件订阅页的URL作为Webhook地址。添加「HTTP Request」节点:Method选POST,URL填文心一言API地址(https://aip.baidubce.com/rpc/2.0/ernie/bot/chat),Headers添加Content-Type: application/json和Authorization: Bearer {access_token}。关键在Body中构造JSON,messages字段需包含用户原始消息,格式如[{"role":"user","content":"{{ $json.body.event.text }}"}]。最后将「HTTP Request」输出的response.content映射到「Feishu: Send Message」节点的message字段,目标设为“@消息来源用户”。
方法三:本地运行OpenClaw框架(适合语义理解进阶场景)
终端执行 sudo npm install -g @qingchencloud/openclaw-zh@latest 安装框架。编辑 ~/.openclaw/openclaw.json,在 channels.feishu 区块填写飞书App ID、App Secret、Verification Token和Encrypt Key;在 models.ernie 区块填写文心一言的API Key和Secret Key。启动服务:openclaw --channel feishu。终端显示“Feishu channel connected”即表示连接成功。
三种方案任选其一,核心均在于串联消息触发、模型调用、结果回传三段链路。完成后即可在飞书实现高效自动回复。
