# 项目介绍

本页说明 QwenPaw 是什么、能做什么、以及如何按文档一步步上手。

---

## QwenPaw 是什么？

QwenPaw 是一款**个人助理型产品**，部署在你自己的环境中。

![控制台](https://img.alicdn.com/imgextra/i1/O1CN01ikrU3k1TRdNESHtzV_!!6000000002379-2-tps-3822-2070.png)

- **多通道对话** — 通过钉钉、飞书、Discord、Telegram 等与你对话。
- **多智能体协作** — 支持创建多个独立智能体，每个智能体拥有独立配置、记忆和技能，
  还可以通过协作技能互相通信、共同完成复杂任务。
- **定时执行** — 按你的配置自动运行任务。
- **能力由 Skills 决定，有无限可能** — 内置定时任务、PDF 与表单、Word/Excel/PPT 文档处理、新闻摘要、文件阅读等，还可在 [Skills](./skills) 中自定义扩展。
- **支持本地模型** — 支持本地运行大模型，无需 API Key，完全离线工作。
- **数据全在本地** — 不依赖第三方托管。
- **多层安全防护** — 内置工具防护、文件访问控制、技能安全扫描等机制，保障运行安全。

QwenPaw 由 [AgentScope 团队](https://github.com/agentscope-ai) 基于
[AgentScope](https://github.com/agentscope-ai/agentscope)、
[AgentScope Runtime](https://github.com/agentscope-ai/agentscope-runtime) 与
[ReMe](https://github.com/agentscope-ai/ReMe) 构建。

想了解 QwenPaw 的整体设计——Agent OS 架构及其 AgentScope 基础，参见 [架构设计](./architecture)。

---

## 你怎么用 QwenPaw？

使用方式可以概括为两类：

1. **在聊天软件里对话**
   在钉钉、飞书、微信、Discord、Telegram等app里发消息，QwenPaw 在同一 app 内回复，
   查资料、记待办、回答问题等都由当前启用的 Skills 完成。一个 QwenPaw 可同时接入多个
   app，你在哪个频道聊，它就在哪个频道回。

2. **定时自动执行**
   无需每次手动发消息，QwenPaw 可按你设定的时间自动运行：
   - 定时向某频道发送固定文案（如每天 9 点发「早上好」）；
   - 定时向 QwenPaw 提问并将回答发到指定频道（如每 2 小时问「我有什么待办」并发到钉钉）；
   - 定时执行「自检/摘要」：用你写好的一串问题问 QwenPaw，把回答发到你上次对话的频道。

装好、接好至少一个频道并启动服务后，你就可以在钉钉、飞书、QQ 等里与 QwenPaw 对话，并享受定时
消息与自检等能力；具体能做什么，取决于你启用了哪些 Skills。

---

## 文档中会出现的几个概念

- **控制台** — QwenPaw 内置的 Web 管理界面，可以在控制台中对话、配置频道、管理技能、
  设置模型等。详见 [控制台](./console)。
- **频道** — 你和 QwenPaw 对话的「场所」（钉钉、飞书、QQ、Discord、iMessage 等）。在
  [频道配置](./channels) 中按步骤配置。
- **心跳** — 按固定间隔用你写好的一段问题去问 QwenPaw，并可选择把回答发到你上次使用的
  频道。详见 [心跳](./heartbeat)。
- **定时任务** — 多条、各自独立配置时间的任务（每天几点发什么、每隔多久问 QwenPaw 什么等），
  通过控制台或 [CLI](./cli) 管理。
- **技能池与工作区技能** — 技能池是共享的技能仓库，工作区技能是某个智能体真正运
  行时使用的技能副本。详见 [Skills](./skills)。
- **MCP 和工具** — MCP（Model Context Protocol）是一种标准协议，允许接入外部
  工具服务器扩展能力。工具是 QwenPaw 内置的基础能力（如读写文件、执行命令、
  浏览器等）。详见 [MCP和工具](./mcp) 。
- **智能体/工作区** — 从 v0.1.0 开始，QwenPaw 支持多智能体，允许运行多个独立的
  AI 智能体。每个智能体拥有独立的工作区、配置、记忆、技能和对话历史，智能体之间
  还可以通过协作技能互相通信、共同完成复杂任务。详见 [多智能体](./multi-agent)。
- **安全机制** — QwenPaw 提供多层安全防护，包括工具防护（拦截危险命令参数）、
  文件防护（限制敏感路径访问）、技能扫描器（检查技能包安全性）等。详见 [安全](./security)。

各概念的含义与配置方法，在对应章节中均有说明。

---

## 建议的阅读与操作顺序

1. **[快速开始](./quickstart)** — 用三条命令把服务跑起来。
2. **[控制台](./console)** — 服务启动后，在浏览器中打开控制台（`http://127.0.0.1:8088/`），
   **这是配置与使用 QwenPaw 的中心枢纽**。先在控制台体验对话、配置模型，有助于理解
   QwenPaw 的工作方式。
3. **[模型](./models)** — 配置云端 LLM 提供商的 API Key，或下载本地模型。这是使用
   QwenPaw 的**必要前提**。
4. **按需配置与使用**：
   - [频道配置](./channels) — 接入钉钉 / 飞书 / 微信 / Discord / Telegram 等，在对应 app 里与 QwenPaw 对话；
   - [Skills](./skills) — 了解与扩展 QwenPaw 能力；
   - [MCP和工具](./mcp) — 接入外部 MCP 工具服务器；
   - [魔法命令](./commands) — 使用特殊命令快速控制对话状态（如 `/new` 开启新对话、`/clear` 清空历史、`/stop` 停止任务、`/restart` 重启服务等），无需等待 AI 理解；
   - [安全](./security) — 配置工具防护、文件防护、技能安全扫描等安全机制；
   - [心跳](./heartbeat) — 配置定时自检或摘要（可选）；
   - [定时任务](./console#定时任务) 或 [CLI](./cli) — 管理定时任务、`qwenpaw doctor` 诊断与 `qwenpaw doctor fix`、清空工作目录等；
   - [多智能体](./multi-agent) — 多智能体配置、管理与协作（v0.1.0+ 新功能）；
   - [配置与工作目录](./config) — 工作目录与配置文件说明。
