需部署workbuddy物联网网关实现企业微信远程控iot：一、安装网关并配置局域网监听；二、绑定设备并设权限；三、配置企业微信webhook与证书；四、发送自然语言指令触发协议转换；五、实时回传状态与异常告警。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望使用WorkBuddy通过企业微信远程控制IoT设备，需借助WorkBuddy物联网网关完成协议转换与安全接入。该网关作为本地边缘节点，负责将企业微信下发的自然语言指令解析为对应IoT协议（如MQTT、HTTP、CoAP），并转发至目标设备，同时回传执行状态与传感器数据。以下是实现此能力的具体路径：
一、部署WorkBuddy物联网网关
物联网网关是连接企业微信与IoT设备的核心中间件，必须运行在与IoT设备同一局域网内的Windows或Linux主机上，且需具备固定内网IP及基础网络权限。网关不依赖公网暴露，所有通信经由Claw加密隧道中继至企业微信。
1、访问WorkBuddy官网下载页面，选择「IoT网关专用版」安装包（Linux为.deb/.rpm，Windows为.msi）。
2、执行安装向导，在「网络配置」步骤中指定网关监听地址（如192.168.1.100:8080）及本地子网掩码（如255.255.255.0）。
3、安装完成后，打开网关管理界面（http://192.168.1.100:8080），使用与桌面端WorkBuddy一致的腾讯账号登录。
4、进入「设备发现」页，点击「自动扫描」，网关将识别局域网内已启用mDNS或UPnP的IoT设备（如智能插座、温控器、PLC控制器）。
二、绑定IoT设备至网关
每台IoT设备需在网关中注册唯一设备标识与通信凭证，确保指令路由准确、权限隔离。网关支持手动录入与二维码配网两种方式，推荐对无屏幕设备采用后者。
1、对于支持配网的设备，长按其复位键3秒直至指示灯快闪，返回网关管理界面点击「扫码添加」。
2、用手机摄像头扫描设备本体或说明书上的配网二维码，网关自动获取设备型号、厂商ID及默认通信密钥。
3、在设备详情页中，为该设备设置可读名称（如“会议室空调”）、所属区域（如“3F-东区”）及操作权限组（如“管理员仅可开关，成员仅可调节温度”）。
4、点击「保存并测试连接」，网关向设备发送心跳包；若状态栏显示“在线”，表示绑定成功。
三、配置企业微信机器人对接网关
企业微信需通过Webhook方式将消息推送至物联网网关的API入口，网关再将指令语义解析后分发至对应设备。此过程不经过WorkBuddy桌面客户端，降低延迟并提升实时性。
1、登录企业微信管理后台，进入「应用管理」→「自建应用」→「创建应用」，填写名称为“WorkBuddy-IoT网关”。
WorkBuddy 5.3.8于2026年7月30日发布，修复文件监听卡顿、监听句柄泄漏、历史任务无法恢复、登录状态同步异常、命令环境检测异常及内部消息展示等问题，桌面端运行更稳定。
2、在「接收消息」设置中，启用「接收消息」开关，并将「服务器URL」设为网关外网可访问地址（如https://iot-gw.yourdomain.com/webhook），若无域名则填写NAT映射后的公网IP+端口。
3、在网关管理界面「企业微信集成」页，输入该应用的AgentId、Secret及Token，点击「验证并绑定」。
4、返回企业微信后台，点击「下载证书」获取pem格式证书文件，并上传至网关「SSL证书」配置项中。
四、在企业微信中发送自然语言控制指令
用户无需记忆设备ID或协议参数，直接以日常语言描述意图，网关内置的IoT语义理解模块将自动匹配设备、提取动作与参数，并执行校验与安全风控。
1、在企业微信工作台或群聊中，搜索并打开“WorkBuddy-IoT网关”应用。
2、发送指令，例如：“把3F东区的空调调到26度并开启除湿模式”。
3、网关收到后，解析出设备位置“3F东区”、设备类型“空调”、动作“设置温度”与“开启除湿”，并查询已绑定设备列表确认目标设备。
4、校验当前用户对该设备的操作权限，若具备权限，则生成MQTT PUBLISH报文（主题：/device/ac_3f_east/set，载荷：{"temp":26,"mode":"dehumidify"}）并发出。
五、查看设备状态与执行反馈
网关持续轮询设备状态，并将变更实时同步至企业微信，形成双向闭环。所有交互记录均加密落库，支持按时间、设备、用户维度审计追溯。
1、在企业微信对话窗口中，向网关应用发送：“查一下会议室空调当前状态”。
2、网关立即向设备发起状态查询请求（如HTTP GET /api/v1/device/ac_meeting/status），等待响应超时时间为3秒。
3、收到设备返回的JSON数据（含温度、湿度、运行模式、风速等字段）后，格式化为富文本卡片，推送至企业微信。
4、若设备离线或响应异常，网关自动触发重试机制（最多2次），并在企业微信中推送红色警示消息：“设备‘会议室空调’暂未响应，请检查电源与网络”。
