QwenPaw: ein erweiterbarer lokaler persönlicher Assistent auf AgentScope
agentscope-ai/QwenPaw · 35.288★ · 3.129 forks
Alles Wissenswerte über agentscope-ai/QwenPaw: ein quelloffener persönlicher Assistent, der eine Web-Konsole, Terminal, Messaging-Kanäle, Gedächtnis, Skills, MCP und mehrere Agenten kombiniert, um auf einer eigenen Maschine oder in der Cloud zu laufen.
Was QwenPaw ist
QwenPaw ist ein quelloffener persönlicher KI-Assistent, gebaut vom AgentScope-Team auf Basis von AgentScope, AgentScope Runtime und ReMe. Das Repository stellt es als installierbare Anwendung für den eigenen Computer oder als Cloud-Bereitstellung vor, mit Unterstützung für mehrere Chat-Apps und erweiterbaren Fähigkeiten.
Es ist weder ein Qwen-Modell noch ein Inferenzdienst an sich. Es ist eine Produkt- und Ausführungsschicht: Sie verbindet vom Nutzer konfigurierte Modelle mit Agenten, Werkzeugen, Gedächtnis, geplanten Aufgaben und Kanälen. Der Name und der Integrationsschwerpunkt mit dem Qwen-Ökosystem sollten nicht als technische Beschränkung auf diese Modelle verstanden werden; die Dokumentation listet konfigurierbare Anbieter und Endpunkte, einschließlich OpenAI-kompatibler.
Das Projekt hieß zuvor CoPaw. Die Umbenennung zu QwenPaw wird in Community-Material als engere Integration mit dem Qwen-Ökosystem erklärt; die gefundenen Belege begründen das Rebranding, nicht eine vollständige Änderung des Ziels als persönlicher Assistent.
Der Ursprung: AgentScope wird zum persönlichen Assistenten
QwenPaw baut auf dem AgentScope-Framework auf, einer Plattform zum Erstellen von Agentenanwendungen und Multi-Agenten-Systemen, die in einer wissenschaftlichen Publikation als eine auf Nachrichtenaustausch zentrierte Architektur beschrieben wurde. QwenPaw übersetzt diese Entwicklerinfrastruktur in eine direktere Erfahrung: eine lokale Konsole, eine TUI, konfigurierbare Agenten und Verbindungen zu externen Kanälen.
Das Ergebnis liegt zwischen einem persönlichen Arbeitsbereich und einer Agenten-Laufzeitumgebung. Es kann Gespräche führen, wiederkehrende Aufgaben ausführen, Skills oder MCP auslösen und mehrere Agenten von der Oberfläche aus verwalten. Die Dokumentation deckt auch “Agententeam”-Praktiken ab, sollte also nicht als Einzweck-Chatbot verstanden werden.
Philosophie und Prinzipien
- Local-First. Der Leitfaden schlägt vor, es auf macOS, Linux oder Windows zu installieren, in Docker auszuführen oder auf der AgentScope-Plattform auszuprobieren. Der Beispielcontainer veröffentlicht nur
127.0.0.1:8088. - Ein sich entwickelnder Assistent. Die Dokumentation organisiert Gedächtnis, sich entwickelndes/proaktives Gedächtnis, Heartbeat, Cron und Kontext als Teil der operativen Kontrolle des Agenten.
- Mehrere Oberflächen. Eine einzige Installation kann über Web-Konsole, Terminal und Messaging-Apps bedient werden.
- Explizite Erweiterbarkeit. Skills, MCP, eingebaute Werkzeuge, Plugins und Agenten werden als konfigurierbare Komponenten offengelegt, statt als geschlossene Fähigkeiten.
- Konfiguration pro Nutzerin/Nutzer. Die Verwendung eines eigenen Modells, Anbieters und Kanals erlaubt es, die Installation anzupassen, verlagert aber auch Entscheidungen über Zugangsdaten, Berechtigungen und Sicherheit auf die Betreiberin bzw. den Betreiber.
Wie es funktioniert
Die lokale Installation stellt eine HTTP-Konsole auf Port 8088 bereit. Ihre Haupt-API für Gespräche ist POST /api/console/chat; sie akzeptiert eine Agenten-Kennung über X-Agent-Id, behält eine Sitzung über session_id bei und unterstützt SSE-Streaming.

