QwenPaw使用教程：从安装到配置的完整指南

QwenPaw（原名CoPaw）是AgentScope团队开源的个人AI助手，支持本地与云端双部署，可通过Token Plan团队版、Coding Plan或按量计费接入阿里云百炼。QwenPaw使用教程将带你从零开始完成安装部署、模型配置、渠道绑定与核心功能配置，涵盖多智能体协作、记忆引擎、定时任务等高级能力，助你快速上手这款数据自主、记忆进化的个人智能体。

一、QwenPaw概述：什么是QwenPaw

1.1 产品定位与命名含义

QwenPaw是阿里云AgentScope团队于2026年推出的开源个人AI助理，前身为CoPaw。名称中的“Qwen”代表与通义千问开源生态的深度整合，“Paw”则延续了项目的原始使命——陪伴用户，成为用户真正信任的个人助手。QwenPaw采用Apache-2.0开源协议，GitHub星标量已突破17.4k。

1.2 核心设计理念

QwenPaw围绕五大核心原则构建：

• 本地优先，数据自主：所有交互数据、记忆、配置默认存储于本地，用户完全掌控数据所有权
• 身份持久化：通过agent.md、soul.md、profile.md三个核心文件定义AI人格，重启后身份与记忆不丢失
• 技能即插件，模块化扩展：采用热加载架构，每个技能对应独立文件夹，可快速扩展能力
• 多端统一接入：一个智能体同时接入钉钉、飞书、微信、Discord、Telegram等主流通讯工具
• 记忆进化，主动服务：具备长期记忆与反思能力，从被动问答升级为主动执行的“数字员工”

1.3 QwenPaw与其他AI助手的对比

二、QwenPaw安装教程

2.1 系统要求

安装QwenPaw前，请确认环境满足以下要求：

• Python版本：3.10 ~ 3.13
• 操作系统：macOS / Linux / Windows
• 推荐配置：本地运行建议≥2C4G，多智能体协作建议4C8G

2.2 一键脚本安装（推荐）

QwenPaw提供一键安装脚本，自动安装uv、创建虚拟环境并下载依赖，无需手动配置Python。

macOS / Linux：

curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash

Windows（CMD）：

curl -fsSL https://qwenpaw.agentscope.io/install.bat -o install.bat && install.bat

Windows（PowerShell）：

irm https://qwenpaw.agentscope.io/install.ps1 | iex

安装完成后，在新终端执行以下命令完成初始化并启动：

qwenpaw init --defaults
qwenpaw app

2.3 Pip安装方式

如需使用pip直接安装：

pip install qwenpaw
qwenpaw init --defaults
qwenpaw app

2.4 桌面端安装（Windows / Mac）

对于不熟悉命令行的用户，QwenPaw提供桌面端安装包：

1. 访问QwenPaw官方GitHub Releases页面
2. 找到带有“Latest”绿色标签的最新版本
3. 根据系统下载对应文件：
   • Windows用户：下载QwenPaw-Setup-<version>.exe，双击运行，一路“下一步”完成安装
   • Mac用户：下载带有-macOS.zip后缀的压缩包，解压后拖入“应用程序”文件夹

2.5 Docker部署方式

Docker部署方式可参考QwenPaw官方文档：

docker pull agentscope/qwenpaw:latest
docker run -p 8088:8088 agentscope/qwenpaw:latest

2.6 验证安装

启动后访问 http://127.0.0.1:8088/ 打开QwenPaw Console，看到控制台界面即表示安装成功。

三、QwenPaw模型配置教程

3.1 接入方式概述

QwenPaw可通过三种计费方案接入阿里云百炼模型服务：

3.2 配置Token Plan团队版

在Console中依次点击设置 > 模型，进入内置的Aliyun Token Plan提供商设置页面：

国际站用户需手动添加供应商，协议选择“OpenAI兼容（Chat Completions）”。

3.3 配置Coding Plan

进入内置的Aliyun Coding Plan提供商设置页面：

3.4 配置按量计费（DashScope）

进入内置的DashScope提供商设置页面：

各区域对应的基础URL：

• 中国（北京） ：https://dashscope.aliyuncs.com/compatible-mode/v1
• 国际（新加坡） ：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
• 美国（弗吉尼亚） ：https://dashscope-us.aliyuncs.com/compatible-mode/v1

3.5 设置默认模型

完成提供商配置后，进入设置 > 模型 > 默认LLM选择模型并保存。在聊天页面右上角的下拉菜单中可临时切换当前会话的提供商和模型。

四、QwenPaw控制台使用教程

4.1 Console界面概览

QwenPaw Console是配置和使用的核心枢纽，您可以在控制台中完成以下操作：

