一、QwenPaw 概述1.1 什么是 QwenPawQwenPaw原名 CoPaw是 AgentScope 团队开源的个人 AI 助手。名称中的“Qwen”代表与通义千问Qwen开源生态的深度整合。它采用AgentScope和AgentScope Runtime构建后端通过FastAPI提供 RESTful 接口和 SSE 流式推送前端控制台采用Vue Vite构建。QwenPaw 的核心定位是本地优先、数据自主、可自托管的个人 AI 智能体。它支持本地或云端部署可通过 Token Plan 个人版/团队版、Coding Plan 或按量计费接入阿里云百炼。1.2 核心特性记忆系统三层记忆实时工作上下文完整逐字历史记录基于 ReMe 的自我进化个人知识库部署灵活免费运行QwenPaw-Flash 模型2B/4B/9B专为 Agent 任务训练内置本地运行时无需 API Key无云端依赖同时支持 Ollama、LM Studio 及 14 云服务商安全防护内核级沙箱、Tool Guard、File Guard、Skill Scanner、访问策略多智能体与并行可生成独立智能体各自拥有独立记忆和技能支持 Agent Communication ProtocolACP跨系统编排多渠道接入支持钉钉、飞书、微信、Discord、Telegram、iMessage、QQ 等可扩展性Skills 技能系统定时任务、文档处理、浏览器、新闻等Plugin 插件架构 官方插件市场MCP 集成外部工具自动化与任务调度新闻摘要、报告生成、多频道广播等定时任务1.3 项目结构QwenPaw 源码结构如下QwenPaw/ ├── src/qwenpaw/ # Python 后端核心 │ ├── agents/ # 智能体核心QwenPawAgent 主类 │ ├── model_factory.py # LLM 模型工厂 │ ├── skills_manager.py # 技能管理器 │ ├── tool_guard_mixin.py # 工具安全拦截 │ ├── memory/ # 长期记忆管理 │ └── ... ├── console/ # 前端控制台Vue Vite └── ...二、本地部署 QwenPaw2.1 系统要求Python3.10 ~ 3.13操作系统macOS / Linux / Windows2.2 安装方式方式一一键安装脚本推荐macOS / Linuxcurl-fsSLhttps://qwenpaw.agentscope.io/install.sh|bashWindowsCMDcurl -fsSL https://qwenpaw.agentscope.io/install.bat -o install.bat install.batWindowsPowerShellirmhttps://qwenpaw.agentscope.io/install.ps1|iex脚本会自动安装 uv、创建虚拟环境并下载依赖无需手动配置 Python。方式二pip 安装pipinstallqwenpaw qwenpaw init--defaultsqwenpaw app方式三Docker 部署dockerpull agentscope/qwenpaw:latestdockerrun-p127.0.0.1:8088:8088\-vqwenpaw-data:/app/working\-vqwenpaw-secrets:/app/working.secret\agentscope/qwenpaw:latest方式四源码安装开发/测试gitclone https://github.com/agentscope-ai/QwenPaw.gitcdQwenPaw# 安装依赖并构建前端cdconsolepnpminstallpnpmrun build2.3 启动服务安装完成后在新终端执行qwenpaw app启动成功后在浏览器中访问http://127.0.0.1:8088/即可打开 QwenPaw Console。2.4 配置模型接入凭证在 Console 中点击设置 模型根据计费方案配置对应的提供商。配置 Coding Plan推荐进入内置的 Aliyun Coding Plan (International) 提供商设置页面填入 Coding Plan 专属 API Key模型已预设常用模型可直接使用配置 Token Plan 个人版点击添加提供商协议选「OpenAI 兼容Chat Completions」基础 URLhttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1填入 Token Plan 个人版专属 API Key配置 Token Plan 团队版类似个人版配置基础 URLhttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1填入团队版专属 API Key配置按量计费DashScope进入内置的 DashScope 提供商设置页面填入 API Key 即可三、将 QwenPaw 网页签入 Vue 3 项目3.1 核心思路QwenPaw 本身就是一个Vue Vite构建的前端应用前端控制台位于console/目录。将 QwenPaw 网页签入 Vue 3 项目主要有以下两种方案3.2 方案一iframe 嵌入最简单在 Vue 3 组件中使用 iframe 直接嵌入 QwenPaw Consoletemplate div classqwenpaw-container iframe srchttp://127.0.0.1:8088/ width100% height100% frameborder0 allowmicrophone; camera; clipboard-read; clipboard-write / /div /template script setup // 可根据需要动态设置 src例如从环境变量读取 const qwenpawUrl import.meta.env.VITE_QWENPAW_URL || http://127.0.0.1:8088/ /script style scoped .qwenpaw-container { width: 100%; height: 100vh; } /style注意事项确保 QwenPaw 服务已启动qwenpaw app跨域问题可通过配置 QwenPaw 的 CORS 或使用同源部署解决iframe 方式无法深度定制 UI 和交互逻辑3.3 方案二直接集成源码深度定制将 QwenPaw 的console/目录作为子模块或直接复制到你的 Vue 3 项目中。步骤 1获取 QwenPaw 前端源码# 克隆 QwenPaw 仓库gitclone https://github.com/agentscope-ai/QwenPaw.git# 前端控制台位于 console/ 目录cdQwenPaw/console步骤 2安装依赖并开发# 安装依赖pnpminstall# 启动开发服务器需要先启动后端 qwenpaw appnpmrun dev步骤 3可用的 npm 脚本命令说明npm run dev启动 Vite 开发服务器npm run build构建生产版本npm run build:tauri-bootstrap构建 Tauri 版本npm run lintESLint 检查npm run formatPrettier 格式化npm run test运行 Vitest 测试步骤 4集成到你的 Vue 3 项目将console/src中的组件、路由、状态管理等按需引入你的项目。QwenPaw 前端通过 RESTful API 和 SSE 与后端通信你可以复用其 API 调用逻辑。3.4 方案三通过 REST API 自定义前端完全自主QwenPaw 后端提供完整的 RESTful API 接口你可以完全自主开发 Vue 3 前端直接调用后端 API。核心 API 端点示例端点说明POST /api/chat发送对话消息GET /api/chat/streamSSE 流式接收回复GET /api/agents获取智能体列表POST /api/agents创建智能体GET /api/memory获取记忆内容Vue 3 调用示例// services/qwenpaw.tsimport{ref}fromvueconstBASE_URLimport.meta.env.VITE_QWENPAW_API||http://127.0.0.1:8088exportfunctionuseQwenPaw(){constloadingref(false)constmessagesref([])// 发送消息SSE 流式constsendMessageasync(message:string,onChunk:(chunk:string)void){loading.valuetruetry{constresponseawaitfetch(${BASE_URL}/api/chat/stream,{method:POST,headers:{Content-Type:application/json},body:JSON.stringify({message})})constreaderresponse.body?.getReader()constdecodernewTextDecoder()while(true){const{done,value}awaitreader?.read()||{}if(done)breakconstchunkdecoder.decode(value)onChunk(chunk)}}finally{loading.valuefalse}}return{messages,loading,sendMessage}}Vue 3 组件使用template div classchat-container div v-formsg in messages :keymsg.id {{ msg.content }} /div input v-modelinput keyup.enterhandleSend / /div /template script setup langts import { ref } from vue import { useQwenPaw } from /services/qwenpaw const input ref() const { messages, loading, sendMessage } useQwenPaw() const handleSend async () { if (!input.value.trim()) return const msg input.value input.value await sendMessage(msg, (chunk) { // 逐字追加到消息列表 const last messages.value[messages.value.length - 1] if (last?.role assistant) { last.content chunk } else { messages.value.push({ role: assistant, content: chunk }) } }) } /script四、总结维度说明项目定位个人 AI 助手本地优先、数据自主技术栈Python (FastAPI) Vue 3 Vite部署方式一键脚本 / pip / Docker / 源码默认端口8088前端集成方案iframe 嵌入 / 源码集成 / REST API 自定义QwenPaw 作为一个开源的个人 AI 智能体框架具备强大的可扩展性和灵活的部署选项。无论是作为独立应用运行还是嵌入到现有的 Vue 3 项目中都能提供完整的 AI 助手能力。建议从一键安装脚本开始快速体验再根据实际需求选择合适的集成方案。