QClaw 上手指南:我用了一周龙虾,感觉自己白用了两年 AI

QClaw 上手指南:我用了一周龙虾,感觉自己白用了两年 AI

欢迎来到我的博客,代码的世界里,每一行都是一个故事

🎏:你只管努力,剩下的交给时间

🏠 :小破站

QClaw 上手指南:我用了一周龙虾,感觉自己白用了两年 AI

如果你最近在关注 AI 工具圈,大概率听说过一个叫 OpenClaw 的东西,中文社区管它叫「龙虾」。这个开源项目在 GitHub 上拿了 30 万 Star,增速之快让整个行业侧目。就在上周,CNBC 专门发文分析它的爆发式增长,标题起得很直接——「OpenClaw 迎来自己的 ChatGPT 时刻」。与此同时,腾讯、字节、阿里、小米已经相继跟进,开始基于它做自己的 AI 助手产品。

但对普通用户来说,OpenClaw 的上手门槛不低——你得会用命令行,得懂 Node.js,得自己去配 API 密钥。这道槛挡住了相当一部分想用的人。

QClaw 解决的就是这个问题。它是 OpenClaw 的桌面端封装版,把所有安装配置流程都藏进去,开箱即用,还把微信直联做成了核心功能。我从安装到上手折腾了一周,把整个过程记录下来,给同样想试试但不知道从哪里开始的人参考。


先说清楚:OpenClaw 是什么,龙虾又是怎么来的

理解 QClaw 之前,得先理解 OpenClaw。

OpenClaw 本质上是一个跑在本地的 AI 代理框架。它不是聊天界面,而是一个 AI 引擎——可以连接微信、钉钉、飞书、WhatsApp 等 20 多个聊天平台,可以安装 Skills 插件扩展能力,可以接入任意兼容 OpenAI 格式的大模型,可以在你的电脑上直接操控文件、浏览器、执行脚本。

它为什么叫「龙虾」?项目历史上经历过几次改名,从 Clawd 到 Moltbot 再到 OpenClaw,像龙虾蜕壳一样,每次都脱胎换骨。这个绰号在中文社区里传开了,后来就成了约定俗成的叫法。

QClaw 是在 OpenClaw 基础上做的桌面应用,支持 macOS(Apple 芯片和 Intel 芯片),把安装、配置、启动这些流程全部包装好,不需要懂命令行,下载安装完直接用。

QClaw 下载页面

第一次打开:它先问你是谁

安装完打开,没有引导页,没有功能介绍 PPT,直接进入对话界面。然后它开口了:

看起来这是我们第一次对话。我刚刚上线,身份还是空白的——连名字都还没定下来。
你是谁?我又该是谁?咱们来聊聊,把这些定下来。

它会问你几个问题:你叫什么,希望 AI 叫什么名字,喜欢什么风格——正式的、随意的、有点嘴贱的、还是温暖贴心的。

首次启动初始化

这个初始化流程看起来很轻,背后是认真的。你们协商好的名字、说话风格、对彼此的称呼,会写入工作空间的配置文件,下次启动还在,不会因为重启清空。这是持久化身份,不是一次性扮演。

手机端也是同一套逻辑。在微信里走完初始化,AI 助手就和你的微信账号绑定了,之后直接发消息就能调用,不需要打开任何 App。

手机端微信初始化

多数 AI 工具的逻辑是先展示功能、再让你上手。QClaw 把顺序反过来——先建立关系,再谈干活。用了一段时间之后才明白这个顺序其实是对的。一个你自己命了名、定了性格的 AI,你对它的信任感和使用频率,跟用一个无名工具是完全不同的。


微信直联:手机变成了 AI 的遥控器

这是 QClaw 和大多数 AI 桌面工具最不一样的地方。

我们在手机上花的时间,远比在电脑前多。但手机上的 AI 工具基本都是孤岛——你在某个 App 里问完,结果就留在那个 App,和你的文件、工作流程完全割裂。要用 AI 帮你处理点事情,得切 App、粘贴内容、等结果、再切回来,流程摩擦很高。

QClaw 整体界面

