需配置微信服务号模板消息订阅能力，包括开通权限获取模板ID、在WorkBuddy中配置AppID/AppSecret及模板ID、绑定用户OpenID、创建告警任务并映射字段、最后调试验证投递效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望WorkBuddy在检测到关键事件（如任务超时、系统异常或监控阈值突破）时，通过微信服务号向用户推送结构化告警通知，则需配置微信服务号模版消息订阅能力。以下是实现该功能的具体步骤：
一、在微信公众平台开通服务号模板消息权限
微信服务号需具备模板消息接口调用权限，且账号类型必须为已认证的服务号；订阅号与未认证账号不支持模版消息下发。开通后将获得模板ID，作为WorkBuddy调用消息接口的唯一凭证。
1、登录微信公众平台，进入「功能」→「模板消息」页面。
2、点击「添加模板」，在模板库中搜索关键词告警通知或系统异常，选择匹配度最高的官方模板。
3、确认模板字段：至少包含告警标题、发生时间、事件类型、简要描述、处理状态五项变量，确保与WorkBuddy输出字段一致。
4、提交审核，审核通过后复制生成的模板ID（格式类似：TM0000000000000000000000000000000000），保存至本地备用。
二、在WorkBuddy中配置服务号API接入参数
WorkBuddy需通过微信服务号后台提供的HTTPS接口发送模板消息，因此必须配置合法的AppID、AppSecret及模板ID，并完成AccessToken缓存机制初始化，确保每次调用前能获取有效访问令牌。
1、启动WorkBuddy客户端，点击右上角头像 →「Claw设置」→「微信服务号集成」。
2、点击「配置」按钮，在弹出表单中依次填入：公众号AppID、AppSecret、已获准的模板ID。
3、点击「测试连接」，系统将自动调用微信接口验证凭证有效性；若返回access_token获取成功，则表示基础鉴权通过。
4、勾选「启用模版消息告警通道」，点击「保存配置」，该通道即刻注册为可用通知源。
三、绑定用户微信OpenID并触发订阅流程
微信服务号模板消息属用户主动订阅型推送，必须由用户在微信内完成首次授权，WorkBuddy方可向其下发消息。该流程通过带参数二维码或静默授权链接完成，无需用户手动关注公众号。
1、在「微信服务号集成」配置页底部，点击「生成用户订阅二维码」。
2、使用手机微信扫描生成的二维码，跳转至微信内置页面，点击「允许接收通知」完成订阅授权。
3、授权成功后，页面显示OpenID已绑定，且WorkBuddy后台同步记录该用户的订阅关系与标签（如“运维告警”、“项目负责人”）。
4、返回Claw设置页，确认「已绑定用户数」计数器增加，且对应OpenID状态为active。
四、创建告警触发任务并关联模版消息内容
WorkBuddy通过自动化任务定义告警条件与响应动作，需将自然语言指令与模板消息字段映射绑定，确保生成的消息体符合微信校验规则，避免因字段缺失或格式错误导致发送失败。
1、进入「自动化任务」→「新建任务」，任务名称设为磁盘空间超90%告警。
2、在提示词框中输入：当系统磁盘使用率持续5分钟超过90%，立即调用微信服务号模板消息，标题为【磁盘告警】，时间填当前系统时间，类型为【存储异常】，描述为“根分区剩余空间不足{value}GB”，状态为【待处理】。
3、在「通知方式」中选择「微信服务号模版消息」，并指定已配置的服务号实例。
4、设置触发频率为「每5分钟检查一次」，点击「保存并启用」，任务即刻加入本地监控队列。
五、调试与验证模版消息实际投递效果
初次配置完成后，需模拟真实告警场景验证端到端链路是否畅通，重点检查消息内容渲染准确性、接收延迟、OpenID匹配及微信客户端展示样式，排除字段占位符未替换、模板ID错配等高频问题。
1、在监控界面（http://localhost:8080/monitor）中，手动触发一次磁盘告警任务，观察状态看板是否显示执行成功。
2、打开手机微信，查看服务号对话窗口，确认收到一条含蓝色标题栏的模版消息，且所有变量字段均已正确填充。
3、点击消息底部「查看详情」，跳转至WorkBuddy本地Web控制台对应任务执行详情页，核对上下文快照中的message_id与send_time是否与微信侧日志一致。
4、若未收到消息，立即查看右侧日志流中以wx_template_send为前缀的日志条目，定位错误码（如40003表示OpenID无效，41028表示模板字段缺失）。
