QwenPaw – Hướng dẫn tự host trợ lý AI cá nhân mã nguồn mở dễ cài, dễ mở rộng

Tóm tắt nhanh:

• QwenPaw là trợ lý AI cá nhân mã nguồn mở, có thể chạy ngay trên máy tính của mình hoặc deploy lên cloud chỉ với vài câu lệnh.
• Dữ liệu và memory hoàn toàn nằm dưới sự kiểm soát của mình – không upload lên server bên thứ ba, không bị khóa nền tảng.
• Kết nối đa kênh chat: DingTalk, Feishu, WeChat, Discord, Telegram, QQ (đã hỗ trợ cả voice và ASR ở v1.1.5).
• Hệ thống skill mở rộng sẵn có: lập lịch, xử lý PDF/Office, tóm tắt tin tức, và cho phép tự thêm skill tùy chỉnh.
• Hỗ trợ multi-agent collaboration, dùng được cả model API (Qwen, OpenAI, Gemini) lẫn model local (Ollama, llama.cpp, LM Studio) – không cần API key nếu chạy offline.

Mấy năm gần đây, mình dùng đủ kiểu trợ lý AI – từ ChatGPT, Claude tới Copilot. Tiện thì có tiện, nhưng càng dùng mình càng thấy gợn: lịch sử trò chuyện của mình nằm ở đâu đó trên server xa lắc, một ngày nào đó dịch vụ tăng giá, thay đổi policy, hoặc đơn giản là sập, thì mọi “ký ức” mình từng dạy nó đều biến mất. Đó là lý do mình bắt đầu tìm kiếm một giải pháp self-hosted, và sau khi thử qua khá nhiều dự án, QwenPaw chính là cái tên khiến mình quyết định gắn bó.

QwenPaw (trước đây tên là CoPaw, vừa được rebrand từ tháng 4/2026) là một trợ lý AI cá nhân mã nguồn mở do team AgentScope phát triển. Cái hay nhất của nó nằm ở triết lý: “Under your control” – nghĩa là toàn bộ memory, dữ liệu cá nhân hóa, lịch sử chat đều nằm trên máy bạn (hoặc server bạn tự chọn). Không có chuyện upload đi đâu cả.

Những điểm mình thích nhất ở QwenPaw

Mình tổng hợp lại để các bạn dễ hình dung trước khi bắt tay vào cài:

• Đa kênh, một bộ não: Chỉ cần 1 instance QwenPaw, mình có thể chat qua DingTalk lúc làm việc, Telegram lúc đi đường, và Discord lúc rảnh rỗi. Cùng một “trợ lý” hiểu mình ở mọi nơi.
• Skill mở rộng dễ dàng: Mặc định đã có sẵn skill lên lịch, xử lý PDF/Office, tóm tắt tin tức. Mình có thể viết skill riêng và QwenPaw tự load – không bị khóa.
• Multi-agent collaboration: Có thể tạo nhiều agent độc lập với vai trò khác nhau (ví dụ: 1 agent chuyên research, 1 agent chuyên viết content) rồi cho chúng nó “nói chuyện” với nhau xử lý task phức tạp.
• Memory tự tiến hóa: Càng dùng càng thông minh hơn, vì agent học từ tương tác và tự reflect.
• Multi-layer security: Tool guard, file access control, skill security scanning – mình thấy team làm khá kỹ phần này, không bị kiểu “AI tự ý xóa file”.

So với việc mình phải tự ghép Ollama + LangChain + n8n + một đống thứ lặt vặt khác, QwenPaw đóng gói sẵn mọi thứ, mà vẫn để mở cho ai muốn customize.

Hướng dẫn cài đặt QwenPaw chi tiết

Team QwenPaw chiều người dùng hết mức – họ cung cấp đến 6 cách cài, từ “không biết Python là gì” đến “developer chuyên build từ source”. Mình sẽ chia sẻ những cách phổ biến nhất.

Cách 1: pip install – cho ai đã quen Python

Đây là cách mình hay làm vì gọn nhẹ. Yêu cầu máy có sẵn Python (khuyến nghị 3.10 trở lên):

pip install qwenpaw
qwenpaw init --defaults
qwenpaw app

Xong! Mở trình duyệt vào http://127.0.0.1:8088/ là thấy Console của QwenPaw hiện ra ngay. Đơn giản đến mức mình từng tưởng mình thiếu bước nào đó.

Cách 2: Script install – không cần đụng tới Python

Nếu bạn ngại setup Python, dùng cách này. Script sẽ tự tải uv (package manager của Astral), tạo virtual environment và cài hết mọi thứ:

Trên macOS / Linux:

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

Trên Windows (PowerShell):

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

Sau khi cài xong, mở terminal mới và chạy:

qwenpaw init --defaults
qwenpaw app

Lưu ý nhỏ: nếu bạn dùng Windows LTSC hoặc môi trường doanh nghiệp có chính sách bảo mật khắt khe, PowerShell có thể chạy ở Constrained Language Mode khiến script bị lỗi. Lúc đó chịu khó add thủ công đường dẫn %USERPROFILE%\.qwenpaw\bin vào PATH là xong.

Cách 3: Docker – cho ai thích sạch sẽ và deploy server

Mình thấy đây là cách lý tưởng để deploy lên VPS hoặc home server:

docker pull agentscope/qwenpaw:latest
docker run -p 127.0.0.1:8088:8088 \
  -v qwenpaw-data:/app/working \
  -v qwenpaw-secrets:/app/working.secret \
  -v qwenpaw-backups:/app/working.backups \
  agentscope/qwenpaw:latest

