QwenPaw：开源个人 AI 助手

1. 项目概述

QwenPaw 是一个开源、可扩展的个人 AI 助手平台，可在本地或云端运行，为全球用户提供一个私密、随时可用的数字伙伴，能够聊天、自动化任务、编写代码，并连接到用户已在使用的消息应用。

2. 背景与定位

QwenPaw 来自 AgentScope 团队，代表“Qwen 个人代理工作站”。其核心使命是让 AI 助手从一次性、无状态的聊天工具，转变为温暖、持续的伴侣——能够记住上下文、随时间学习，并通过本地优先部署尊重用户隐私。

QwenPaw 与典型聊天机器人封装的区别：

持久、结构化的记忆，而非每次会话都重置的上下文窗口——对话被转化为可读、可编辑、可搜索的 Markdown 记忆。
部署灵活性——可完全离线运行，使用小型本地模型（无需 API 密钥），也可连接 14+ 家云端 LLM 提供商，让用户完全掌控成本、隐私和能力的权衡。
安全优先架构——沙箱、工具检查和技能扫描是内置的，而非事后添加，这对于能够执行 shell 命令和访问文件系统的助手至关重要。
全渠道覆盖——单个代理实例可从钉钉、飞书、微信、Discord、Telegram、iMessage 和 QQ 访问，而非局限于单一聊天界面。

3. 功能分类

🧠 记忆与上下文

基于 ReMe 个人知识框架的三层记忆架构。

当前对话的活跃工作上下文
完整、可搜索的对话历史
以关联 Markdown 存储的自我进化个人知识库
基于滚动的上下文管理，支持持久化轮次存储
目的：让助手在会话之间保持连续性，而非每次重启后失忆。

🔒 安全与沙箱

围绕代理可执行的每个动作构建的分层防御系统。

内核级沙箱（macOS 上的 Seatbelt、Linux 上的 Bubblewrap、Windows 上的 AppContainer）
工具守卫，带执行前命令检查（ShellEvasionGuardian）
文件守卫，阻止访问敏感目录
技能扫描器，在激活前筛查第三方技能中的威胁
目的：让代理安全地运行命令、编辑文件和安装技能，而不成为攻击面。

💬 多渠道连接

一个代理，多个入口。

钉钉、飞书、微信、Discord、Telegram、iMessage、QQ
目的：让用户从他们日常使用的任何应用与同一个助手对话，无需重复设置。

🤖 模型与部署选项

随处运行，任意大脑。

本地 QwenPaw-Flash 模型（2B / 4B / 9B），无需 API 密钥
集成 Ollama 和 LM Studio 进行本地推理
14+ 家云端 LLM 提供商（OpenAI、Anthropic、DeepSeek、Kimi 等）
Docker、阿里云 ECS、AgentScope 平台、ModelScope Studio 以及测试版桌面应用
目的：让部署模式匹配用户的隐私、预算和硬件约束。

🛠️ 生产力与开发工具

超越聊天的内置能力。

编码模式：三面板 Web IDE，带文件导航、差异预览和结构化代码搜索
支持 PDF、Word、Excel 和 PowerPoint 文件的文档处理
网络搜索和视频摘要
定时任务自动化和工作流编排
目的：将助手转变为编码、研究和日常办公的实用工具，而非仅用于对话。

4. 核心亮点

本地优先、无需 API 密钥——QwenPaw-Flash 模型让用户无需注册任何云服务提供商即可开始使用。
结构化、进化的记忆——基于 ReMe 的记忆系统让过去的对话真正可复用，而非会话结束后丢失。
纵深防御安全——内核沙箱加上工具守卫、文件守卫和技能扫描器，降低了具有 shell 访问权限的代理出错的风险。
真正的全渠道覆盖——单个运行实例开箱即用地支持七个消息平台。
多代理生成——助手可以生成具有独立记忆的子代理，用于并行或专业化任务。
多种部署路径——pip、安装脚本、Docker、云平台和桌面应用，几乎覆盖了从 CLI 优先的开发者到非技术用户的各类用户舒适度。

5. 按角色划分的使用场景

普通开发者——将编码模式用作轻量级、聊天驱动的 IDE 伴侣，用于代码搜索、差异比较和快速自动化脚本。

DevOps/SRE——通过 Docker 或阿里云 ECS 部署，并使用定时任务自动化处理重复性运维工作；沙箱限制了代理执行命令的爆炸半径。

安全工程师——审查和扩展工具守卫、文件守卫和技能扫描器模块，或评估 QwenPaw 的沙箱模型（Seatbelt/Bubblewrap/AppContainer）用于代理安全研究。

数据/科研人员——使用文档处理和网络搜索技能来总结论文、电子表格和报告，持久记忆在会话之间保持研究上下文。