QClaw 的做法是把微信变成控制入口。在路上发一条微信,本地的 AI 开始处理,完成后直接把结果发回微信。你不需要打开电脑,不需要切 App。等地铁的时候发出去,回到办公室任务已经有了。

b9a32c8adc566f010dc72ae2b7370cac

这不是「AI 接入微信聊天」,而是「微信成了控制本地 AI 的遥控器」。用过一次就知道这两句话的差距有多大。

而且不只是微信。QClaw 的远控通道支持一整排平台:微信、企业微信、QQ、飞书、钉钉、微信客服号,扫码或填入 App ID 和 Secret 即可绑定。团队用企业微信的、公司统一用钉钉的、个人习惯飞书的,都能直接在各自熟悉的工具里和 QClaw 对话,不需要再装别的东西。

远控通道设置页面

接入自定义模型:你的 API 你做主

QClaw 内置了国产大模型,默认状态下直接可用。但它同时完全开放了模型接入口,支持任何兼容 OpenAI 格式的第三方模型(稍微懂点原理,默认UI界面不支持配置,只有部分coding plan)。

接入方式简单得出乎意料——直接用中文告诉它就行:

帮我接入一个模型,格式符合 OpenAI,地址是 xxx,密钥是 sk-xxx,模型用 gpt-4.5。
告诉它接入新模型

QClaw 会自动写入配置文件、重启 Gateway,然后告诉你接入完成、默认模型已切换。之后的对话直接跑新模型,不需要你动任何配置文件。

切换模型后

这个能力对几类人特别关键:公司有自己私有部署模型不想数据出去的;已经买了某家 API 不想重复付费的;想对比不同模型效果的;需要接入国产模型的。QClaw 不绑你用某个特定模型,而是帮你把任何模型用顺手。

如果你习惯直接改配置文件,也可以绕过对话界面,直接编辑 ~/.qclaw/openclaw.json。QClaw 的所有模型配置都存在这里——每个 provider 的 baseUrl、apiKey、模型列表,甚至 reasoning 开关都明文写在这个 JSON 里。改完保存,重启生效。目录里还有几个 .bak 备份文件,QClaw 每次改配置前都会自动备份一份,改坏了直接还原就行。

openclaw-json内容

Skills 插件:能力边界一直在扩

OpenClaw 生态有一个叫 ClawHub 的技能市场,已经有 100 多个 Skills 可以安装,覆盖网页搜索、文件处理、浏览器自动化、GitHub 管理、Notion 同步、代码审查等各类场景。

在 QClaw 里安装 Skill 不需要任何技术操作,界面里直接装。装完之后 AI 自动识别,在合适的时机调用对应工具。

已安装的 Skills 列表

用下来的感受是,Skills 的数量积累到一定程度之后,AI 的能力会有一个质的变化。它不再只是回答问题,而是真的能替你跑任务——搜索 + 整理 + 写入文件 + 推送到微信,一条链路打通。Skills 安装得越多,它能处理的任务范围就越广,这是一个正向积累的过程。


角色系统:不是换个语气,是换个工作模式

很多 AI 工具都有「人设切换」,让它扮演严肃分析师或者温柔助手。这类功能大多数情况下流于形式,换的是说话腔调,工作逻辑没变。

QClaw 的角色系统解决的是另一个问题:不同项目、不同任务类型,需要不同的工作逻辑。

举个例子,你可以给某个项目绑定一个「项目军师」角色,职责是梳理需求、拆解路线、写方案、做决策建议、控节奏。绑定之后,AI 在这个项目的上下文里就始终以这套方式工作,不会跑偏到别的模式。

同理,你可以设定专门处理文件的角色、专门审代码的角色、专门写方案的角色。同一个 AI,绑定不同角色之后,输出的质量和针对性是有实质差异的。

这比语气切换实用得多。需要的不是一个会说软话的 AI,而是一个在特定上下文里能持续发力的工作搭档。


定时任务:让 AI 主动替你干活

大多数 AI 工具是被动的——你问,它答;你不问,什么都不发生。QClaw 的定时任务打破了这个模式。

