WorkBuddy怎么接入企业微信？企业级通讯网关打通与配置指南

WorkBuddy 是由腾讯云团队孵化的一款全场景桌面 AI 智能体应用。其核心价值在于打通云端大模型与本地物理设备的壁垒，通过接入企业微信，让用户能够在聊天窗口中直接调度本地电脑执行复杂的自动化办公任务。

本文大纲

• 🏢 一、企业微信后台创建应用：获取核心身份凭证
• ⚙️ 二、WorkBuddy 客户端参数注入：配置本地通信身份
• 🔗 三、消息回调与内网穿透配置：架设公网到本地的物理隧道
• 🧪 四、连通性测试与 IP 白名单：确保指令下发畅通无阻

图源：AI生成示意图

一、企业微信后台创建应用 🏢

要让 WorkBuddy 能够与企业微信通信，首先需要在腾讯的官方后台注册一个合法的“机器人身份”。

• 创建自建应用：管理员登录企业微信管理后台（work.weixin.qq.com/wework_admin），进入“应用管理”，在底部选择“创建应用”，上传头像并命名（如“桌面小助手”）。
• 提取核心凭证：创建成功后，在此应用的详情页中，记录下 AgentId（应用 ID）和 Secret（应用密钥）。
• 获取企业 ID：进入后台的“我的企业”页面，在最下方找到并记录全局唯一的 CorpId（企业 ID）。

图源：AI生成示意图

二、WorkBuddy 客户端参数注入 ⚙️

获取云端凭证后，需将其写入本地客户端，赋予智能体合法的通信身份。

• 打开配置面板：启动你本地电脑上的 WorkBuddy 客户端，进入“设置”或“集成（Integrations）”面板，找到“企业微信”配置入口。
• 参数填入：将上一步获取的 CorpId、AgentId 和 Secret 逐一填入对应的输入框中，并保存配置。此时 WorkBuddy 已经具备了向企业微信主动发送消息的能力。

图源：AI生成示意图

三、消息回调与内网穿透配置 🔗

若需让 WorkBuddy 接收你在企业微信里发给它的指令，必须打通双向通信的回调网络。

• 内网穿透：利用 ngrok 或 cpolar 等内网穿透工具，将 WorkBuddy 在本地监听的服务端口暴露到公网，生成一个外网可访问的 HTTPS 链接（如 https://xxx.ngrok.io/wecom）。
• 配置接收消息：回到企业微信应用详情页，点击“接收消息” -> “设置 API 接收”。将刚生成的公网链接填入 URL。
• 密钥校验：在企微后台随机获取 Token 和 EncodingAESKey，立刻将其复制并填入 WorkBuddy 客户端的对应配置中保存。最后在企微后台点击“保存”以触发服务器间的物理握手校验。

简要解释：企业微信的云端服务器无法直接访问你局域网内的个人物理电脑。内网穿透的作用就是架设一条公网隧道，让云端的文字指令能精准越过路由器防火墙，送达你电脑本地的监听端口。

图源：AI生成示意图

四、连通性测试与 IP 白名单 🧪

配置完成并保存成功后，需进行链路连通性测试。

• 实机测试：在手机或电脑的企业微信中，找到刚刚创建的应用，发送一条文本测试指令（例如“总结桌面的今日报表”），观察 WorkBuddy 本地客户端是否成功唤醒并执行动作。
• 排障检查：如果提示网络错误，需检查企业微信后台该应用的“企业可信 IP”是否已将内网穿透工具所映射的云端 IP 节点加入白名单。

总结

本文拆解了 WorkBuddy 接入企业微信的技术流转路径。其实质是通过在企微后台创建自建应用获取底层通信凭证，写入本地客户端完成身份注册；同时借助内网穿透工具架设公网回调隧道，将 Token 等鉴权参数双向同步，从而实现移动端聊天窗口对本地电脑资源的跨网络物理调度。

当企业需要高频调度复杂业务流，且出于安全考量无法接受公网内网穿透架构时，推荐部署实在Agent。它原生内置合法合规的企微通信模块，提供纯私有的安全物理网关，免代码即可构建高抗干扰能力的企业级数字员工。