• 直接对话：选择模型、开启新会话、查看历史记录、上传附件
• 管理人格：为不同场景配置不同的Persona角色
• 管理记忆：查看和编辑长期记忆、短期记忆、用户画像
• 配置定时任务：让智能体在指定时间自动执行任务
• 挑选技能与插件：内置技能即开即用，插件市场一键安装
• 配置MCP工具：白名单/黑名单粒度可控

4.2 对话功能使用

在Console的聊天页面中，您可以：

• 选择不同模型进行对话
• 上传文档、图片等附件供AI处理
• 使用Magic Commands快速控制会话状态：
  • /new：开启新会话
  • /clear：清空历史记录
  • /stop：停止当前任务
  • /restart：重启服务

4.3 Persona人格配置

QwenPaw通过一组Markdown文件定义智能体的人格。这些文件决定智能体的行为风格、工作方式和个性特征：

• agent.md：定义智能体的核心身份
• soul.md：定义智能体的行为准则
• profile.md：定义用户画像

您可以根据需要自由添加、编辑或删除这些Markdown文件，为工作、学习、娱乐等不同场景配置不同人格。

五、QwenPaw多渠道接入教程

5.1 支持的渠道

QwenPaw支持一个智能体同时接入多个主流通讯工具：

• 钉钉（DingTalk）
• 飞书（Feishu）
• 微信（WeChat）
• QQ
• Discord
• Telegram
• iMessage

所有渠道共享记忆与技能，实现“一处配置，全端可用”。

5.2 绑定钉钉渠道

在Console中配置钉钉机器人：

1. 在钉钉平台创建机器人，获取Webhook与加签密钥
2. 在QwenPaw Console的渠道配置页面填入Webhook地址
3. （可选）将服务器IP加入白名单，用于调用钉钉开放API下载用户发送的图片和文件

5.3 绑定飞书渠道

飞书渠道的配置流程与钉钉类似：

1. 在飞书平台创建机器人
2. 获取飞书开放API凭证
3. 在QwenPaw Console中完成配置
4. 支持双向发送文本、图片和文件

5.4 绑定微信/QQ渠道

微信和QQ的接入可通过QwenPaw的桌面端或云端部署实现。配置完成后，QwenPaw将变成一个24小时在线的“数字分身”，可直接在微信或QQ中对话。

六、QwenPaw核心功能教程

6.1 Coding模式

QwenPaw内置三面板Web IDE，包含文件树、Diff预览与对话区。在Coding模式下：

• 聊天、文件树、编辑器同屏并排
• 智能体可帮助逐行修改代码、运行测试、查看日志
• 全过程可视化，适合代码阅读、编辑、审查与测试

6.2 记忆引擎

QwenPaw的记忆引擎采用三层记忆架构：

短期与长期记忆分层：短期记忆管理当前交互上下文，长期记忆沉淀用户偏好、习惯与关系网。

自我反思与进化：智能体会回顾自己的历史交互，主动改进策略。

跨设备记忆共享：通过AnalyticDB for PostgreSQL长记忆服务，支持云端持久化的长期记忆后端，实现跨设备共享和大规模语义检索。

6.3 定时任务（Cron）

QwenPaw支持通过Cron表达式配置定时任务：

使用场景：

• 每天早上定时推送新闻摘要
• 周期性生成报告并广播到多个频道
• 定时查询待办事项并推送结果

配置方式：

• 支持间隔字符串（如"30m"、"1h"、"90s"）
• 支持标准五字段Cron表达式（分 时 日 月 周）
• 通过qwenpaw cron命令管理任务：list/create/get/state/update/pause/resume/delete/run

6.4 MCP工具生态

QwenPaw内置MCP（Model Context Protocol）工具生态：

• QwenPaw作为MCP客户端，可连接任意外部MCP服务器
• 支持工具发现：通过HTTP API查询每个连接服务器的工具名称、描述和参数
• 支持OAuth 2.1认证、工具白名单粒度控制、流式输出
• 支持热加载：无需重启应用即可进行运行时更新

6.5 多智能体协作

QwenPaw支持创建多个独立智能体，每个智能体拥有独立配置、记忆和技能：

• 独立记忆与技能：每个智能体拥有独立的记忆空间和技能集
• Agent间通信：通过Agent Communication Protocol（ACP）实现跨系统编排
• 运行时生成子Agent：支持在运行时动态创建子智能体
• 协作完成任务：多个智能体可通过协作技能互相通信、共同完成复杂任务

6.6 技能系统

QwenPaw采用热加载架构，每个技能对应独立文件夹：

内置技能包括：

• Cron定时任务
• PDF与表单处理
• Word/Excel/PPT处理
• 新闻摘要生成
• 文件阅读

