需启用消息监听、安装客服Skill、部署独立Agent、接入多IM通道并配置合规拦截。具体包括：开启微信直连与监听；安装CustomerService Skill并配置FAQ；新建agent-cs工作空间并指定端口启动；集成企业微信/钉钉作为降级通道；设置关键词与语义过滤规则。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将QClaw用于客户服务场景，但发现其默认行为未按预期自动响应用户消息，则可能是由于QClaw未启用消息监听模式、未配置客服专用Skill，或微信联系人对话权限未正确激活。以下是解决此问题的步骤：
一、启用微信联系人直连与消息监听
QClaw需处于持续监听状态才能接收并响应微信联系人发来的消息，该功能依赖于本地客户端运行且网络畅通。若电脑休眠、QClaw进程被终止或微信授权过期，将导致消息无法触达。
1、确认电脑处于开机且未进入睡眠状态，QClaw进程在任务管理器中显示为“正在运行”。
2、打开QClaw主界面，点击左下角头像旁的手机图标，检查是否显示“已绑定微信联系人”及“消息监听已开启”状态。
3、若状态异常，点击“重新绑定”，使用手机微信扫描弹窗二维码，完成二次授权并勾选“允许接收消息通知”选项。
二、安装并配置客服专用Skill
QClaw本身不内置客服逻辑，必须通过Skill扩展实现意图识别、话术匹配与自动回复能力。官方提供“CustomerService”Skill，支持关键词触发、多轮会话保持及常见问题库调用。
1、在QClaw主界面点击“技能市场”，搜索CustomerService，点击安装按钮。
2、安装完成后，点击该Skill右侧的齿轮图标，进入配置页。
3、在“FAQ知识库”区域粘贴结构化JSON格式的客服问答对，例如：{"问":"退款怎么操作","答":"请提供订单号，我们将为您发起72小时内原路退款。"}
4、启用“自动回复开关”，并将响应延迟设置为≤800毫秒以满足客服响应时效要求。
三、部署独立客服Agent实例
为避免与个人助手行为冲突，建议为客服场景创建隔离的Agent实例，确保其身份设定、记忆上下文和执行权限均独立于日常办公用途。
1、在QClaw工作空间中新建文件夹，命名为agent-cs，并在其中初始化IDENTITY.md文件。
2、在IDENTITY.md中写入：名称=客服小虾；角色=7×24小时在线应答专员；职责=处理售前咨询、订单查询、售后申诉三类标准请求；响应风格=简洁、礼貌、带编号步骤说明。
3、启动该Agent时，在命令行中指定路径：qclaw --workspace ./agent-cs --port 8081，确保其占用独立端口且不与主实例混用内存缓存。
四、接入企业微信/钉钉作为备用通道
微信个人号存在单日消息量限制与风控策略，当客服请求并发超过阈值时，QClaw可能被临时限流。此时可启用多IM通道分流，保障服务连续性。
1、访问QClaw官网下载“Multi-IM Bridge”插件安装包，双击运行完成集成。
2、在插件配置界面，分别输入企业微信管理后台提供的Secret密钥与钉钉开发者后台获取的AppKey/AppSecret。
3、勾选“消息同步开关”，设置微信为优先通道，企业微信与钉钉为降级通道，当微信通道不可用时自动切换。
五、配置合规性拦截规则
客服自动回复需规避敏感词、广告话术及未授权承诺，否则可能引发客诉或平台处罚。QClaw支持基于正则与语义模型的双重过滤机制。
1、在工作空间根目录下新建filter-rules.yaml文件，填入禁止触发的关键词列表，如[" guaranteed", "绝对", "永不", "微信转账"]。
2、启用内置语义审核Skill，在配置中选择模型为Kimi-2.5-moderation，该模型专为中文客服场景微调，可识别隐性违规表达。
3、设置拦截动作：检测到高风险内容时，自动替换为预设安全话术，并向管理员微信发送告警消息。