用自然语言直接创建任务,比如:

  • 「设置每日 8:00 自动抓取今日 AI 科技热点,整理成简报发给我」
  • 「提醒我喝水,每日 10:00 执行,从今天开始持续生效」
  • 「每天推送当天最新 10 条科技新闻,每条总结要精简」
定时任务界面

这不是日历提醒,是真正的自动化任务。任务触发时,AI 自动联网搜索、整理内容,然后推送到你的微信。你开会的时候它在跑,你睡觉的时候它在跑,你不在电脑旁的时候它还在跑。

「灵感广场」里还有一批现成的任务模板,比如热点资讯自动汇总、懒人出游规划等,不用自己想任务怎么描述,直接套用就行。

灵感广场模板

创建一个每天早上 8 点推送 AI 科技简报的任务,只需要说一句中文。QClaw 会自动生成 cron 表达式 0 8 * * *,时区设定为 Asia/Shanghai,会话模式设为 isolated(隔离运行,不污染主对话),全程不需要你手动填任何参数。

创建定时任务

任务配置文件的实际内容长这样——job id、名称、cron 表达式、时区、会话模式,都自动生成好了。

cron job 配置

整套定时任务系统跑在本地,不依赖云端服务器,任务数据不上传,执行结果也不经过第三方。


它是怎么「记住你」的

这是整个产品里我觉得设计最用心的部分。

QClaw 的工作空间里有一套结构化的 Markdown 文件系统,AI 用这套文件来维持跨对话的记忆:

  • AGENTS.md:总工作守则,规定每次开工先读什么、什么能直接做、什么要先问你、记忆该写到哪里
  • SOUL.md:性格和气质设定,定义说话风格、观点表达方式、隐私边界
  • IDENTITY.md:名字和人设,初始化时你们协商的内容
  • USER.md:你的档案,记录偏好、习惯、长期上下文
  • MEMORY.md:长期记忆,从日常对话中提炼出值得长期保留的内容
  • memory/YYYY-MM-DD.md:每日记忆日志,记录当天做了什么、遇到什么问题、做了哪些决定
记忆文件系统原理
记忆文件系统续

QClaw 自己把这套系统描述为「AI 助手的内脏系统」:SOUL.md 是性格,IDENTITY.md 是名字和人设,USER.md 是你的档案,MEMORY.md 是它的长期记忆。

这个比喻很准。普通 AI 工具每次对话都是从零开始,没有积累。QClaw 记得你上次说不喜欢废话,记得你正在做的项目,记得你的工作节奏和决策习惯。用的时间越长,它越懂你——这才是「个人 AI 助手」这个词应该有的含义。


本地跑意味着什么

QClaw 的「本地部署」不只是一个技术参数,它在实际使用中有两层含义。

第一层是数据不出门。你的文件、对话记录、记忆文件全部留在自己电脑上,不上传到任何服务器。处理敏感商业信息、内部文档的人,这是硬需求。

第二层是真正的系统控制权。因为运行在本地,QClaw 可以直接操作你的文件系统、调用本地应用、执行脚本,而不是只能在沙盒对话框里回答问题。这让它从「智能问答工具」变成了「能干活的本地 AI 员工」。


适合什么人用

以下几类人会觉得 QClaw 非常顺手:

需要长期用 AI 辅助工作的人。 不是偶尔问个问题,而是把 AI 深度嵌入日常流程。这类人对「每次都要重新解释背景」这个问题深有体会,QClaw 的持久记忆直接解决了这个痛点。

经常移动办公的人。 在手机微信上触发本地 AI 任务,这个能力对经常出差、开会、不在电脑前的人有实际价值。

有数据安全顾虑的人。 本地部署加上自定义模型接入,数据流向完全可控。

想自动化重复性信息工作的人。 定时资讯摘要、自动整理内容、定时提醒——以前要靠 RPA 工具或自己写脚本,现在说一句中文就能搞定。


最后

OpenClaw 的爆发让整个 AI 代理方向的逻辑变得更清晰:模型本身在商品化,谁能把模型的能力真正接入你的日常工作流,谁才有长期价值。QClaw 选择的路径是——住在你电脑里,认识你,记住你,主动替你干活,通过你最常用的 App 和你交互。