项目经理——通过现有团队聊天工具（钉钉、飞书、微信、Discord、Telegram）访问助手，委派提醒、文档摘要和定时跟进，无需采用新应用。

6. 快速开始

查找所需内容——浏览文档站点，获取关于模型、渠道、技能、安全以及 API/CLI 的指南：

https://qwenpaw.agentscope.io

安装并运行——最快的方式是通过 pip（Python 3.11–3.13）：

pip install qwenpaw
qwenpaw init
qwenpaw start

Docker、自动化安装脚本和测试版桌面应用也可用于不希望直接管理 Python 环境的用户。

贡献——在提交拉取请求前，设置开发环境并运行所需检查：

pip install -e ".[dev,test,full]"
pre-commit install
pre-commit run --all-files
pytest

遵循 Conventional Commits 规范（例如 feat(models): add custom provider for Azure OpenAI），并查看 GitHub Discussions 了解当前寻求贡献者的领域，如新渠道、模型和技能。

7. 项目结构

QwenPaw/
├── src/qwenpaw/     # 核心 Python 包（代理运行时、记忆、安全）
├── console/         # Web 前端（Node.js），用于配置和聊天界面
├── plugins/         # 用于扩展渠道、技能和提供商的插件系统
├── deploy/          # Docker 和部署配置
├── tests/           # 单元测试套件
├── e2e/             # 端到端测试
└── website/         # 文档站点源码

关键入口点：src/qwenpaw/ 包含代理逻辑、模型集成和安全守卫；console/ 是本地 Web 界面，启动后可通过 http://127.0.0.1:8088/ 访问；agents/skills/（在贡献文档中引用）是添加新技能的位置，每个技能都有一个 SKILL.md 描述代理何时应触发它。

8. 相关生态

上游依赖：Qwen 模型系列（用于 QwenPaw-Flash 本地模型）、模型上下文协议（MCP）用于工具集成，以及 ReMe 框架用于个人记忆。
部署平台：阿里云 ECS、AgentScope 平台、ModelScope Studio，以及 Docker Hub / 阿里云容器镜像服务用于镜像。
配套工具：Ollama 和 LM Studio 用于本地模型服务；兼容 OpenAI、Anthropic、DeepSeek 和 Kimi 的 API 用于云端推理。

9. 许可证

QwenPaw 采用 Apache License 2.0 发布。

✅ 允许个人或商业用途的使用、修改和分发
✅ 允许创建和分发衍生作品，包括专有产品
✅ 允许在生产环境中使用，无需支付许可费用
❌ 未经许可，不得使用 QwenPaw 名称或商标暗示官方认可
❌ 贡献者不对因使用本软件而产生的损害承担责任
ℹ️ 在再分发副本中保留原始版权声明和许可证文本
ℹ️ 任何贡献的更改均按相同的 Apache 2.0 条款接受

10. 常见问题

问：试用 QwenPaw 需要 API 密钥吗？
答：不需要。QwenPaw-Flash 本地模型（2B/4B/9B）无需任何云端 API 密钥即可运行；云提供商是可选的，用于获得更高能力的响应。

问：我可以将 QwenPaw 连接到团队已在使用的消息应用吗？
答：可以。内置渠道支持覆盖钉钉、飞书、微信、Discord、Telegram、iMessage 和 QQ，单个运行实例即可实现。

问：让代理运行 shell 命令和编辑文件安全吗？
答：QwenPaw 应用内核级沙箱以及工具守卫、文件守卫和技能扫描器，在代理动作执行前限制其可访问的内容。

问：最快的安装方式是什么？
答：pip install qwenpaw，然后运行 qwenpaw init 和 qwenpaw start（Python 3.11–3.13）；Docker 和引导式安装脚本是那些不希望直接管理 Python 的用户的替代方案。

问：如何添加新技能或消息渠道？
答：技能位于 agents/skills/ 下，带有 SKILL.md 清单；新渠道继承 BaseChannel 并在 registry.py 中注册。详情请参阅贡献指南。

11. 快速链接

仓库：https://github.com/agentscope-ai/QwenPaw
官方文档/主页：https://qwenpaw.agentscope.io
贡献指南：https://github.com/agentscope-ai/QwenPaw/blob/main/CONTRIBUTING.md
社区：仓库上的 GitHub Discussions，以及 README 中列出的 Discord 和 X（Twitter）链接

12. 总结

QwenPaw 将持久记忆、多渠道消息和内置安全整合到一个开源个人 AI 助手中，可完全离线运行或扩展到云端。它最适合希望拥有可破解、可自托管的代理平台的开发者，以及希望将同一个助手带入现有聊天工具的团队——全部在宽松的 Apache 2.0 许可证下。