> 随时随地，帮您高效干活

---

## 目录

1. [QClaw 是什么](#qclaw-是什么)
2. [下载安装](#下载安装)
3. [快速开始](#快速开始)
4. [核心功能](#核心功能)
5. [Skill 技能系统](#skill-技能系统)
6. [常用场景示例](#常用场景示例)
7. [高级功能](#高级功能)
8. [常见问题](#常见问题)
9. [真实使用案例](#真实使用案例)

---

## QClaw 是什么

QClaw 是腾讯电脑管家官方出品的智能 AI 助手，具备以下特点：

- **多渠道接入**：支持微信、Telegram、Discord、WhatsApp 等多种通讯平台
- **技能扩展**：通过 Skill 系统扩展能力，覆盖文档处理、网络搜索、自动化等场景
- **上下文记忆**：跨会话记忆用户信息和偏好，提供连贯的交互体验
- **主动服务**：通过 Heartbeat 机制主动检查和提醒，无需用户反复询问

---

## 下载安装

### 官网下载

访问 QClaw 官网：[https://qclaw.qq.com/](https://qclaw.qq.com/)
![image.png](https://developer.qcloudimg.com/http-save/yehe-5286508/df69ffb8a2fa38e02593ae1b58957504.png)

### 下载地址

| 平台 | 下载链接 |
|------|---------|
| Windows | [QClaw-Setup.exe](https://package-cdn.qclaw.qq.com/qclaw/win/0.2.5-5001-373/QClaw-Setup-0.2.5-5001-373.exe) |
| macOS (Apple 芯片) | [QClaw-arm64.dmg](https://package-cdn.qclaw.qq.com/qclaw/mac/arm64/0.2.5-5001-306/QClaw-0.2.5-5001-306-arm64.dmg) |
| macOS (Intel 芯片) | [QClaw-x64.dmg](https://package-cdn.qclaw.qq.com/qclaw/mac/x64/0.2.5-5001-307/QClaw-0.2.5-5001-307-x64.dmg) |

### 安装步骤

1. **下载安装包**
   - 根据您的操作系统选择对应的下载链接
   - Windows 用户下载 .exe 安装包
   - Mac 用户根据芯片类型选择 arm64 或 x64 版本

2. **运行安装程序**
   - Windows：双击 .exe 文件，按提示完成安装
   - Mac：双击 .dmg 文件，将 QClaw 拖入 Applications 文件夹

3. **首次启动**
   - 打开 QClaw 应用
   - 使用微信扫描二维码绑定账号
   - 开始使用！

### 安装要求

- **操作系统**：Windows 10/11 或 macOS 10.15+
- **网络**：需要网络连接
- **微信账号**：用于绑定和远程操控

---

## 快速开始

### 初次使用

1. **添加 QClaw 到您的通讯平台**
   - 微信：扫描二维码添加小程序/公众号
   - Telegram：搜索 QClaw Bot
   - Discord：邀请 Bot 到服务器

2. **第一次对话**
   ```
   你好，QClaw！
   ```
   QClaw 会自动引导您完成初始化设置。

3. **绑定账号**（可选）
   - 提供邮箱、时区等个人信息
   - QClaw 会自动记忆，后续无需重复提供

---

## 核心功能

### 文档处理

| 功能 | 说明 |
|------|------|
| 创建文档 | Word (.docx)、Excel (.xlsx)、PPT (.pptx)、PDF |
| 文档编辑 | 读取、修改、格式转换 |
| 云文档 | 支持腾讯文档、金山文档、腾讯问卷 |

### 信息检索

| 功能 | 说明 |
|------|------|
| 网络搜索 | 多引擎聚合搜索，获取实时信息 |
| 金融数据 | 股票、基金、财经新闻查询 |
| 新闻摘要 | 科技新闻、每日简报 |

### 浏览器自动化

| 功能 | 说明 |
|------|------|
| 网页抓取 | 自动访问网页、提取内容 |
| 表单填写 | 自动化填写和提交表单 |
| 截图保存 | 网页截图、PDF 导出 |

### 定时任务

| 功能 | 说明 |
|------|------|
| 定时提醒 | 一次性或周期性提醒 |
| 自动推送 | 天气预报、日报、报告自动发送 |
| 任务调度 | 定期执行检查和通知 |

### 邮件服务

| 功能 | 说明 |
|------|------|
| 发送邮件 | 推送天气、日报、报告到邮箱 |
| 邮件管理 | 读取、搜索、整理邮件 |

### 云存储

| 功能 | 说明 |
|------|------|
| 文件上传 | 上传文件到腾讯云存储 |
| 备份管理 | 在小程序中查看和管理文件 |

---

## Skill 技能系统

### 什么是 Skill？

Skill 是 QClaw 的能力扩展模块，每个 Skill 专注于特定领域：

- **文档类**：`docx`、`xlsx`、`pptx`、`pdf`
- **搜索类**：`online-search`、`multi-search-engine`
- **云服务类**：`tencent-docs`、`kdocs`、`cloud-upload-backup`
- **自动化类**：`browser-cdp`、`qclaw-cron-skill`
- **信息类**：`weather-advisor`、`news-summary`、`neodata-financial-search`

### Skill 自动加载

QClaw 会根据您的需求自动选择合适的 Skill，无需手动指定。例如：

```
帮我写一份工作报告，保存为 Word 文档
```
→ 自动加载 `docx` Skill

```
搜索一下最近的 AI 新闻
```
→ 自动加载 `online-search` Skill

### 安装新 Skill

如需安装新的 Skill：

```
帮我安装 xxx 技能
```

QClaw 会自动完成环境检测和安装。

---

## 常用场景示例

### 场景一：创建工作报告

```
帮我写一份本周工作总结报告，包含：
1. 项目进展
2. 问题与解决方案
3. 下周计划
保存为 Word 文档
```

### 场景二：整理会议纪要

```
帮我把这段会议记录整理成正式的会议纪要，保存到腾讯文档
[粘贴会议内容]
```

### 场景三：定时提醒

```
每天早上 8 点提醒我查看日程，并发送天气预报
```

### 场景四：信息搜集

```
帮我搜索关于「人工智能在教育领域的应用」的最新资料，整理成文档
```

### 场景五：文件处理

```
帮我把这个 PDF 转换成 Word 文档
[上传 PDF 文件]
```

---

## 高级功能

### Heartbeat 主动服务

QClaw 的 Heartbeat 机制会在后台自动检查：

- **邮件提醒**：发现重要邮件时通知您
- **日程提醒**：即将到来的日程安排
- **天气提醒**：出发前的天气建议

您可以通过编辑 `HEARTBEAT.md` 来自定义检查项。

### 长期记忆

QClaw 会记住您的重要信息：

- 联系方式（邮箱、手机号）
- 个人偏好（语言、工具、时区）
- 工作上下文（项目、角色）

这些信息存储在 `USER.md` 中，跨会话保持一致。

### 多平台同步

QClaw 支持多平台接入：

- 在微信上提问，在 Telegram 上继续
- 统一的记忆和工作空间
- 无缝切换不同通讯渠道

---

## 常见问题

### Q: QClaw 会记住我的密码吗？

**A:** 不会。QClaw 只记录非敏感信息（如邮箱地址、偏好设置），绝不会存储密码、API Key 等敏感凭证。

### Q: 如何清除记忆？

**A:** 您可以：
1. 让 QClaw 忘记某条信息：`忘记我的邮箱`
2. 清除所有记忆：`清除所有记忆`

### Q: Skill 安装失败怎么办？

**A:** QClaw 会自动处理依赖环境。如遇问题：
1. 检查网络连接
2. 重试安装命令
3. 联系技术支持

### Q: 支持哪些文件格式？

**A:** QClaw 支持：
- **文档**：Word (.docx)、Excel (.xlsx)、PPT (.pptx)、PDF
- **数据**：CSV、JSON、XML、Markdown
- **图片**：PNG、JPEG、GIF、WebP
- **代码**：各类编程语言源文件

---

QClaw — 随时随地，帮您高效干活
---

## 真实使用示例

以下是用户与 QClaw 的真实对话案例，展示了 QClaw 的实际能力：

### 示例一：撰写技术文档

**用户指令**：
```
能帮我写一个 QClaw 的使用指南文档吗
```

**QClaw 执行**：
- 自动读取系统规则和功能说明
- 生成包含目录、快速开始、核心功能、Skill 系统、场景示例、高级功能、常见问题等完整章节的技术文档
- 文档结构清晰，格式规范

**结果**：成功创建文件，包含 3000+ 字完整内容

---

### 示例二：发布文章到技术社区

**用户指令**：
```
能帮我把这些内容写到腾讯云社区草稿里面吗
```

**QClaw 执行**：
- 尝试使用腾讯文档 MCP 工具
- 发现环境缺少依赖，自动切换到浏览器自动化方案
- 打开隔离浏览器，导航到腾讯云开发者社区
- 完成登录流程，定位到草稿编辑页面
- 将 Markdown 内容写入编辑器，保存草稿

**结果**：成功将完整使用指南写入腾讯云社区草稿

---

### 示例三：补充官网信息

**用户指令**：
```
目前还缺少 QClaw 的下载安装环节，比如写上官网的地址和官网首页图片
```

**QClaw 执行**：
- 访问 QClaw 官网截取首页截图
- 更新文章内容，添加下载安装章节
- 包含官网链接、各平台下载地址表格、安装步骤、安装要求
- 在文章中插入官网首页截图

**结果**：文章内容更完整，用户可直观了解下载安装流程

---

### 示例四：整理对话为使用案例

**用户指令**：
```
读取我的对话信息，总结为使用示例，提交到网页草稿里面
```

**QClaw 执行**：
- 搜索并读取历史对话记录
- 提取有价值的使用案例
- 整理成结构化的真实使用示例章节
- 更新到文章草稿中

**结果**：本文档中的真实使用示例章节

---

### 示例五：从 GitHub 批量安装 Superpowers Skills 到 OpenClaw

#### 背景

用户希望将 [obra/superpowers](https://github.com/obra/superpowers) 仓库中的所有 skills 和 agents 添加到 OpenClaw 中。Superpowers 是一个专为 AI 编程助手设计的高质量技能包，包含 TDD、系统化调试、子代理驱动开发等最佳实践。

#### 挑战

1. **网络问题**：GitHub 直连超时，需要处理网络访问问题
2. **文件数量多**：需要下载 14 个 skill 目录和 1 个 agent，共 20+ 个文件
3. **目录结构复杂**：部分 skill 包含多个辅助文件

#### 解决方案

采用分步策略：

1. **探索仓库结构**：使用 GitHub API 获取目录列表
2. **内容获取**：通过 web_fetch 工具逐个获取文件内容
3. **本地写入**：批量创建目录结构，使用 write 工具写入文件

#### 最终成果

成功添加了 **14 个 Skills** 和 **1 个 Agent**：

- superpowers-brainstorming：创意工作前的需求探索和设计
- superpowers-dispatching-parallel-agents：并行派发独立任务给多个子代理
- superpowers-executing-plans：按计划逐步执行任务（带检查点）
- superpowers-finishing-a-development-branch：完成开发分支（合并/PR/保留/丢弃）
- superpowers-receiving-code-review：接收 code review 反馈的最佳实践
- superpowers-requesting-code-review：请求 code review 的流程
- superpowers-subagent-driven-development：子代理驱动开发（每任务一代理+双阶段审查）
- superpowers-systematic-debugging：系统化调试（根因分析四阶段）
- superpowers-test-driven-development：TDD 红-绿-重构循环
- superpowers-using-git-worktrees：Git worktree 隔离开发
- superpowers-verification-before-completion：完成前验证工作成果
- superpowers-writing-plans：编写实施计划文档
- superpowers-writing-skills：编写 superpowers 技能
- superpowers-using-superpowers：技能索引和使用指南

#### 技术要点

1. **目录结构**：每个 skill 放在独立目录 `superpowers-{name}/` 下
2. **文件格式**：使用 YAML frontmatter，与 OpenClaw 技能格式兼容
3. **辅助文件**：部分 skill 包含模板文件和示例代码

#### 安装位置

```
E:\Program Files\QClaw\resources\openclaw\config\skills\superpowers-*\
E:\Program Files\QClaw\resources\openclaw\config\agents\superpowers-code-reviewer.md
```

#### 使用说明

重启 OpenClaw 后，这些 skills 会自动被识别。用户可以通过描述触发相应的 skill，例如：
- "我需要调试一个 bug" → 触发 systematic-debugging
- "帮我实现一个新功能" → 触发 brainstorming → writing-plans → subagent-driven-development

### 示例六：科技新闻摘要 | 2026年4月11日

> 来源：cron定时任务推送案例

这是一个通过 OpenClaw cron 定时任务自动生成的科技新闻摘要。每天早上 8:00 自动执行，通过多搜索引擎聚合获取最新科技新闻。

---

#### 今日科技新闻摘要

1. **Anthropic发布Claude Mythos Preview，能力超人类专家却不公开** — Anthropic于4月7日低调发布Project Glasswing，unveiled能力极强的新模型Mythos Preview，在漏洞发现、编码等方面超越大多数人类安全专家，但因安全风险仅面向AWS、Apple、Google等40余家核心机构提供邀请制访问，并提供1亿美元算力额度。

2. **OpenAI下一代模型"Spud"(GPT-6)蓄势待发，预计下半年发布** — 训练已于3月完成，Greg Brockman称其将"改变经济"，Sam Altman已停掉其他项目全力投入；与OpenAI万亿估值IPO深度绑定，市场预测9月底前发布概率约72%。

3. **腾讯发布《2026Q1 AI趋势白皮书》，AI Agent完成"成人礼"** — 腾讯新闻发布59页白皮书，指出Agent从分钟级演示跨入天级执行，OpenClaw 60天GitHub星数从9K飙至247K、月活200万；Claude Code单日贡献全球4% GitHub公开代码。

4. **第三届中国具身智能大会(CEAI 2026)今日合肥启幕** — 中国人工智能学会主办，聚焦人形机器人、具身大模型、空间智能等前沿方向，宇树科技、智元机器人等标杆企业参与，近200支队伍参加Dobot具身智能挑战赛决赛。

5. **百度伐谋Agent 2.0登顶MLE-Bench，刷新SOTA** — 百度智能云推出的企业级算法自主优化智能体再次登顶OpenAI主导的机器学习工程基准，正式版将于5月Create 2026百度AI开发者大会发布。

6. **中央网信办联合约谈7家抢票平台：禁止自动化程序高频抢票** — 携程、同程、去哪儿、飞猪、美团、智行、高铁管家等7家平台被约谈，要求不得利用自动化程序干扰12306平台安全运行。

7. **美国3月CPI同比上升3.3%，能源价格环比大涨10.9%** — 美国3月CPI数据超预期，能源价格创2005年以来最大涨幅，科技股盘前普涨，Meta涨超1%。

8. **天猫与长安启源合作布局新能源整车销售，推"天猫甄选好车"** — 长安启源发布A06与Q05两款新车型，联合天猫以电商补贴形式销售，4月24日北京车展公布配置售价并独家发售。

9. **江特电机拟联合院士团队发起设立"低空经济协同创新研究院"** — 核心研究方向包括低空飞行器高性能电机、eVTOL动力能源一体化、低空经济政策法规与空域管理。

10. **AI洗稿编造车企谣言被查，两人被抓** — 上海警方在涉企网络谣言专项打击中，破获一起利用AI技术编造传播小米等多家车企谣言的案件。

---

#### 技术实现细节

**数据获取流程：**
1. 尝试使用 `tech_news_digest_tool.py` 脚本的 digest 和 fetch 命令
2. 尝试 `web_search` 失败：未配置搜索 Provider API Key
3. 尝试 `online-search` skill 失败：Node.js 未安装
4. 最终使用 `multi-search-engine` skill + `web_fetch` 成功获取

**数据来源：**
- Bing 搜索: "2026年4月11日 科技新闻"
- news.cctv.com/tech/
- 凤凰网安徽: CEAI 2026大会
- 36氪快讯
- news.qq.com: 腾讯AI趋势白皮书
- hatenablog: Anthropic/OpenAI 双雄分析

---

## 示例七：QClaw 菜谱管理系统

一个轻量级的全栈应用示例：使用 FastAPI + Vue 3 构建菜谱管理 SPA。
### 技术栈

- **后端**: Python 3.11 + FastAPI + SQLAlchemy + SQLite
- **前端**: Vue 3 Composition API + Vite + Axios
- **部署**: Docker 单镜像部署

### 项目结构

```
qclaw-recipe-system/
├── backend/
│   ├── main.py          # FastAPI 入口 + 静态文件挂载
│   ├── database.py      # SQLite 配置
│   ├── models.py        # ORM 模型定义
│   ├── schemas.py       # Pydantic 请求/响应模型
│   ├── crud.py          # 数据库 CRUD 操作封装
│   └── routers/
│       └── recipes.py   # 菜谱相关 API 路由
└── frontend/
    └── src/
        ├── App.vue      # 单文件组件（含侧边栏、列表、详情、表单）
        ├── api/recipes.js  # Axios 封装
        └── style.css    # 全局样式

```
### 核心代码

**后端 [models.py](http://models.py)** — ORM 模型：

```
class Recipe(Base):
    __tablename__ = "recipes"
    id = Column(Integer, primary_key=True, index=True)
    title = Column(String(200), nullable=False)
    category = Column(String(50), nullable=False, index=True)
    ingredients = Column(Text, nullable=False)
    steps = Column(Text, nullable=False)
    cook_time = Column(Integer, nullable=False)
    difficulty = Column(String(20), nullable=False)
    image_url = Column(String(500), nullable=True)
    is_favorite = Column(Boolean, default=False)
    created_at = Column(DateTime(timezone=True), server_default=func.now())
```
**后端 routers/recipes.py** — API 路由：

```
@router.get("", response_model=dict)
def list_recipes(
    skip: int = Query(0, ge=0),
    limit: int = Query(20, ge=1, le=100),
    keyword: Optional[str] = None,
    category: Optional[str] = None,
    sort: Optional[str] = "newest",
    favorites_only: bool = Query(False),
    db: Session = Depends(get_db),
):
    recipes = crud.get_recipes(db, skip=skip, limit=limit, keyword=keyword,
                               category=category, sort=sort, favorites_only=favorites_only)
    total = crud.count_recipes(db, keyword=keyword, category=category, favorites_only=favorites_only)
    return {"items": [RecipeResponse.model_validate(r) for r in recipes], "total": total}
```
**前端 api/recipes.js** — Axios 封装：

```
export const recipeAPI = {
  list(params = {}) {
    return client.get('/recipes', { params })
  },
  get(id) {
    return client.get(`/recipes/${id}`)
  },
  create(data) {
    return client.post('/recipes', data)
  },
  update(id, data) {
    return client.put(`/recipes/${id}`, data)
  },
  delete(id) {
    return client.delete(`/recipes/${id}`)
  },
}
```
### 功能特性


|功能|说明|
|:-:|:-:|
|菜谱列表|支持分页、关键词搜索、分类筛选、多种排序|
|菜谱详情|展示配料、步骤、烹饪时间、难度|
|新增/编辑|Vue 表单组件，Pydantic 校验|
|收藏功能|一键收藏/取消收藏|
|评分笔记|每道菜支持 1-5 分评分和做菜笔记|
|统计面板|分类分布、难度分布、Top10 榜单|
|深色模式|主题切换|
|导出 Markdown|批量导出菜谱|
### 运行方式

```
# 后端
cd backend && pip install -r requirements.txt
python init_db.py && uvicorn main:app --port 8000

# 前端（另开终端）
cd frontend && npm install && npm run dev
```
生产环境下，Vite 构建产物放入 `backend/frontend_dist`，由 FastAPI 直接托管静态文件，实现单镜像部署，最终结果如下图所示：

![image.png](https://developer.qcloudimg.com/http-save/yehe-5286508/1fe9eb769efa4256bb2d997c9cea4f1b.png)


> 提示：这些示例展示了 QClaw 的核心能力：理解用户意图、自动选择合适工具、处理异常情况、持续优化输出。您只需用自然语言描述需求，QClaw 会自动完成复杂的操作流程。

多渠道接入：支持微信、Telegram、Discord、WhatsApp 等多种通讯平台

QClaw 我的龙虾生活助理

人工智能

前端

后端

腾讯QClaw是一款智能AI助手，支持微信、Telegram等多平台接入，提供文档处理、信息检索、自动化任务等核心功能。通过Skill技能系统扩展能力，具备长期记忆和主动服务特性，帮助用户高效完成工作报告、会议纪要、定时提醒等日常任务。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

QClaw 我的龙虾生活助理-腾讯云开发者社区-腾讯云

QClaw 我的龙虾生活助理

QClaw 我的龙虾生活助理

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