微信集成本地 AI Agent 框架 QClaw 使用指南
背景与概述
OpenClaw 是一个开源本地 AI Agent 框架,核心逻辑是将 AI 助手部署在用户自己的机器上,通过聊天工具接收指令并执行任务。数据留在本地,算力由用户自己提供。
腾讯基于 OpenClaw 打造了 QClaw,将其产品化封装。QClaw 打通了微信和 QQ 接入渠道,解决了原生支持 Telegram、WhatsApp 在中国市场普及率低的问题。当 AI Agent 的接入渠道变成微信,普通人使用 AI 的最大门槛(无需记住新 App、无需切换工作流)被消除。
[图片]
安装和配置流程
以下流程按'第一次接触也能跑通'的标准编写。不需要懂命令行,先把流程走通最重要。
前置准备
- 一台能长期在线的电脑(本地部署是核心前提)
- 一个可扫码的微信账号
- 10~20 分钟不被打断的时间
第 1 步:下载并安装 QClaw 客户端
进入官方入口页:https://claw.guanjia.qq.com/
QClaw 定位为本地一键启动包。将客户端安装到电脑上,再谈后续微信联动。
- 下载客户端
- 打开安装包
- 完成安装并启动 QClaw
如果本机之前已跑过 OpenClaw,可选择关联已有环境/同步已有信息的路径,以节省重复配置。
第 2 步:首次启动后,先做模型和基础配置
启动后不要急着发指令,先把基础配置做完。常见页面会引导以下内容:
- 选择模型(常见支持 Kimi、MiniMax,也支持自定义)
- 完成必要授权/确认
- 保存当前配置
目标不是配到完美,而是先保证能跑起来。先用默认或最熟悉的模型,后面再调优。
第 3 步:绑定微信
这一步决定能否从'装好了'进入'真能用'。
常见流程:
- 在 QClaw 里找到微信关联入口
- 弹出二维码后,用手机微信扫码
- 在手机侧确认授权
- 回到电脑端确认状态已连接
这相当于把本地执行力接到最高频的沟通入口上。
第 4 步:先跑一个最小闭环任务
第一条指令一定要简单、可验证、可回看。不要上来就让它跑复杂工作流。
建议测试顺序:
- 简单查询:先发一条确认在线状态的指令
- 轻量执行:让它读取一个可控目录的信息
- 结果回传:确认结果能回到对话侧
看到'发出指令 → 本地执行 → 返回结果'这个闭环跑通,才算真正完成安装。
第 5 步:安装 Skills,把'能用'变成'好用'
跑通后再做扩展能力。Skills 生态通常来自 ClawHub / GitHub 等来源。
实操建议:
- 先装 1~2 个与日常最相关的 Skills
- 装完立刻做一次小任务验证
- 再逐步叠加,不要一次装太多
明确知道哪个 Skill 带来了什么能力,排错更快。
第 6 步:把它放进每天复用的场景
真正有价值的是可复制的日常流程。可从三类高频场景开始:
- 文件类:检索、整理、汇总
- 内容类:素材归集、信息提炼、结构化输出
- 网页操作类:固定步骤的重复动作
原则:先挑重复多、出错成本低、收益立竿见影的任务。
第 7 步:排查顺序
当它'突然没反应'时,按这个顺序查,效率最高:
- 客户端是否仍在运行


