PicoClaw Installations- und Konfigurationsanleitung: Dein persönlicher KI-Assistent in drei Schritten

10 Min. Lesezeit

Von Systemanforderungen bis zur Multi-Plattform-Bot-Konfiguration, von Docker-Deployment bis hin zu Cron-Jobs: Die vollständige PicoClaw-Anleitung deckt alle Szenarien ab.

Systemanforderungen

PicoClaw stellt nur sehr geringe Anforderungen an die Hardware:

  • Betriebssystem: Linux / macOS / Windows (WSL2)
  • Architektur-Unterstützung: x86_64 / ARM64 / RISC-V
  • Mindestspeicher: 64 MB (empfohlen: 512 MB oder mehr)
  • Abhängigkeiten: LLM API Key (ohne Konfiguration ist kein KI-Chat möglich)

Unterstützte Plattformen: macOS, Linux, Windows (WSL2), Raspberry Pi, Docker

Schritt 1: Repository klonen

Öffne dein Terminal und führe den folgenden Befehl aus:

bash
git clone https://github.com/sipeed/picoclaw.git

Nachdem der Klonvorgang abgeschlossen ist, wechsle in das Projektverzeichnis:

bash
cd picoclaw

Schritt 2: Konfiguration initialisieren

Führe den Befehl onboard aus, um die Initialisierung zu starten:

bash
picoclaw onboard

Folge den Anweisungen, um die Konfiguration abzuschließen:

  1. LLM API Key: Gib den API-Key deines LLM-Anbieters ein.
  2. Modell-Einstellungen: Wähle das bevorzugte KI-Modell aus.
  3. Messaging-Plattform-Token (optional): Falls du Integrationen für Telegram, Discord, QQ oder DingTalk nutzen möchtest, gib hier die entsprechenden Bot-Token ein.

Die Konfigurationsdatei wird lokal gespeichert. Alle Daten verbleiben auf deinem Gerät und werden nicht in die Cloud hochgeladen.

Schritt 3: Chat starten

Sobald die Konfiguration abgeschlossen ist, kannst du mit der KI chatten.

Interaktiver Modus

bash
picoclaw agent

Startet die interaktive Chat-Oberfläche, in der du kontinuierlich Nachrichten senden und Antworten erhalten kannst.

Einmaliger Abfrage-Modus

bash
picoclaw agent -m "Hallo, stell dich bitte kurz vor"

Sendet eine einzelne Nachricht, empfängt die Antwort und beendet das Programm – ideal für die Verwendung in Skripten.

Gateway-Dienst starten

Zur Nutzung auf Messaging-Plattformen wie Telegram oder QQ:

bash
picoclaw gateway

Nach dem Start kannst du über die Bots der jeweiligen Plattformen mit PicoClaw interagieren.

Multi-Plattform-Bot-Konfiguration

Telegram Bot

Suche in Telegram nach @BotFather, sende /newbot, um einen Bot zu erstellen und einen Token zu erhalten. Trage diesen Token in die Konfigurationsdatei ein und starte picoclaw gateway.

Discord Bot

Erstelle eine Anwendung im Discord Developer Portal, rufe den Token in den Bot-Einstellungen ab, lade den Bot auf deinen Server ein und trage den Token in die Konfiguration ein.

QQ Bot

Registriere einen Bot gemäß der Dokumentation der QQ Open Platform, rufe AppID und Token ab und trage diese in die Konfigurationsdatei ein.

DingTalk Bot

Erstelle eine Bot-Anwendung auf der DingTalk Open Platform, rufe Webhook-URL und Secret ab und trage diese in die Konfigurationsdatei ein.

Docker-Deployment

PicoClaw unterstützt Docker, was ideal für Server oder Umgebungen ohne Desktop-Oberfläche ist:

bash
docker pull ghcr.io/sipeed/picoclaw:latestdocker run -d   --name picoclaw   -v /path/to/config:/config   -e PICOCLAW_API_KEY=your_key   ghcr.io/sipeed/picoclaw:latest

Cron-Job-Konfiguration

PicoClaw verfügt über eine integrierte Cron-Unterstützung, die über die Konfigurationsdatei verwaltet wird.

Einmalige Erinnerung

yaml
tasks:  - type: reminder    time: "1h"    message: "Meeting-Erinnerung: Wöchentliches Team-Meeting"

Periodische Aufgaben

yaml
tasks:  - type: cron    schedule: "0 8 * * *"    message: "Tägliche Arbeitszusammenfassung erstellen"

Häufig gestellte Fragen (FAQ)

Benötigt PicoClaw eine Internetverbindung?

PicoClaw kann grundsätzlich offline ausgeführt werden, aber für den Aufruf von LLM-APIs und die Integration von Messaging-Plattformen ist eine Internetverbindung erforderlich.

Welche LLM-Anbieter werden unterstützt?

Unterstützt werden OpenRouter, Zhipu AI, Anthropic, OpenAI, DeepSeek, Groq und weitere. Diese können flexibel über die Konfigurationsdatei gewechselt werden.

Wie aktualisiere ich PicoClaw?

Wechsle in das Projektverzeichnis, führe git pull aus, um den neuesten Code zu laden, und kompiliere das Programm anschließend neu.

Wo werden die Daten gespeichert?

Alle Chat-Verläufe und Konfigurationsdaten werden im lokalen Dateisystem gespeichert und liegen vollständig in deiner Hand.

Wie groß ist das Docker-Image?

Das Docker-Image von PicoClaw ist etwa 15 MB groß und damit deutlich kleiner als die 350 MB+ der Konkurrenzprodukte.

Kann es auf einem Raspberry Pi ausgeführt werden?

Ja, PicoClaw unterstützt die ARM64-Architektur und läuft flüssig auf einem Raspberry Pi 4 (4 GB+ RAM).

Wie konfiguriere ich mehrere Bots gleichzeitig?

Füge einfach die Token und Konfigurationseinträge für die jeweiligen Plattformen in die Konfigurationsdatei ein. Beim Start von picoclaw gateway werden dann alle Bots gleichzeitig aktiviert.