PicoClaw Gemini API Anleitungsdokumentation

PicoClaw ist ein ultraleichter KI-Assistent, der auf Hardware für 10 Dollar läuft und weniger als 10 MB Speicher benötigt. Dieses Tutorial erklärt, wie man die Gemini API für PicoClaw konfiguriert.

Einleitung

PicoClaw unterstützt mehrere Möglichkeiten, auf die Gemini API zuzugreifen:

• Defapi Plattform (empfohlen): 50% Rabatt, kein Umgehung nötig, direkt aus dem Inland zugänglich
• Offizielle Google Gemini API: Direkte Verbindung zu den offiziellen Diensten
• OpenRouter: Zugriff über einen Drittrouter

Methode 1: Defapi (empfohlen)

Defapi ist eine Aggregationsplattform für KI-APIs, die nur die Hälfte des offiziellen Preises kostet, sehr geeignet für persönliche Entwickler und kleine Projekte. Das Gemini-Modell von Defapi ist kompatibel mit dem OpenAI v1/chat/completions-Protokoll und kann direkt verwendet werden.

1. Defapi API Schlüssel erhalten

1. Besuchen Sie die Defapi Webseite und registrieren Sie sich
2. Erhalten Sie den API-Schlüssel im Benutzerzentrum

2. PicoClaw konfigurieren

Bearbeiten Sie die Konfigurationsdatei ~/.picoclaw/config.json:

{
  "agents": {
    "defaults": {
      "model": "google/gemini-2.0-flash"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "Ihr Defapi-Schlüssel",
      "api_base": "https://api.defapi.org"
    }
  }
}

3. Unterstützte Gemini Modelle

4. Vorteile von Defapi

• 50% Rabatt: 50% günstiger als der offizielle Preis
• Kein Umgehung nötig: Direkt aus dem Inland zugänglich
• Stabil und schnell: Unternehmensgrad stabiler Service
• Gute Kompatibilität: Kompatibel mit dem OpenAI v1/chat/completions-Protokoll

---

Methode 2: Offizielle Gemini API

1. API Schlüssel erhalten

1. Besuchen Sie Google AI Studio
2. Erstellen Sie einen API-Schlüssel

2. PicoClaw konfigurieren

{
  "agents": {
    "defaults": {
      "model": "gemini-2.0-flash"
    }
  },
  "providers": {
    "gemini": {
      "api_key": "Ihr-Gemini-API-Schlüssel"
    }
  }
}

Bei Bedarf einen Proxy:

{
  "providers": {
    "gemini": {
      "api_key": "Ihr-Gemini-API-Schlüssel",
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

---

Methode 3: OpenRouter

1. API Schlüssel erhalten

Besuchen Sie OpenRouter um Ihren API-Schlüssel zu erhalten.

2. PicoClaw konfigurieren

{
  "agents": {
    "defaults": {
      "model": "google/gemini-2.0-flash"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx"
    }
  }
}

Bei Bedarf einen Proxy:

{
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx",
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

---

Überprüfen, ob PicoClaw normal funktioniert

Methode 1: Direkter Nachrichtentest

# In das PicoClaw-Verzeichnis wechseln
cd picoclaw

# Testen, ob Gemini normal funktioniert
picoclaw agent -m "Hallo, bitte antworte mit hello"

Wenn eine normale Antwort zurückkommt, war die Konfiguration erfolgreich!

Methode 2: Gateway-Test starten

# Gateway starten
picoclaw gateway

# Dann über den konfigurierten Chatkanal (Telegram/Discord usw.) eine Nachricht senden, um zu testen

Methode 3: Protokoll ansehen

# PicoClaw-Protokoll ansehen
docker compose logs -f picoclaw-gateway

---

Häufige Anwendungsfälle für PicoClaw

1. Intelligenter Gesprächsassistent

Konfigurieren Sie einen Telegram- oder Discord-Bot, um einen stets verfügbaren KI-Gesprächsassistenten zu kreieren.

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "IHR_BOT_TOKEN"
    }
  }
}

2. Code-Überprüfungsassistent

PicoClaw kann Code-Dateien lesen und bei der Überprüfung und Optimierung des Codes helfen.

# Lassen Sie die KI den Code überprüfen
picoclaw agent -m "Bitte überprüfen Sie die Codequalität der Datei src/main.go"

3. Dokumentationserstellung

Nutzen Sie die KI, um automatisch Projektdokumentationen, API-Dokumentationen usw. zu erstellen.

# README erstellen
picoclaw agent -m "Erstelle ein README.md für dieses Projekt"

4. Geplante Aufgaben

Konfigurieren Sie Herzschlagaufgaben, damit die KI regelmäßig Prüfungen oder Berichte durchführt.

{
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

5. Mehrkanalbereitstellung

Konfigurieren Sie mehrere Chatkanäle gleichzeitig, um einen plattformübergreifenden KI-Assistenten zu realisieren.

{
  "channels": {
    "telegram": { "enabled": true },
    "discord": { "enabled": true },
    "qq": { "enabled": true }
  }
}

---

Häufig gestellte Fragen

1. Rückmeldung „kein API-Schlüssel konfiguriert“

Überprüfen Sie, ob der api_key in der Konfigurationsdatei korrekt eingetragen ist.

2. Modell nicht unterstützt

Stellen Sie sicher, dass der verwendete Modellname korrekt ist, versuchen Sie, das Standardmodell gemini-2.0-flash zu verwenden.

3. Netzwerkverbindungsprobleme

Wenn ein Proxy benötigt wird, fügen Sie das Feld proxy in der entsprechenden Anbieter-Konfiguration hinzu.

---

Verwandte Links

• PicoClaw offizielle Repository
• Defapi Webseite
• Google AI Studio
• OpenRouter