# PicoClaw

Kompakter Agent in Go mit Weboberfläche und Unterstützung kleiner Rechner.

Kanonisches Profil: https://ki-agentenkompass.de/agenten/picoclaw/
Redaktion: [Michael Meierhoff](https://ki-agentenkompass.de/ueber-mich/)
Quellenabgleich: 2026-10-16
Basis: Anbieter-Dokumentation. Praxisbeispiele sind redaktionelle Vorschläge, keine eigenen Produkttests.

## Einordnung

PicoClaw wird als eigenständiges Produktprofil geführt.

- Anbieter: Sipeed
- Produktfamilie: PicoClaw
- Profiltyp: Selbst betriebener persönlicher Agent
- Umgebung: Eigener Rechner oder Server
- Verbindungen: Werkzeuge und Kanäle nach Konfiguration
- Einrichtung: Passendes Release laden; Modellanbieter und Chatkanal konfigurieren.
- Kostenmodell: Offener Quellcode; Modell- und Betriebskosten separat.

## Kernfunktionen

### Einrichtung im Browser

Der Launcher öffnet eine Weboberfläche für Konfiguration und Chat.

Quelle: https://github.com/sipeed/picoclaw

### MCP verbinden

Externe MCP-Werkzeuge erweitern die Fähigkeiten.

Quelle: https://github.com/sipeed/picoclaw

### Bilder übergeben

Bilder an kompatible multimodale Modelle übergeben.

Quelle: https://github.com/sipeed/picoclaw

### Modelle zuordnen

Regeln ordnen Anfragen unterschiedlichen Modellen zu.

Quelle: https://github.com/sipeed/picoclaw

### Kleine Rechner nutzen

Releases unterstützen verschiedene Prozessorarchitekturen.

Quelle: https://github.com/sipeed/picoclaw

## Redaktionelle Praxisbeispiele

### Einen kleinen Rechner einrichten

- Du gibst vor: Ein unterstützter Rechner und ein Modellzugang.
- Mögliches Ergebnis: Ein erster Chat über den eingerichteten Gateway.
- Das prüfst du: Inhalte, Zugriffsrechte und ausgeführte Schritte prüfen.

### Ein Bild auswerten lassen

- Du gibst vor: Ein unkritisches Bild und ein kompatibles Modell.
- Mögliches Ergebnis: Eine Bildbeschreibung zur eigenen Prüfung.
- Das prüfst du: Zeitaufwand, Korrekturen und Kosten festhalten.

## Voraussetzungen und Grenzen

### Einrichtung

Voraussetzung: Modell, Kanäle und Rechte selbst einrichten.

Quelle: https://github.com/sipeed/picoclaw

### Deutsch im Alltag

Noch offen: Durchgängige deutsche Bedienung und Ergebnisqualität wurden hier nicht geprüft.

Quelle: https://github.com/sipeed/picoclaw

### Zuverlässigkeit

Noch offen: Erfolgsquoten konkreter Abläufe wurden hier nicht gemessen.

Quelle: https://github.com/sipeed/picoclaw

## Passt, wenn …

- du einen Agenten als einzelne Go-Binary auf kleinen Rechnern mit ARM, RISC-V oder MIPS betreiben möchtest
- du eigene Modell-Schlüssel oder lokale Modelle über Ollama oder vLLM verwenden willst
- du ihn über Telegram, Discord, Slack oder andere der über 19 Chat-Kanäle ansprechen möchtest

## Passt eher nicht, wenn …

- du eine produktionsreife Lösung brauchst; die README warnt vor Einsatz vor Version 1.0
- du Administratorfreigabe auf Organisationsebene brauchst; die geprüften Seiten beschreiben keine

Redaktionelle Einschätzung auf Basis der Anbieterangaben. Kein Produkttest.

## Nutzbare KI-Modelle

Frei wählbar

Du trägst in der Modellliste Anbieter mit eigenem Schlüssel ein, dazu OpenRouter, LiteLLM oder über api_base einen OpenAI-kompatiblen Endpunkt. Lokal laufen Modelle über Ollama, LM Studio oder vLLM.

- Genannte Modellfamilien: OpenAI (GPT), Anthropic (Claude), Google (Gemini), DeepSeek, Alibaba (Qwen), Moonshot (Kimi), MiniMax, Z.ai (GLM), Mistral · Weitere Modelle frei anbindbar
- Modellwahl: Du wählst
- Eigener API-Schlüssel: Ja
- Router oder eigener Endpunkt: Ja
- Lokale Modelle: Ja

Belegt · Quellen abgerufen am: 2026-11-05

- [PicoClaw: Providers & Models](https://github.com/sipeed/picoclaw/blob/main/docs/guides/providers.md)

- [PicoClaw: README](https://github.com/sipeed/picoclaw)

## Europa & regionale Verfügbarkeit

Installationsanleitung und Modellvoraussetzungen geprüft. Die Einordnung betrifft den beschriebenen lokalen Betriebsweg; eine vollständige Länder- und Funktionsfreigabe aller angebundenen Dienste bleibt offen.

Geprüfter Umfang: Lokale Software und dokumentierter Selbstbetrieb; externe Dienste separat
Sichtung am: 2026-10-19

### Selbstbetrieb mit eigenem Modellzugang

Mit Voraussetzungen

PicoClaw bietet lokale Binärdateien und Docker-Betrieb. Der dokumentierte Start richtet einen LLM-API-Schlüssel und gegebenenfalls einen Chatkanal ein; deren Länderfreigaben separat prüfen.

Betroffene Region: Europa: eigener Rechner oder Server; Modelldienste landesspezifisch

Belegter Grund: Technische Einordnung aus Installation und Anbieterwahl. Eine rechtliche Ursache für regionale Einschränkungen ist in diesen Quellen nicht belegt.

Offizielle Quelle: https://raw.githubusercontent.com/sipeed/picoclaw/main/README.md

## Konten & Berechtigungen

Angaben aus Anbieter-Dokumentation. Rechte hängen von Konto, Integration und Organisationsrichtlinien ab. Prüfe vor dem Einsatz die tatsächlich angeforderten Berechtigungen.

Betrachtete Konfiguration: Selbst betriebene PicoClaw-Instanz (Go-Binary) mit eigenen Modell-Schlüsseln und Chat-Kanälen
Quellenstand: 2026-11-05

### Verwendetes Konto

Dokumentiert: Modellzugänge trägst du als API-Schlüssel ein; sie werden aus der Datei .security.yml geladen, getrennt von der Hauptkonfiguration. Der Telegram-Kanal nutzt einen Bot-Token, einige Kanäle wie WhatsApp und Weixin lassen sich per QR-Scan koppeln. Einige Modellanbieter nutzen stattdessen OAuth.

Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md
Nachweis: https://github.com/sipeed/picoclaw

### Admin-Freigabe

In geprüften Quellen offen: Eine Organisations- oder Administratorfreigabe nennen die geprüften Seiten nicht. Die Konfigurationsseite zeigt für Telegram eine Liste erlaubter Nutzer-IDs (allow_from), für andere Kanäle beschreibt sie keine Zugriffsregeln.

Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md

### Datenzugriff & Teamfreigaben

Dokumentiert: Befehle und Dateizugriff des Exec-Tools sind standardmäßig auf das Arbeitsverzeichnis beschränkt (restrict_to_workspace ist standardmäßig an). Gespräche liegen unter sessions/, Langzeitgedächtnis unter memory/. Wie viel Gedächtnis Chats, Nutzer und Threads teilen, steuert session.dimensions.

Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md

## Preise und enthaltene Nutzung

Preisstand: 2026-10-16

Offener Quellcode; Modell- und Betriebskosten separat.

Gesamtkosten hängen von Zugang, Nutzung und Konfiguration ab.

Preise und Tarifdetails: https://github.com/sipeed/picoclaw

## Betrieb & Betreuungsbedarf

Basis: öffentliche Anbieter-Dokumentation. Einschätzungen sind redaktionelle Ableitungen aus den genannten Eigenschaften. Tatsächlicher Zeitaufwand und Zuverlässigkeit wurden nicht gemessen.

Betrachtete Betriebsform: Selbst betriebenes Gateway auf eigenem Rechner oder Server
Quellenstand: 2026-11-05

### Dateien und Arbeitsstand

Dokumentiert: Das Arbeitsverzeichnis (Standard ~/.picoclaw/workspace) enthält sessions, memory, state, cron und skills. Zeitgesteuerte Aufträge liegen in <Arbeitsverzeichnis>/cron/jobs.json. Änderungen an den Dateien AGENT.md, SOUL.md, USER.md und MEMORY.md werden zur Laufzeit erkannt, ein Neustart ist nicht nötig.

Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md
Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/reference/cron.md

### Anmeldungen

In geprüften Quellen offen: Die geprüften Seiten sagen nicht, wie lange Bot-Token oder Modell-Schlüssel gültig bleiben oder was bei Ablauf geschieht. Das hängt vom jeweiligen Anbieter ab.

Nachweis: https://github.com/sipeed/picoclaw

### Start weiterer Läufe

Dokumentiert: Weitere Läufe starten per Chatnachricht, per Cron-Auftrag oder per Heartbeat. Cron-Aufträge gibt es als einmalige, Intervall- oder Cron-Ausdruck-Zeitpläne über das Cron-Tool; die Kommandozeile kennt nur wiederkehrende Aufträge. Der Heartbeat liest standardmäßig alle 30 Minuten HEARTBEAT.md (einstellbar) und lässt sich abschalten.

Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/reference/cron.md
Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md

### Menschliche Eingriffe

Bedingt dokumentiert: Cron-Aufträge mit Shell-Befehlen sind begrenzt: Remote-Kanäle brauchen eine Erlaubnisliste (standardmäßig leer), und bei allow_command=false läuft ein Befehlsauftrag nur mit command_confirm. Eine allgemeine Freigabe jeder Aktion beschreiben die geprüften Seiten nicht; die README nennt Approval-Hooks im Hook-System.

Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/reference/cron.md
Nachweis: https://github.com/sipeed/picoclaw
Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md

### Fehler erkennen

In geprüften Quellen offen: Das Log-Level steuerst du über gateway.log_level (Standard warn). Ist die Befehlsausführung deaktiviert, melden bestehende Cron-Befehle beim Auslösen einen Fehler. Eine übergreifende Fehlerübersicht beschreiben die Seiten nicht; die Troubleshooting-Seite behandelt nur zwei Modell-Fehler.

Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/operations/troubleshooting.md
Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/reference/cron.md
Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md

### Nach Fehlern fortsetzen

In geprüften Quellen offen: Cron-Aufträge und Sitzungen liegen als Dateien im Arbeitsverzeichnis; einmalige Aufträge werden nach dem Lauf gelöscht, wiederkehrende bleiben bestehen. Wiederholung, Nachholen verpasster Läufe oder Wiederaufnahme nach einem Neustart beschreiben die geprüften Seiten nicht. Für Befehlsaufträge gilt ein Timeout (Standard fünf Minuten).

Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/reference/cron.md
Nachweis: https://github.com/sipeed/picoclaw/blob/main/docs/operations/troubleshooting.md

### Redaktionelle Einschätzung

PicoClaw betreibst und wartest du selbst; Zustand liegt in Dateien, Fehlerbehandlung und Wiederaufnahme sind kaum dokumentiert. Die README rät, vor Version 1.0 nicht produktiv einzusetzen.

## Gedächtnis und Gesprächskontinuität

Geltungsbereich: Workspace-Memory im aktuellen Quellcode
Quellen abgerufen: 2026-11-04

Langzeitdatei und Tagesnotizen liefern dateibasierten Kontext.

### Speicherort und Umfang

Belegt: Im Workspace liegen memory/MEMORY.md und Tagesnotizen unter memory/YYYYMM/YYYYMMDD.md; Schreibvorgänge erfolgen atomar.

- [MemoryStore implementation](https://raw.githubusercontent.com/sipeed/picoclaw/main/pkg/agent/memory.go)

### Auswahl und Speicherzeitpunkt

Teilweise belegt: Der Code bietet Schreiben und Anhängen; konkrete automatische Faktenauswahl und deren Auslöser sind dort nicht festgelegt.

- [MemoryStore implementation](https://raw.githubusercontent.com/sipeed/picoclaw/main/pkg/agent/memory.go)

### Einsicht, Bearbeiten und Löschen

Belegt: Lokale Memory-Dateien können gelesen, bearbeitet und gelöscht werden; Änderungen an Workspace-Dateien werden bei folgenden Anfragen berücksichtigt.

- [MemoryStore implementation](https://raw.githubusercontent.com/sipeed/picoclaw/main/pkg/agent/memory.go)
- [Configuration guide](https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md)

### Agenten- und Kanalgrenzen

Teilweise belegt: MemoryStore bindet an den konfigurierten Workspace. Feine Benutzer- und Kanaltrennung der Memory ist im Modul nicht beschrieben.

- [MemoryStore implementation](https://raw.githubusercontent.com/sipeed/picoclaw/main/pkg/agent/memory.go)

### Wiederabruf

Belegt: GetMemoryContext kombiniert die Langzeitdatei mit Tagesnotizen der letzten drei Tage; ein Vektorabruf ist darin nicht enthalten.

- [MemoryStore implementation](https://raw.githubusercontent.com/sipeed/picoclaw/main/pkg/agent/memory.go)

### Session-Reset und Compaction

Teilweise belegt: Memory-Dateien sind von gespeicherten Sitzungen getrennt. Reset- und Verdichtungsfolgen für Memory sind in den geprüften Quellen nicht spezifiziert.

- [MemoryStore implementation](https://raw.githubusercontent.com/sipeed/picoclaw/main/pkg/agent/memory.go)
- [Configuration guide](https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md)

## Rahmen

Modell, Kanäle und Rechte selbst einrichten.

Anbieterquellen geprüft; Beispiele sind redaktionell. Keine eigenen Praxistests.

## Offene Punkte

Voraussetzungen und Grenzen, noch offen:
- Deutsch im Alltag
- Zuverlässigkeit

## Quellen

- https://github.com/sipeed/picoclaw

## Anbieter

Veröffentlicht PicoClaw und die verlinkten Produktinformationen.

- Betreiber: Sipeed
- Organisation: Open-Source-Projekt
- Website: https://github.com/sipeed/picoclaw
- Stand: 2026-10-16

- Anbieterquelle: https://github.com/sipeed/picoclaw

[Quellen und Methode](https://ki-agentenkompass.de/quellen/)
