天工AI（Kimi）是当前少数能稳定处理复杂中文客服语境的大模型，接入后可解析隐含意图、跨文档关联信息并生成口语化回复；需在天工官网获取kimi-plus模型API密钥，在飞书开放平台配置机器人权限、事件订阅（长连接）及回调URL，再通过n8n或ClawPro搭建飞书→天工AI→飞书消息链路，最后完成多轮对话、群聊@响应及人工服务入口测试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让飞书机器人具备中文场景下强推理、长文本理解与多轮对话能力，天工AI（Kimi）正是当前少数能稳定处理复杂客服语境的大模型，接入后可直接解析用户提问中的隐含意图、跨文档关联信息并生成自然口语化回复。
获取天工AI API密钥与基础配置
登录天工AI官网，进入「开发者中心」→「API管理」→「创建新密钥」。选择模型版本为kimi-plus（客服场景推荐），勾选「文本生成」权限，点击创建并复制API Key。注意：该密钥仅显示一次，关闭页面后无法再次查看，【务必立即保存到安全位置】。
在飞书开放平台中，进入你已创建的机器人应用 →「凭证与基础信息」页，确认App ID与App Secret已记录完整。这两个值后续将用于n8n或ClawPro中对接飞书事件网关。
配置飞书机器人事件权限与回调地址
在飞书开放平台应用后台，进入「应用功能」→「机器人」→ 开启机器人开关；再进入「权限管理」→「批量导入/导出权限」→ 粘贴以下最小必要权限集（删减冗余项可降低审核驳回风险）：
{ "scopes": { "tenant": [ "im:message", "im:message.p2p_msg:readonly", "im:message.group_at_msg:readonly", "im:message:send_as_bot", "contact:user.base:readonly" ] } }
前往「事件订阅」→「事件配置」页，订阅方式必须选择【长连接】，保存后系统自动启用；接着在「请求地址配置」栏粘贴你即将在n8n或ClawPro中生成的Webhook外网URL（非localhost），点击保存。若提示“验证失败”，请检查URL是否带HTTPS前缀且能被公网访问。
搭建消息流转链路：飞书 → 天工AI → 飞书
方法一：使用n8n低代码编排（适合无服务器环境）
第一步：在n8n工作流中添加Webhook节点，HTTP Method设为POST，Path填/kimi-feishu，Authentication选None；
第二步：添加HTTP Request节点，URL填天工AI官方接口https://api.kimi.ai/v1/chat/completions，Headers中加入Authorization: Bearer your_api_key与Content-Type: application/json；
第三步：在Body中构造JSON载荷，关键字段必须包含："model": "kimi-plus"、"messages": [{"role":"user","content":"{ { $json.body.event.message.text.content }}"}]，其中{ { $json.body.event.message.text.content } }会自动提取飞书原始消息正文；
第四步：添加Feishu Send Message节点，填入App ID/App Secret，Target Type选chat_id或open_id（根据飞书事件中携带的接收者字段动态选择），Message Content填{ { $json.choices[0].message.content } }；
第五步：激活工作流，返回飞书后台点击「验证」按钮——飞书将发送Challenge请求，n8n自动响应后状态变为绿色“已验证”。
方法二：通过ClawPro管控台直连（适合已有OpenClaw实例）
进入ClawPro用户端 → 找到目标OpenClaw实例 →「详细配置」→「通道(Channels)」→ 选择飞书 → 切换至「手动配置」→ 填入飞书App ID与App Secret → 在「大模型后端」模块中，选择「自定义API」→ 输入天工AI接口地址、API Key、并设置请求体模板为标准OpenAI兼容格式（注意role字段需映射为user/assistant/system）→ 单击「添加并应用」。
注意：ClawPro默认不校验天工AI返回字段名，若出现choices is not iterable报错，需在ClawPro高级设置中启用「响应字段重映射」，将response.choices[0].message.content显式指定为输出路径。
测试与上线前必检项
在飞书任意单聊窗口@你的机器人发送“你好”，观察是否返回合理回复；若无响应，先检查n8n工作流是否处于激活态、Webhook节点是否在监听状态；
发送含多轮上下文的消息（如“上一条说的运费是多少？”），确认天工AI是否能正确关联历史消息——这依赖飞书事件中event.message.chat_id与event.message.root_id字段是否被正确传入天工API的messages数组；
在群聊中@机器人提问，验证group_at_msg权限是否生效，且消息内容是否自动剥离@前缀（n8n中可用{ { $json.body.event.message.text.content.replace(/@.*? /, '') } }清洗）；
最后，在飞书服务台后台「机器人设置」中启用该机器人，并勾选「展示人工服务入口」，确保当用户发送“转人工”时可无缝跳转至客服坐席。