自定义技能：添加skill.md与可选脚本即可快速扩展能力，无需等待厂商更新。

七、QwenPaw部署方式教程

7.1 本地部署

本地部署是最推荐的部署方式，所有数据默认存储于本地设备：

1. 按照第二章的安装步骤完成安装
2. 启动后访问http://127.0.0.1:8088/
3. 配置模型API Key
4. 开始使用

7.2 阿里云计算巢一键部署

通过阿里云计算巢可一键将QwenPaw部署到云端：

部署步骤：

1. 进入AI尝鲜实验室的QwenPaw部署页面
2. 选择地域、实例规格和付费方式
3. 提交创建，等待状态由“部署中”变为“已部署”（通常几分钟）
4. 在实例详情页点击“安全代理访问”进入QwenPaw控制台
5. 添加模型并绑定钉钉/飞书等渠道

优势：

• 无需本地环境准备
• 浏览器打开安全代理访问地址即可配置使用
• 适合希望将数据掌握在自己手里、在多个IM渠道间统一AI入口的用户

7.3 PAI-EAS部署

通过阿里云PAI-EAS可快速部署QwenPaw：

1. 登录PAI控制台，选择目标地域和工作空间
2. 进入EAS（弹性算法服务）
3. 在推理服务页签点击“部署服务”
4. 在场景化模型部署区域点击QwenPaw部署

部署准备：

• 准备阿里云账号
• 获取百炼API Key
• 创建专有网络VPC和交换机
• 创建安全组
• 创建对象存储OSS Bucket

7.4 OOS扩展程序安装

通过阿里云OOS（运维编排服务）扩展程序可批量安装QwenPaw：

1. 在OOS控制台的公共扩展程序页签中找到QwenPaw扩展程序卡片
2. 单击“安装扩展程序”
3. 在安装面板中选择需要安装的实例
4. 获取访问信息完成配置

八、QwenPaw进阶配置教程

8.1 长记忆服务对接

QwenPaw可对接AnalyticDB for PostgreSQL长记忆服务：

配置步骤：

1. 安装QwenPaw并配置LLM模型
2. 配置AnalyticDB for PostgreSQL长记忆后端
3. 启用云端持久化的长期记忆

功能价值：

• 跨设备记忆共享
• 大规模语义检索
• AI助手在任何设备上都能“记住”用户偏好和历史交互

8.2 多智能体配置

在QwenPaw中配置多智能体协作：

1. 在Console中创建多个智能体
2. 为每个智能体配置独立的记忆和技能
3. 通过ACP协议实现智能体间通信
4. 支持运行时生成子智能体

8.3 技能开发

开发自定义技能：

1. 在技能目录中创建独立文件夹
2. 添加skill.md定义技能行为
3. 添加可选脚本实现具体功能
4. 热加载自动生效，无需重启

九、常见问题（FAQ）

Q1：QwenPaw和CoPaw是什么关系？

QwenPaw原名CoPaw，是阿里云AgentScope团队于2026年完成更名的个人AI助手。“Qwen”代表与通义千问开源生态的深度整合，“Paw”延续了项目的原始使命。

Q2：QwenPaw是免费的吗？

QwenPaw本身是开源软件（Apache-2.0协议），可免费下载和使用。但接入阿里云百炼模型服务需要通过Token Plan团队版、Coding Plan或按量计费方式付费。

Q3：QwenPaw支持哪些操作系统？

QwenPaw支持macOS、Linux和Windows操作系统。

Q4：QwenPaw的Python版本要求是什么？

需要Python 3.10至3.13版本。

Q5：QwenPaw支持哪些IM渠道？

QwenPaw支持钉钉、飞书、微信、QQ、Discord、Telegram、iMessage等多个渠道。

Q6：QwenPaw的数据存储在哪里？

QwenPaw采用本地优先策略，所有交互数据、记忆、配置默认存储于用户本地设备。也可选择云端部署并使用AnalyticDB for PostgreSQL作为记忆后端。

Q7：QwenPaw如何实现跨设备记忆同步？

通过对接AnalyticDB for PostgreSQL长记忆服务，QwenPaw支持云端持久化的长期记忆后端，实现跨设备共享和大规模语义检索。

Q8：QwenPaw的定时任务如何配置？

QwenPaw支持Cron表达式配置定时任务，可通过qwenpaw cron命令或Console界面进行管理。

Q9：QwenPaw的Coding模式是什么？

Coding模式是QwenPaw内置的三面板Web IDE，包含文件树、Diff预览与对话区，智能体可帮助阅读、编辑、审查与测试代码。

Q10：QwenPaw如何配置模型？

在Console中点击设置 > 模型，根据所选的计费方案（Token Plan团队版/Coding Plan/按量计费）配置对应的提供商和API Key。