必须手动开启「客户联系」和「群聊管理」权限并配置可信ip白名单，否则qclaw v2 bot无法接收消息或执行自动回复、入群欢迎等关键动作；具体需在企业微信管理后台自建应用中启用对应开关、勾选必要子权限，并准确填写服务出口ip及校验回调地址。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在企业微信中启用QClaw V2 Bot的完整功能，必须手动开启「客户联系」和「群聊管理」两类接口权限，并完成可信IP白名单配置，否则Bot无法接收消息或执行自动回复、入群欢迎等关键动作。
开通客户联系权限
登录企业微信管理后台→【应用管理】→【自建应用】→找到已创建的QClaw V2应用→点击进入详情页。
在左侧菜单栏点击【客户联系】→打开「开启客户联系」开关→勾选「获取客户信息」「获取客户群信息」「发送消息给客户/客户群」三项权限。
⚠️ 注意：若未勾选「发送消息给客户/客户群」，Bot将无法主动推送通知或触发欢迎语，所有外发消息均会静默失败，且后台无明确报错提示。
启用群聊管理权限
仍在同一应用详情页，左侧菜单切换至【群聊管理】→开启「开启群聊管理」开关。
勾选「获取客户群列表」「获取客户群详情」「获取群成员列表」三项——这三者是识别新成员入群、提取群ID、判断群类型的基础，缺一不可。
方法一：如需支持自动拉群、群公告定时推送等高级能力，额外勾选「发送群消息」和「修改群公告」。方法二：若仅做监听与数据采集，保持这两项关闭即可，降低权限暴露面。
配置可信IP白名单
返回应用详情页顶部导航→点击【权限管理】→【IP白名单】→点击【编辑】。
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
第一步：确认QClaw V2服务实际部署的出口IP（非内网IP，非NAT后IP），该IP必须能被企业微信服务器直连访问；
第二步：将该IP地址（支持单IP如203.208.60.1，或CIDR格式如203.208.60.0/24）逐行填入输入框；
第三步：每添加一个IP后务必点击右侧【+】按钮确认录入，漏点会导致对应IP请求全部被拦截，且错误日志中仅显示“invalid ip”，不提示具体哪一行失效；
④ 保存后等待约2分钟生效，期间新请求仍会拒绝。
验证Bot回调地址可用性
在【接收消息】设置区域，填写QClaw V2提供的HTTPS回调URL（形如https://yourdomain.com/qclaw/v2/callback）。
点击【验证】按钮，企业微信将发起GET请求校验Token与EncodingAESKey——【Token和EncodingAESKey必须与QClaw V2服务端配置完全一致，大小写敏感，不可含空格】。
验证成功后，状态显示为「已启用」，此时方可接收事件推送。若失败，请检查Nginx/Apache是否透传了X-WX-Request-ID头，部分CDN会默认剥离该头导致校验失败。
