总结从解决.bat关联失效到成功搭建OpenClaw Ollama 飞书桥接器全流程的经验。你可以将其收藏作为日后的“排障手册”。第一部分Windows 环境基础修复1..bat文件无法打开或右键无“打开方式”现象双击脚本没反应或者右键菜单里找不到“打开方式”。根源Windows 注册表中的脚本关联损坏系统不认识.bat执行引擎。修复方法以管理员身份打开 CMD运行assoc .batbatfile和ftype batfile%1 %*。进阶编辑若想编辑代码按住Shift 右键往往能强制调出隐藏的“打开方式”。第二部分AI 服务一键启动配置为了方便日后一键启动并自动对齐 Token请保留以下优化后的脚本。1. 自动化启动脚本 (start_ai.bat)该脚本解决了多窗口杂乱和Token 不匹配的问题。echo off chcp 65001 :: 1. 定义安全令牌 (用于 Bridge 与 Gateway 握手) set MY_TOKENxx :: 2. 飞书 API 配置 set FEISHU_APP_IDxx set FEISHU_APP_SECRETxx set GATEWAY_TOKEN%MY_TOKEN% :: 3. 使用 Windows Terminal (wt) 在标签页中启动 wt -w 0 nt --title Ollama Server cmd /k ollama serve; ^ nt --title OpenClaw Gateway cmd /k openclaw gateway --token %MY_TOKEN%; ^ nt --title Feishu Bridge --startingDirectory C:\Users\an\.openclaw\workspace\skills\feishu-bridge-1.0.0 cmd /k node bridge.mjs第三部分飞书机器人排障指南当你发现飞书机器人不回消息或报错时请按顺序检查1. 错误代码速查表错误代码 / 提示含义解决方法1000040345 (System Busy)握手失败1. 确认后台开启了“长连接”模式2. 确认 App ID/Secret 正确。unauthorized: token mismatch暗号对不上脚本中的MY_TOKEN必须同时传递给openclaw参数和GATEWAY_TOKEN变量。AxiosError: 400 Bad Request鉴权失败飞书后台修改权限后必须创建新版本并点击“申请发布”配置才会生效。2. 飞书后台必看设置订阅方式必须在“事件订阅”中选择“长连接”。应用能力必须启用“机器人”功能。权限范围必须包含im:resource获取资源、im:message消息相关等权限。第四部分功能验证流程链路测试在飞书私聊机器人发送/ping收到pong代表整条链路飞书 - 桥接器 - 网关已通如果没通查看C:\Users\an.clawdbot里面的配置文件中的appID,appSecret,gatewayToken是否配置正确如果链路测试发送/ping后没有收到pong响应请按照从外到内的顺序排查以下关键点### 1. 飞书云端与桥接器Bridge的连接* **长连接状态**检查飞书开放平台“事件订阅”页面确认订阅方式已切换为“长连接”并显示为“已启用”。 * **版本发布情况**确认在修改权限或配置后已在“版本管理与发布”中创建并上线了新版本否则云端配置不会生效。 * **错误代码1000040345**若桥接器日志出现此代码通常代表 App ID 或 App Secret 填错或者机器人能力未在“应用能力”中开启。 * **权限范围**确认已在权限管理中搜索并启用了“获取机器人信息”或类似的机器人基本信息权限。### 2. 桥接器Bridge与网关Gateway的通信* **Token 匹配验证**检查日志中是否出现“unauthorized: gateway token mismatch”错误。 * **变量对齐**确保启动脚本中openclaw gateway后的--token参数值与setGATEWAY_TOKEN的变量值完全一致。 * **网关地址配置**检查bridge.mjs或其配置文件确认其指向的 OpenClaw 网关地址和端口默认通常为http://127.0.0.1:11451或18789是否正确。### 3. OpenClaw 网关自身状态* **端口监听**查看 OpenClaw 启动日志确认其显示“listening on ws://127.0.0.1:18789”或指定的端口。 * **插件冲突**检查日志开头是否有“duplicate pluginiddetected”警告若有则需删除重复的扩展目录如C:\Users\an\.openclaw\extensions\feishu只保留工作空间内的版本。 * **认证模式**观察日志中“Browser control listening”后是否显示“(authtoken)”若有则必须提供 Token 才能连接。### 4. 系统环境排查* **环境变量继承**在 Windows Terminal 的标签页中输入echo%GATEWAY_TOKEN%确认变量已成功注入当前会话。 * **防火墙与拦截**确认本地杀毒软件或防火墙未拦截端口通信或尝试暂时关闭第三方安全软件进行测试。 如果您完成了上述检查仍无法收到响应您希望我为您编写一段专门用于诊断 App ID 有效性的测试脚本吗模型测试直接发送任意问题观察 OpenClaw 窗口是否有agent model: qwen...的推理日志。冲突处理若日志提示duplicate plugin id请删除C:\Users\an\.openclaw\extensions\feishu只保留workspace\skills下的桥接器。