QClaw 上手指南
如果你关注过开源 AI 领域,大概率听说过 OpenClaw。这个项目在 GitHub 上获得了极高的关注度,被中文社区称为「龙虾」。它本质上是一个跑在本地的 AI 代理框架,能够连接微信、钉钉、飞书等二十多个平台,支持 Skills 插件扩展,并能接入任意兼容 OpenAI 格式的大模型。
QClaw 是 OpenClaw 的桌面端封装版,主要解决了原生版本上手门槛高的问题。它将安装配置流程全部封装,开箱即用,并重点强化了微信直联功能。基于实际使用体验,以下是对核心功能的梳理。
OpenClaw 是什么,龙虾又是怎么来的
OpenClaw 不是一个简单的聊天界面,而是一个 AI 引擎。它可以操控文件、浏览器和执行脚本。项目历史上经历过几次改名,从 Clawd 到 Moltbot 再到 OpenClaw,像龙虾蜕壳一样不断进化,因此得名。
QClaw 在此基础上做了桌面应用优化,支持 macOS(Apple 芯片和 Intel 芯片),无需懂命令行即可直接使用。

初始化:建立身份与关系
安装完打开,没有冗长的引导页,直接进入对话界面。它会询问你的名字、希望 AI 叫什么名字以及喜欢的沟通风格——正式、随意还是温暖贴心。
这些协商好的信息会写入工作空间的配置文件,实现持久化身份。手机端也是同一套逻辑,在微信里走完初始化后,AI 助手就和你的微信账号绑定了,之后直接发消息就能调用,不需要打开任何 App。

多数 AI 工具先展示功能再让你上手,QClaw 把顺序反过来——先建立关系,再谈干活。一个你自己命名、定了性格的 AI,信任感和使用频率会完全不同。
微信直联:手机变成了遥控器
这是 QClaw 最显著的区别。我们在手机上花的时间远比电脑多,但手机上的 AI 工具往往是孤岛。QClaw 的做法是把微信变成控制入口。在路上发一条微信,本地的 AI 开始处理,完成后直接把结果发回微信。
这不是简单的「AI 接入微信」,而是「微信成了控制本地 AI 的遥控器」。远控通道支持微信、企业微信、QQ、飞书、钉钉等平台,扫码或填入 App ID 和 Secret 即可绑定。


接入自定义模型:你的 API 你做主
QClaw 内置了国产大模型,默认状态下直接可用。但它完全开放了模型接入口,支持任何兼容 OpenAI 格式的第三方模型。
接入方式很简单,直接用自然语言告诉它即可,例如指定地址、密钥和模型名称。QClaw 会自动写入配置文件、重启 Gateway,然后告诉你接入完成。之后的对话直接跑新模型,不需要你动任何配置文件。
对于习惯直接改配置文件的用户,也可以绕过对话界面,直接编辑 ~/.qclaw/openclaw.json。QClaw 的所有模型配置都存在这里,包括 baseUrl、apiKey、模型列表甚至 reasoning 开关。目录里还有 备份文件,改坏了直接还原就行。






