DeepBot企业微信与微信连接器配置指南扫码登录到消息路由全打通【免费下载链接】deepbotDeepBot is a system-level AI assistant built for both personal productivity and enterprise workflows — one-click setup, seamless experience, and native Feishu integration.项目地址: https://gitcode.com/gh_mirrors/de/deepbotDeepBot 是一款系统级 AI 助手内置企业微信连接器与微信连接器支持 BotID 快速接入企业微信智能机器人、微信个人号扫码登录实现从收发消息到独立会话路由的全链路打通。本文将手把手带你在 5 分钟内完成 DeepBot 企业微信与微信连接器的配置让 AI 助手直接在聊天窗口里帮你干活。一、为什么要把企业微信 / 微信接进 DeepBot传统 AI 助手只在桌面窗口里等你而 DeepBot 的连接器Connector系统可以把它搬进你每天都在用的聊天软件企业微信WeCom通过 WebSocket 长连接接入企业微信智能机器人支持私聊、群聊、提及可收文本 / 图片 / 文件 / 语音 / 视频微信WeChat基于 iLink Bot 协议扫码登录支持私聊消息收发、图片 / 文件传输独立会话每个对话自动映射到 DeepBot 的一个独立 Tab拥有独立的上下文和记忆自动保活断线 5 秒自动重连、30 秒心跳、消息去重长期在线更稳定连接器的核心实现位于 src/main/connectors/其中企业微信连接器是 wecom-connector.ts微信连接器是 wechat-connector.ts。二、企业微信连接器配置3 步接入智能机器人企业微信采用BotID Secret的长连接方案无需申请回调地址也不需要公网 IP内网即可用这是它比 Webhook 机器人省心得多的原因。1. 获取 BotID 和 Secret登录企业微信管理后台在「工作台 → 智能机器人」中创建或找到你的机器人记录BotID和Secret密钥给机器人起一个好记的名字建议不超过 10 个字它会显示在 DeepBot 的 Tab 标题上2. 在 DeepBot 中填写配置打开 DeepBot 桌面端进入「系统设置 → 外部连接 → 企业微信」配置界面源码见 ConnectorConfig.tsx。需要填写三项字段说明是否必填BotID企业微信机器人 ID✅Secret机器人密钥✅机器人名称用于 Tab 标题显示✅ DeepBot 支持多实例可以同时配置多个企业微信机器人wecom-1、wecom-2……分别服务不同部门或用途互不干扰。3. 保存并启动点击「保存」后启动连接器。启动后 DeepBot 会连接企业微信 WebSocket 服务用 BotID Secret 完成订阅认证aibot_subscribe订阅成功后开始 30 秒一次的心跳保活看到连接器状态变为「运行正常」就可以直接在企业微信里 它 提问了。连接与认证逻辑可参考 wecom-connector.ts。三、微信连接器配置扫码登录即可用微信连接器不需要任何密钥扫码就是全部配置这也是所有外部平台中最快的一种。扫码登录步骤在 DeepBot「系统设置 → 外部连接 → 微信」中点击启动DeepBot 会实时生成登录二维码并推送到界面打开微信「扫一扫」扫描二维码并在手机上确认登录登录成功后进入消息长轮询自动接收私聊消息登录凭证说明凭证默认保存在~/.deepbot/wechat/目录下次启动自动恢复登录无需重复扫码Docker 部署时凭证存放在持久化数据目录容器重建也不丢主动「停止」连接器会清除本地凭证缓存下次需重新扫码会话过期时 DeepBot 会提示重新登录相关实现见 wechat-connector.ts。⚠️ 温馨提示微信登录使用的是个人账号请控制使用频率、避免群发营销内容以免触发平台风控。四、消息路由全解析一条消息的完整旅程配置完成后你在聊天窗口发出的每一句话都会经过下面这条链路这也是「消息路由」的含义企业微信 / 微信 │ ① 连接器接收去重、下载解密媒体文件 ▼ ConnectorManager ← 统一调度所有连接器 │ ② 转换为标准 GatewayMessage ▼ Gateway / SessionManager │ ③ 按「连接器 会话ID」查找或创建独立 TabSession ▼ Agent Runtime ← 该 Tab 的 AI 智能决策 工具调用 │ ④ 生成回复 ▼ 连接器 outbound ← 文本走回复通道图片/文件走上传通道 ▼ 消息出现在企业微信 / 微信聊天窗口几个值得新手注意的细节独立会话同一个用户在不同群 / 私聊里的对话会路由到不同 Tab上下文互不串扰。路由核心在 connector-manager.ts 和 gateway-connector.ts消息去重连接器内置 1000 条消息缓存平台重推不会造成重复回答群聊 提及群消息会自动剥离机器人前缀再交给 AI 理解文件消息企业微信的图片 / 文件 / 视频会自动下载并 AES 解密后落盘供 AI 工具直接读取聊天窗口里的系统命令在连接器会话中直接发送斜杠命令即可管理会话命令作用/new清空上下文开始新会话/status查看任务当前进度和输出/stop停止正在执行的任务/history查看历史消息/memory查看当前记忆长任务执行时还会自动推送进度提醒30 秒、1 分钟……每 5 分钟一次不用担心 AI 在后台静默干活。进度提醒文案见 gateway-connector.ts。五、主动推送让 AI 把结果发给你配置好连接器后DeepBot 内置了配套的消息工具可以在任何 Tab 里主动向外发消息wecom_send_message / wecom_send_image / wecom_send_file向指定企业微信用户或群推送文本、图片、文件wechat 发送工具向微信好友发送文本、图片、文件典型用法定时任务 消息推送。例如对 DeepBot 说一句每天早上 9 点抓取新闻摘要通过企业微信发给我AI 会创建定时任务到点执行后自动调用推送工具结果直接躺在你的企业微信里。工具实现参考 wecom-tool.ts。六、常见问题排查现象可能原因解决方法企业微信提示「WebSocket 未连接」网络不通或密钥错误检查 BotID/Secret确认机器可访问企业微信服务启动后收不到群消息机器人未被拉进群或未 它将机器人加入目标群发消息时 机器人微信二维码一直过期扫码太慢重新点击生成二维码及时确认提示「被新连接踢掉」同一 BotID 在别处又连了一次停止重复实例每个机器人只连一个 DeepBot停止连接器后收不到消息凭证已被清除重新启动并重新扫码登录写在最后DeepBot 的企业微信与微信连接器用BotID 长连接 微信扫码登录两条最简单的路径把 AI 助手接入了绝大多数中文办公场景。完成配置后不妨先试试/new和定时推送这两个最实用的玩法。想深入了解实现细节可以从以下入口入手连接器统一调度connector-manager.ts消息路由与会话分配gateway-connector.ts前端配置界面ConnectorConfig.tsx更多平台飞书配置参考docs/飞书机器人配置指南.md项目总体架构与工具清单README_ZH.md【免费下载链接】deepbotDeepBot is a system-level AI assistant built for both personal productivity and enterprise workflows — one-click setup, seamless experience, and native Feishu integration.项目地址: https://gitcode.com/gh_mirrors/de/deepbot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