Nutzerin/Nutzer / Kanal → Console, TUI oder API → QwenPaw-Agent
├─ konfiguriertes Modell
├─ Gedächtnis und Kontext
├─ Skills, MCP und Werkzeuge
├─ mehrere Agenten
└─ Arbeitsbereich und Cron-Aufgaben
Die Konsole erlaubt es, Agenten zu erstellen, zu bearbeiten, zu aktivieren, zu deaktivieren oder zu löschen. Die API basiert auf einer Erweiterung des AgentScope-Laufzeitprotokolls und erlaubt es, Nachrichten zu senden, Agenteninstanzen zu verwalten und Kanäle zu integrieren.
Hauptkomponenten
- Console und TUI. Die Web-Konsole ist die Verwaltungs- und Chat-Oberfläche; die Dokumentation veröffentlicht auch eine Terminal-Oberfläche und magische Befehle mit dem Präfix
/, um den Gesprächszustand zu steuern, ohne sich auf die Interpretation des Modells zu verlassen.


- Mehrere Agenten. Seit Version 0.1.0 dokumentiert das System Multi-Agenten-Unterstützung, mit Agentenkonfiguration und -auswahl über die Oberfläche.
- Skills und MCP. Skills liefern Verfahren; MCP und eingebaute Werkzeuge verbinden externe Dienste und Aktionen. Die Konfiguration bestimmt, was aktiviert bleibt.

- Gedächtnis, Cron und Heartbeat. QwenPaw dokumentiert Gedächtnis,
cron-Aufgaben und einen Heartbeat-Mechanismus für periodische oder proaktive Arbeit.

- Kanäle. Der Kanäle-Abschnitt bündelt die Integrationen mit Chat-Apps; jede Verbindung benötigt die Zugangsdaten und Berechtigungen des jeweiligen Anbieters.

Das Ökosystem
Die Installation kann per Skript, Desktop-App, Docker oder AgentScope Platform erfolgen. Docker Hub veröffentlicht das Image agentscope/qwenpaw; der Leitfaden verlinkt außerdem ein Alibaba-Cloud-ACR-Image für Nutzerinnen und Nutzer in China.
Das Repository pflegt Dokumentation zu Sicherheit, Backup und Wiederherstellung, CLI, Plugins, Plugin-Migration, REST-API, ACP-Integration, Beitrag und Roadmap. Diese Breite zeigt, dass das Projekt Betrieb über den Chat hinaus abdeckt, beweist aber nicht automatisch unternehmerische Reife auf allen diesen Feldern.
Es gibt eine Community-Integration für Home Assistant, seoeaa/ha-qwenpaw, zitiert in einer QwenPaw-Diskussion. Es handelt sich um ein Community-Projekt, keine offizielle Erweiterung und keine Support-Garantie des AgentScope-Teams.
Zahlen zum Repository
Erhoben: 23. August 2026, GitHub-API. Der Quellartikel für dieses Repository enthielt keine eigene Metriktabelle; diese Zahlen wurden zum Veröffentlichungszeitpunkt direkt gegen die öffentliche GitHub-API überprüft.
| Metrik | Wert |
|---|---|
| Sterne | 34.358 |
| Forks | 3.020 |
| Echte Abonnenten | 106 |
watchers_count spiegelt in der allgemeinen GitHub-Antwort die Sterne; deshalb wird subscribers_count als tatsächliche Abonnentenzahl angegeben.
Schnelleinstieg
Installation und erster Start
Die Dokumentation beschreibt mehrere Wege. Für Docker:
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