这条路不算新鲜,但把每个环节都做扎实的产品,现在还不多(其实也不少了)。

龙虾的生态还在快速扩张,Skills 在增加,平台接入在增加,记忆系统在迭代。现在上手,赶上的是一个还在高速成长的早期阶段——对于愿意折腾的人来说,这个时间点进来挺合适的。

Read more

前端AI工具实践

前端AI工具实践

Claude Code前端使用 步骤一:安装 Claude Code npm install -g @anthropic-ai/claude-code 运行如下命令,查看安装结果,若显示版本号则表示安装成功 claude --version 步骤二:配置Claude Code+GLM智谱大模型(免费) Coding Tool Helper 是一个编码工具助手,安装并运行它,按照界面提示操作即可自动完成工具安装,套餐配置,MCP服务器管理等。 # 进入命令行界面,执行如下运行 Coding Tool Helper npx @z_ai/coding-helper 步骤三:开始使用 Claude Code VSCODE安装Claude Code 插件 Claude Code CLI(到指定项目目录打开CLI) Claude

Java+Leaflet:湖南省道路长度WebGIS的构建与实践

Java+Leaflet:湖南省道路长度WebGIS的构建与实践

目录 前言 一、基础空间数据简介 1、涉及相关表 2、省域道路长度检索 二、Java后台实现 1、道路视图对象 2、Mapper空间检索查询 3、控制API实现 三、WebGIS界面实现 1、里程图例及初始化 2、各地市信息展示 四、成果展示 1、总体展示 2、分区域说明 五、总结 前言         在当今数字化时代,地理信息系统(GIS)技术在各个领域都发挥着至关重要的作用。它不仅为城市规划、交通管理、环境保护等提供了强大的技术支持,也为公众获取地理信息提供了便捷的途径。湖南省作为中国中部地区的重要省份,拥有复杂的地理环境和庞大的交通网络。如何高效地管理和展示湖南省的道路长度信息,对于交通规划、物流运输以及公众出行都具有极其重要的意义。因此,我们开展了基于Java和Leaflet的湖南省道路长度WebGIS系统的构建与实践研究。         湖南省地处中国中部,交通网络密集且复杂。随着经济的快速发展和城市化进程的加快,湖南省的道路建设不断推进,

新版华三H3C交换机配置NTP时钟步骤 示例(命令及WEB配置)

命令版本  启用NTP服务 默认服务可能未激活,需手动开启: [H3C] ntp-service enable 配置NTP服务器地址 1.1.1.1 在全局配置模式下使用命令ntp-service unicast-server指定NTP服务器IP地址,例如: [H3C] ntp-service unicast-server 1.1.1.1 支持域名或IPv6地址,需确保交换机与NTP服务器网络可达。 设置时区 使用clock timezone命令调整时区,北京时间示例: [H3C] clock timezone Beijing add 08:00:00 [H3C] clock protocol ntp 名称可自定义(如"Beijing"),偏移量需与实际时区匹配。 配置NTP认证(可选) 若服务器需认证,需配置密钥和关联:

WEB 学习框架搭建

WEB 学习框架搭建

WEB 学习框架搭建 (写了几道web题目,都感觉无法下手,后来觉得还是得系统搭建框架学习,如果连基础知识都有很多不明白,光知道各种注入方法也没有什么用,以下为借助AI的学习记录) web应用框架 前端(XSS,CSRF)-后端(SQL,越权,文件上传,文件包含。。。)-数据库 场景:用户在小程序上输入手机号和密码,点击“登录”。 第一步:前端的工作 (用户看得见的部分) 前端负责展示界面、收集数据、调用API、处理响应。 1. 构建界面:画出登录页面,有手机号输入框、密码输入框和“登录”按钮。 2. 监听事件:用户点击“登录”按钮时,前端代码被触发。 3. 收集与校验:前端获取输入框里的手机号和密码,先做基本校验(如手机号格式、密码非空)。 4. 调用API(