OpenClaw未自动回复考勤异常提醒，需依次检查权限配置、监听服务状态、消息匹配规则、模拟推送测试及白名单限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用企业微信打卡助手时，发现OpenClaw未能自动回复考勤异常提醒，可能是由于消息监听机制未触发、权限配置缺失或规则匹配逻辑失效。以下是解决此问题的步骤：
一、检查OpenClaw企业微信应用权限配置
OpenClaw需获得企业微信后台授予的“接收消息”与“发送消息”接口权限，否则无法捕获考勤异常事件并执行自动回复。
1、登录企业微信管理后台，进入【应用管理】→【自建应用】→ 找到OpenClaw应用。
2、点击【权限管理】，确认已开启【消息接收】和【消息发送】权限，并勾选【考勤异常提醒】相关事件类型。
3、在【可信域名】中添加OpenClaw服务端回调地址所使用的域名，并确保该域名已通过ICP备案及HTTPS证书校验。
二、验证OpenClaw消息监听服务运行状态
OpenClaw依赖常驻进程监听企业微信推送的考勤异常事件（如event=checkin_change），若服务中断或未注册事件处理器，则无法响应。
1、登录OpenClaw部署服务器，执行systemctl status openclaw-service检查服务是否处于active (running)状态。
2、查看日志文件/var/log/openclaw/event.log，搜索关键词checkin_change，确认是否有对应事件接收记录。
3、若无记录，执行journalctl -u openclaw-service -n 50 --no-pager排查启动失败原因，重点检查token校验失败或AES解密异常提示。
三、校准考勤异常消息匹配规则
OpenClaw通过正则表达式识别企业微信推送的原始消息体中的异常字段（如“迟到”、“缺卡”、“未打卡”），若规则未覆盖当前消息模板，将跳过自动回复。
1、打开OpenClaw配置文件/etc/openclaw/config.yaml，定位checkin_alert_patterns节点。
2、确认列表中包含如下至少一项：迟到、缺卡、未打卡、早退，且每项均为独立字符串，无多余空格或转义符。
3、修改后执行sudo systemctl reload openclaw-service重载配置，不重启服务即可生效。
四、测试企业微信考勤异常模拟推送
绕过真实考勤流程，直接向OpenClaw服务端POST标准格式的考勤异常事件，可快速验证端到端链路是否通畅。
1、构造JSON请求体，包含{"ToUserName":"wxid_xxx","Event":"checkin_change","CheckInType":1,"ExceptionType":2}等必要字段。
2、使用curl命令调用OpenClaw的/api/v1/wecom/callback接口，Header中携带X-WX-Nonce与X-WX-Timestamp签名参数。
3、观察企业微信会话中是否在3秒内收到预设的自动回复文本，如已收到考勤异常提醒，请及时补卡。
五、排查企业微信消息推送白名单限制
企业微信对未加入通讯录或未分配可见范围的成员，可能屏蔽其接收应用消息；OpenClaw若以非管理员身份运行，亦可能受限于部门可见性策略。
1、在企业微信管理后台【通讯录】中，确认触发异常提醒的员工账号状态为“已启用”，且所属部门未被设置为“隐藏”。
2、进入OpenClaw应用【可见范围】设置页，勾选全部需要接收自动回复的部门及成员。
3、临时将OpenClaw应用管理员账号添加至目标员工所在部门，测试消息是否可达，以隔离权限层级问题。