Mình đặc biệt thích cách họ tách riêng 3 volume: data cho config/memory/skills, secrets cho API key, backups cho file sao lưu. Cần backup chỉ cần copy thư mục đó là xong, rất sạch.

Nếu bạn chạy Ollama trên host và muốn QwenPaw trong Docker gọi ra được, nhớ thêm --add-host=host.docker.internal:host-gateway rồi vào Settings -> Models đổi Base URL thành http://host.docker.internal:11434. Tip nhỏ này mình từng vật vã vài tiếng mới hiểu.

Cách 4: Deploy lên cloud trong 3 phút

Nếu lười cài cục bộ, QwenPaw có sẵn one-click deploy lên Alibaba Cloud ECS. Click cái là xong, hợp với ai chỉ muốn dùng ngay không muốn nghịch.

Ngoài ra còn có ModelScope Studio (cloud setup miễn phí) và Desktop Application (file .exe cho Windows, .zip cho macOS) nếu bạn ngại CLI. Bản desktop hiện đang ở giai đoạn Beta, lần đầu khởi động hơi lâu (10-60 giây) vì nó cần init Python environment, nhưng dùng được rồi thì rất sướng.

Toàn bộ tài liệu chính thức và mã nguồn mình khuyên các bạn xem tại kho lưu trữ QwenPaw trên GitHub.

Hướng dẫn sử dụng thực tế

Cài xong rồi thì dùng thế nào? Mình chia theo 3 bước cơ bản mà ai cũng nên làm.

Bước 1: Cấu hình model – chọn “bộ não” cho trợ lý

Vào http://127.0.0.1:8088/, mở Settings -> Models. Có 2 lựa chọn:

• Cloud API: Nhập API key của Qianwen (DashScope), Gemini, OpenAI, DeepSeek V4 (mới được build sẵn từ v1.1.4)… rồi enable provider tương ứng.
• Local Models: Nếu bạn đã cài Ollama hoặc LM Studio, không cần API key luôn. Chỉ cần điền Base URL như http://localhost:11434 cho Ollama là xong.

Mình thường mix: Ollama chạy Qwen local cho task riêng tư, còn Gemini cho task cần độ chính xác cao. QwenPaw quản lý hết.

Bước 2: Kết nối với ứng dụng chat

Đây là phần “chất” nhất của QwenPaw. Vào mục Channels trong Console, bạn sẽ thấy danh sách các kênh hỗ trợ: DingTalk, Feishu, WeChat (qua Padlocal/Wechaty), Discord, Telegram, QQ, thậm chí cả SIP voice channel.

Mỗi kênh chỉ cần 1 form đơn giản: bot token, app key/secret. Sau khi enable xong, nhắn tin với bot QwenPaw trên Telegram là nó trả lời ngay – và quan trọng là memory được giữ chung giữa các kênh. Tức là sáng mình kể chuyện cho nó qua DingTalk, tối lên Telegram nó vẫn nhớ.

Riêng v1.1.5 vừa thêm voice + ASR cho QQ, nên giờ nói chuyện bằng giọng nói cũng được luôn.

Bước 3: Mở rộng tính năng bằng Skill

Đây là phần mà QwenPaw khác biệt nhất so với mấy chatbot bình thường. Skill có thể coi như “plugin” – nó định nghĩa QwenPaw có thể làm gì.

Một số skill có sẵn cực hữu ích:

• Scheduling: bảo nó “8h sáng mai gửi mình bản tin AI hot nhất” – và nó tự làm.
• PDF/Office processing: gửi file PDF vào chat, nó tự đọc và tóm tắt.
• News digest: tổng hợp Xiaohongshu, Zhihu, Reddit, tóm tắt video YouTube/Bilibili.
• Email & calendar: đẩy highlight email và lịch họp về DingTalk/Feishu/QQ.

Muốn thêm skill custom? Chỉ cần đặt file vào thư mục skills, QwenPaw auto-load không cần restart. Mình từng viết một skill nhỏ để nó scrape giá Bitcoin mỗi giờ và đẩy vào Telegram, mất khoảng 30 phút là xong.

Combo “skill + scheduled task” là cách mình biến QwenPaw thành một agentic app đúng nghĩa: mô tả mục tiêu trước khi đi ngủ, sáng thức dậy đã thấy prototype, hoặc workflow chọn topic -> viết kịch bản -> tạo video chạy tự động cả đêm.

Mình đã dùng QwenPaw hơn một tháng và thật lòng mà nói: cảm giác sở hữu một trợ lý AI thực sự là của riêng mình rất khác so với việc thuê dịch vụ. Nó nhớ những thứ vụn vặt mình hay quên, tự đề xuất công việc dựa trên thói quen, và quan trọng nhất – nếu mai này mình muốn đổi model, đổi server, mọi memory vẫn còn nguyên trong tay.

Lời khuyên của mình cho ai mới bắt đầu: dùng pip install qwenpaw hoặc bản Desktop app trước để cảm nhận, kết nối với 1 kênh chat quen thuộc (mình hay khuyên Telegram vì dễ setup nhất), và đừng ngại nghịch thử skill custom. Cộng đồng dự án rất tích cực – chỉ riêng v1.1.5 đã có 5 contributor mới.

Để theo dõi roadmap, release notes mới nhất và đóng góp issue, các bạn ghé trang chính thức của QwenPaw tại agentscope-ai/QwenPaw. Một số hướng mình đang định khám phá tiếp: tích hợp QwenPaw với home automation (Home Assistant), dùng nó như một layer trung gian giữa Obsidian vault và LLM để xây personal knowledge base, hoặc thử mode multi-agent collaboration để tự build một “team AI” chuyên xử lý content. Nếu bạn cũng đang đi cùng hướng, ới mình một tiếng nhé – cafe mình mời.