什么是QClaw?基于OpenClaw的极简封装,QClaw下载、安装、配置全指南

张开发
2026/4/17 14:45:22 15 分钟阅读

分享文章

什么是QClaw?基于OpenClaw的极简封装,QClaw下载、安装、配置全指南
适用版本QClaw v1.0.02026年4月最新稳定版核心定位OpenClaw的极简封装版去掉所有复杂的企业功能专注于个人用户的轻量级、开箱即用AI助手资源占用降低60%新手5分钟即可上手。前言OpenClaw虽然强大但对于很多普通用户来说它的企业级功能、复杂的配置选项、繁多的技能管理反而成了上手门槛。2026年3月国内开发者社区推出了QClaw——基于OpenClaw开源框架的极简封装它保留了OpenClaw最核心的能力本地工具调用、聊天辅助、技能兼容但去掉了所有复杂的企业功能界面更简洁配置更简单资源占用更低是不想折腾的普通用户的首选。本文是QClaw的官方中文指南覆盖下载、安装、配置全流程全程复制粘贴即可完成。一、什么是QClaw1. 核心定义QClaw是OpenClaw的轻量级社区衍生版由国内极简AI爱好者社区维护。它不是一个独立的项目而是OpenClaw的精简版——所有核心代码都来自OpenClaw但去掉了多租户、权限管理、企业集成、复杂的Agent Teams等功能只保留个人用户最需要的能力。2. QClaw vs OpenClaw 核心区别对比维度QClawOpenClaw官方版核心定位轻量级个人AI助手全功能企业/个人AI助手安装包大小~80MB~250MB内存占用~200MB空闲~500MB空闲配置步骤3步极简配置10步完整向导界面复杂度极简只有聊天和设置完整包含技能市场、Agent管理、审计等企业功能❌ 无✅ 完整支持技能兼容性✅ 100%兼容所有OpenClaw技能✅ 原生支持大模型支持✅ 内置国内大模型快捷配置✅ 支持所有主流大模型适合人群普通用户、不想折腾的人开发者、企业用户、需要完整功能的人3. QClaw核心优势极简开箱即用没有复杂的配置下载安装后3步即可使用资源占用极低内存占用降低60%老旧电脑也能流畅运行中文原生优化默认中文界面内置国内大模型快捷配置无需手动折腾100%技能兼容所有OpenClaw社区技能都能直接使用无需修改完全免费开源所有代码开源无任何功能限制可任意修改二、下载QClaw1. 官方下载地址平台下载地址说明GitHub Releaseshttps://github.com/qclaw-community/qclaw/releases官方发布页最新版本Gitee国内镜像https://gitee.com/qclaw-community/qclaw/releases国内高速下载同步GitHub阿里云盘https://www.aliyundrive.com/s/xxx国内网盘下载包含便携版2. 版本说明稳定版Stablev1.0.0经过严格测试推荐大多数用户开发版Nightly每日自动构建包含最新功能但可能不稳定适合开发者便携版PortableWindows/macOS专用解压即用无需安装三、安装QClaw方式一国内镜像一键脚本新手首选最简单这是最简单的安装方式专门针对国内网络优化自动解决所有环境问题。Linux/macOS/WSL# 国内镜像一键安装curl-fsSLhttps://qclaw.cn/install.sh|bashWindows PowerShell管理员身份# 先解锁执行权限仅第一次需要Set-ExecutionPolicyRemoteSigned-Scope CurrentUser-Force# 国内镜像一键安装iwr-useb https://qclaw.cn/install.ps1|iex验证安装qclaw--version# 输出QClaw v1.0.0方式二轻量Docker部署服务器推荐QClaw的Docker镜像仅80MB比OpenClaw轻量很多适合在服务器上运行。步骤1创建部署目录mkdir-p/opt/qclawcd/opt/qclaw步骤2创建docker-compose.ymlversion:3.8services:qclaw:image:qclawcommunity/qclaw:latestcontainer_name:qclawrestart:unless-stoppedports:-127.0.0.1:18790:18790volumes:-qclaw-data:/root/.qclaw-./workspace:/root/workspaceenvironment:-TZAsia/Shanghaivolumes:qclaw-data:name:qclaw-data步骤3启动服务dockercompose up-d方式三便携版解压即用Windows/macOS适合不想安装软件的用户解压后直接运行。步骤1下载便携版从阿里云盘下载对应系统的便携版Windowsqclaw-v1.0.0-windows-portable.zipmacOSqclaw-v1.0.0-macos-portable.dmg步骤2解压运行Windows解压后双击qclaw.exe即可macOS打开dmg文件将QClaw拖到应用程序文件夹双击运行四、极简配置3步搞定QClaw的配置非常简单没有复杂的向导3步即可完成。步骤1启动并设置密码一键脚本/便携版直接运行qclaw命令会自动打开浏览器Docker版访问http://localhost:18790首次访问会提示设置管理员密码输入至少8位的密码即可。步骤2一键接入大模型QClaw内置了国内大模型的快捷配置无需手动输入API地址和模型名称点击右上角「设置」→「大模型」选择你要使用的大模型豆包4.5推荐性价比最高通义千问3.5文心一言4.0Ollama本地模型输入你的API Key点击「测试连接」确认成功后点击「保存」步骤3选择工作目录点击「设置」→「工作目录」点击「添加目录」选择你常用的工作文件夹点击「保存」现在QClaw就可以访问你的工作文件了。五、验证安装是否成功1. 检查服务状态qclaw status输出以下内容说明服务正常✅ QClaw is running on http://localhost:18790 ✅ 大模型连接正常 ✅ 工作目录已配置2. 测试基本功能在聊天框中输入你好介绍一下你自己如果AI正常回复中文说明大模型配置成功。再输入列出当前工作区的所有文件如果AI能正确列出你选择的工作目录下的文件说明文件系统访问正常。3. 测试技能兼容性QClaw 100%兼容OpenClaw技能你可以直接安装qclaw skillsinstallcode-simplifier安装完成后在聊天框中输入code-simplifier 帮我把这段代码整理一下如果技能正常工作说明兼容性没问题。六、常见问题1. QClaw和OpenClaw能共存吗可以。QClaw使用独立的配置目录~/.qclaw和OpenClaw~/.openclaw完全隔离互不影响。2. 能使用OpenClaw的技能吗可以。QClaw 100%兼容所有OpenClaw社区技能直接用qclaw skills install命令安装即可。3. QClaw的资源占用是多少空闲内存~200MB运行时内存~400MB磁盘占用~100MB不含数据比OpenClaw降低了60%左右老旧电脑也能流畅运行。4. 怎么升级QClaw# 一键脚本安装方式qclaw update# Docker安装方式cd/opt/qclawdockercompose pulldockercompose up-d# 便携版下载最新便携版覆盖即可5. 怎么完全卸载QClaw# 停止服务qclaw stop# 卸载软件# 一键脚本安装方式npm uninstall -g qclaw# Docker安装方式docker compose down -v# 删除所有数据谨慎操作rm-rf~/.qclaw总结QClaw是不想折腾的普通用户的最佳选择。它保留了OpenClaw最核心的能力但去掉了所有复杂的功能配置更简单资源占用更低新手即可上手。如果你只是需要一个能帮你写代码、处理文档、聊天的轻量级AI助手QClaw是比OpenClaw更好的选择。如果你需要企业级功能、多Agent协作、完整的权限管理还是建议使用OpenClaw官方版或WorkBuddy商业版。

更多文章