需完成OpenClaw与飞书集成：一、确保OpenClaw服务运行并验证Token；二、在飞书开放平台创建自建应用并开通机器人权限；三、安装飞书插件并配置App ID/Secret等参数；四、配置公网可访问的事件URL并通过飞书签名验证；五、设置模型路由与知识库绑定并重启网关。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在飞书环境中启用DeepSeek大模型能力，实现群聊智能响应、单聊交互与文件处理等功能，则需完成OpenClaw平台与飞书的集成配置。以下是具体部署步骤：
一、确认OpenClaw基础服务已运行
OpenClaw是承载DeepSeek模型能力的网关服务，飞书机器人功能依赖其正常启动与配置。未部署或未启动OpenClaw时，飞书渠道无法注册事件监听或接收消息。
1、检查OpenClaw Gateway进程是否运行：执行 openclaw gateway status，返回“running”表示服务活跃。
2、验证管理员Token有效性：在浏览器访问 http://localhost:8080/api/v1/health，状态码为200且返回包含"status":"ok"。
3、若服务未启动，执行：openclaw gateway start；如遇端口占用，修改 config.yaml 中 server.port 值 后重试。
二、飞书开放平台应用创建与权限开通
飞书机器人必须通过企业自建应用身份注册，该应用需明确开通机器人能力并授权必要权限，否则无法接收群消息或发送回复。
1、登录飞书开放平台，使用企业管理员账号。
2、点击“创建企业自建应用”，填写应用名称（例如“DeepSeek-飞书助手”）并上传合规图标。
3、进入应用管理页，左侧导航栏选择“添加应用能力”→“机器人”→“添加”。
4、在“权限管理”中确认以下三项已开通：接收消息、发送消息、读取用户信息。
5、在“可用范围”中选择“部分成员”，添加至少1名测试成员，保存后无需审核立即生效。
三、OpenClaw飞书插件安装与参数配置
OpenClaw通过官方飞书插件接入飞书API，需安装插件并注入飞书平台生成的凭证，否则网关无法完成身份认证与事件订阅。
1、执行插件安装命令：openclaw plugins install @m1heng-clawd/feishu。
抓取品牌/产品的视觉规范并生成 brand-spec.md。采用五步流程：询问、搜索、下载、验证+提取、编码，输出可直接被 huo15-openclaw-frontend-design 引用的品牌规约。触发词：抓品牌规范、提取品牌、品牌资产、br...
2、获取飞书应用凭证：在飞书开放平台应用详情页的“凭证与基础信息”中，复制App ID 与 App Secret。
3、依次执行以下配置命令（替换引号内占位符）：
openclaw config set channels.feishu.appId "your_feishu_app_id"
openclaw config set channels.feishu.appSecret "your_feishu_app_secret"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket。
4、执行 openclaw config show channels.feishu 验证四项参数均已写入且值非空。
四、飞书机器人事件订阅与Token校验
飞书平台要求机器人URL必须通过签名验证，OpenClaw需暴露公网可访问地址并正确响应飞书的GET校验请求，否则事件订阅失败，群聊消息无法触发DeepSeek处理。
1、确保OpenClaw服务绑定公网IP或配置了有效反向代理（如Nginx），不能仅使用 localhost 或 127.0.0.1。
2、在飞书开放平台“机器人”设置页，填写Request URL：https://your-domain.com/api/v1/channels/feishu/events（域名需已备案或使用免备案地域）。
3、点击“验证”，飞书将发起GET请求；OpenClaw自动响应并返回challenge值，页面显示“验证成功”即完成订阅。
4、若验证失败，检查日志：tail -f logs/gateway.log | grep feishu，确认是否有404或签名错误记录。
五、本地知识库与模型路由配置
飞书机器人默认调用OpenClaw托管的DeepSeek模型，但若需对接私有知识库或指定模型版本（如DeepSeek-R1 7B本地推理实例），必须显式配置模型路由规则，否则所有请求均走默认云服务通道。
1、确认知识库已加载：执行 openclaw knowledge list，返回至少一条status为active的条目。
2、为飞书渠道绑定专属模型：执行 openclaw config set channels.feishu.model "deepseek-r1-7b-local"（名称需与models目录下实际模型ID一致）。
3、若启用RAG增强，配置知识库ID：openclaw config set channels.feishu.knowledgeId "kb_abc123"。
4、重启网关使模型路由生效：openclaw gateway stop && openclaw gateway start。