Danach öffnet sich http://127.0.0.1:8088/. Der Leitfaden trennt die Volumes: Konfiguration, Gedächtnis und Skills in qwenpaw-data; Modelle und API-Schlüssel in qwenpaw-secrets; Sicherungskopien in qwenpaw-backups.
Unter macOS und Linux bietet die Website einen Shell-Installer; zudem gibt es eine Desktop-App für Windows und macOS. Der erste Start kann dauern, während die Python-Umgebung und Abhängigkeiten initialisiert werden.
Gängige Arbeitsabläufe
- Lokaler persönlicher Assistent: die Konsole starten, einen Anbieter konfigurieren und mit dem ausgewählten Agenten chatten.
- Mehrere Agenten: Agenten über Console erstellen oder bearbeiten und einen konkreten über
X-Agent-Idin der API aufrufen. - Automatisierung: cron und heartbeat verwenden, um wiederkehrende Aufgaben auszulösen, wobei zu beachten ist, dass der Prozess oder Dienst weiterlaufen muss.
- Erweiterung: einen geprüften Skill oder MCP aktivieren, um externe Werkzeuge oder Dienste zu verbinden.
- Eigene Integration:
/api/console/chatmitsession_idverwenden, um ein Gespräch zu bewahren und Ereignisse per Streaming zu empfangen.
Wesentliche Konfiguration
- Modell und Anbieter: werden über Konfiguration/Console gewählt; OpenAI-kompatible Endpunkte werden in der Dokumentation behandelt.
- Agent:
X-Agent-Ididentifiziert den von der API aufgerufenen Agenten;defaultist der Standardwert. - Sitzung: die Wiederverwendung von
session_idermöglicht mehrstufige Gespräche. - Geheimnisse: API-Schlüssel und Modellkonfigurationen werden im separaten Volume oder Bereich für Geheimnisse in der empfohlenen Docker-Bereitstellung gespeichert.
- Web-Authentifizierung:
QWENPAW_AUTH_ENABLED=trueaktiviert das Zugriffstoken für entfernte Anfragen.
Häufige Fallstricke und Lösungen
- Die Konsole ohne Login veröffentlichen. Die API warnt, dass eine öffentliche Instanz ohne Authentifizierung Dritten Zugriff auf und Kontrolle über Agenten erlaubt. Web-Authentifizierung aktivieren, bevor sie exponiert wird.
- Sich auf den lokalen Bypass von einer anderen Maschine aus verlassen. Nur
localhost(127.0.0.1oder::1) überspringt das Token; ein entfernter Aufruf benötigtAuthorization: Bearer …, wenn das Login aktiv ist. - Ein Beispielpasswort verwenden. Der Leitfaden zeigt
admin123nur als API-Beispiel; es sollte durch eine eindeutige, robuste Zugangsdaten ersetzt werden. - Zustand in Docker verlieren. Die Volumes nicht löschen oder auslassen, wenn Gedächtnis, Skills, Schlüssel und Sicherungen erhalten bleiben sollen.
- Erwarten, dass cron bei geschlossener App funktioniert. Eine Community-Diskussion über das Systemtray weist genau darauf hin, dass lang laufende Aufgaben erfordern, dass die Laufzeitumgebung verfügbar bleibt; das ist eine Beobachtung einer teilnehmenden Person, keine offizielle Spezifikation.
Sicherheit und Vertrauensmodell
Die zentrale Sicherheitsbotschaft ist klar: Web-Authentifizierung aktivieren, wenn die Instanz dem Internet ausgesetzt ist. QwenPaw arbeitet im Einzelnutzer-Modus: Die anfängliche Registrierung erstellt ein Administratorkonto, und der Registrierungsendpunkt kann nur einmal verwendet werden.

Für den Fernzugriff wird empfohlen, das Token im Authorization-Header zu übertragen; lokale Anfragen können es absichtlich überspringen, um die CLI-Nutzung und Entwicklung zu erleichtern. Die Betreiberin bzw. der Betreiber sollte diesen Bypass bei der Entscheidung über die Netzwerkschnittstelle und Proxy-Weiterleitungen berücksichtigen.
Über die Authentifizierung hinaus sollte eine verantwortungsvolle Installation aktivierte Skills, MCP und Kanäle einschränken, Geheimnis-Volumes schützen, hinter HTTPS betreiben und die Netzwerkexposition begrenzen. Diese letzten Punkte sind operative Praktiken, abgeleitet aus der dokumentierten Oberfläche von Werkzeugen und Zugangsdaten; sie ersetzen kein offizielles Modell für Unternehmensbereitstellungen.
Wie die Community reagierte
Die auffindbaren externen Belege sind uneinheitlich und größtenteils community-getrieben. Auf GitHub gibt es Diskussionen zur Fehlerverfolgung einer 2.0.0-Vorabversion, Beitragsanfragen und Community-Treffen; das belegt Aktivität, keine gemessene Qualität.
Ein Reddit-Thread über den Wechsel von CoPaw zu QwenPaw wiederholt die Erklärung einer engeren Qwen-Integration. Ein weiterer Thread auf r/LocalLLM verzeichnete eine Anfrage zur lokalen Adoption mit drei Stimmen; ein kleines Neugiersignal, keine Rezension.
Auf Linux.do verglich eine teilnehmende Person QwenPaw mit OpenClaw und Hermes und kritisierte die Häufigkeit von Werkzeugaufrufen. Das ist eine individuelle Erfahrung, die von Modell und Konfiguration abhängen kann, weshalb sie nicht als Leistungsmessung verwendet wird.
Eine unabhängige Recherche-Seite bemerkte einen Mangel an englischsprachigen Rezensionen und spekulierte, dass die Zugkraft eher aus dem chinesischen/AgentScope-Ökosystem stammte. Das ist eine Schlussfolgerung dieser Autorenschaft, kein durch öffentliche Daten belegter Schluss.
QwenPaw im Vergleich zu anderen Ansätzen
| Ansatz | Überprüfbare Überschneidung | Überprüfbarer Unterschied |
|---|---|---|
| Ein lokaler Chat-Agent | Beide erlauben die Nutzung eines Modells über eine eigene Oberfläche. | QwenPaw fügt konfigurierbare Agenten, Kanäle, Cron, Heartbeat, Skills, MCP und eine Sitzungs-API hinzu. |
| AgentScope | QwenPaw ist auf AgentScope und dessen Laufzeitumgebung aufgebaut. | AgentScope ist die Multi-Agenten-Entwicklungsplattform; QwenPaw ist das Produkt für persönliche Assistenz, das sie nutzt. |
| CoPaw | Es ist der frühere Name des Projekts. | QwenPaw ist die aktuelle Bezeichnung; Community-Material verknüpft die Änderung mit einem stärkeren Fokus auf das Qwen-Ökosystem. |
Home Assistant + ha-qwenpaw | Beide können Teil einer Heimautomatisierung sein. | ha-qwenpaw ist eine in einer Diskussion zitierte Community-Integration, keine garantierte Kernfähigkeit. |
Anwendungsfälle und wem dieses Repository helfen kann
- Wer einen eigenen Assistenten möchte, mit lokaler Konsole, konfigurierbaren Modellen und persistentem Zustand.
- Entwicklerinnen und Entwickler, die Agenten in eine interne App integrieren, über REST-API, Sitzungen und SSE-Streaming.
- Nutzerinnen und Nutzer, die persönliche Automatisierungen benötigen, mit wiederkehrenden Aufgaben, Gedächtnis und mehreren Kanälen, und den Dienst am Laufen halten können.
- Technische Teams, die eine Gruppe von Agenten prototypisieren, auf AgentScope und eine bereits vorbereitete Produktoberfläche und -konfiguration benötigen.
Es ist nicht angebracht, es direkt dem Internet auszusetzen oder Werkzeuge und Kanäle mit weitreichenden Berechtigungen zu verbinden, ohne Authentifizierung zu aktivieren, das Netzwerk einzuschränken und Zugangsdaten und Fähigkeiten sorgfältig zu prüfen.
Ressourcen
- Repository: https://github.com/agentscope-ai/QwenPaw
- Website und Dokumentation: https://qwenpaw.agentscope.io/docs/
- Schnelleinstieg: https://qwenpaw.agentscope.io/docs/quickstart/
- REST-API: https://qwenpaw.agentscope.io/docs/api-tutorial/
- Community: https://qwenpaw.agentscope.io/docs/community/
- Diskussionen: https://github.com/agentscope-ai/QwenPaw/discussions
- AgentScope-Paper: https://arxiv.org/abs/2402.14034
Hinweis: Dieser Artikel wurde aus dem Repository, der Projektdokumentation, dem AgentScope-Paper und öffentlichen Gesprächen zusammengestellt, abgerufen am 17. August 2026. Funktionen, Kompatibilitäten und Community-Aktivität können sich mit der Zeit ändern.
Kommentare