Zum Hauptinhalt springen
Alle Claw API-Endpunkte erfordern eine Authentifizierung über den Authorization: Bearer sk-... Header. Basis-URL: https://api.lemondata.cc/v1/claw

​
Instanzen auflisten

GET /v1/claw/instances
Gibt alle Instanzen für die authentifizierte Organisation zurück. 
curl https://api.lemondata.cc/v1/claw/instances \
  -H "Authorization: Bearer sk-your-api-key"

{
  "instances": [
    {
      "id": "cm5abc123",
      "subdomain": "mybot",
      "url": "https://claw-mybot.lemondata.cc",
      "defaultModel": "claude-opus-4-6",
      "hasIMConfig": true,
      "status": "RUNNING",
      "paidUntil": "2026-03-10T00:00:00.000Z",
      "canRebuild": true,
      "totalPaid": 20,
      "createdAt": "2026-02-08T00:00:00.000Z"
    }
  ]
}

​
Instanz-Statuswerte

StatusBeschreibung
PENDINGGerade erstellt, wartet auf Bereitstellung
PROVISIONINGContainer wird bereitgestellt
RUNNINGInstanz ist aktiv und fehlerfrei
STOPPEDAufgrund von Ablauf gestoppt (Daten werden 7 Tage lang aufbewahrt)
FAILEDBereitstellung fehlgeschlagen (automatische Rückerstattung)
DELETEDDauerhaft entfernt

​
Instanz erstellen

POST /v1/claw/instances
Erstellt eine neue Instanz und belastet das Guthaben Ihrer Organisation mit $20 für 30 Tage.
​
subdomain
string
erforderlich
Subdomain (3-32 Zeichen, kleingeschriebene alphanumerische Zeichen + Bindestriche). Instanz-URL: https://claw-{subdomain}.lemondata.cc
​
defaultModel
string
Standard-KI-Modell (z. B. claude-opus-4-6, gpt-5.2, gemini-3-pro-preview, minimax-m2.5, kimi-k2.5)
curl -X POST https://api.lemondata.cc/v1/claw/instances \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"subdomain": "mybot", "defaultModel": "claude-opus-4-6"}'

{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "url": "https://claw-mybot.lemondata.cc",
  "status": "PENDING",
  "paidUntil": "2026-03-10T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}
Unzureichendes Guthaben gibt 402 Payment Required zurück. Stellen Sie sicher, dass Ihre Organisation über mindestens $20 verfügt, bevor Sie eine Instanz erstellen.

​
Instanz abrufen

GET /v1/claw/instances/:id
Gibt Details für eine bestimmte Instanz zurück.

​
Instanz aktualisieren

PATCH /v1/claw/instances/:id
Instanzkonfiguration aktualisieren.
​
defaultModel
string | null
Das Standard-KI-Modell ändern
​
imConfig
object | null
Konfiguration der IM-Plattform aktualisieren (Telegram, Discord, etc.)
curl -X PATCH https://api.lemondata.cc/v1/claw/instances/cm5abc123 \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"defaultModel": "claude-sonnet-4-5"}'

​
Instanz neu erstellen

POST /v1/claw/instances/:id/rebuild
Löscht und erstellt den Container neu, während die Daten (PVC) erhalten bleiben. Begrenzt auf 10 Rebuilds pro Tag. Gibt 429 Too Many Requests zurück, wenn das tägliche Limit überschritten wird.

​
Instanz verlängern

POST /v1/claw/instances/:id/renew
Verlängert den Abrechnungszeitraum um 30 Tage ($20). Wenn die Instanz aufgrund von Ablauf gestoppt wurde, wird sie automatisch neu gestartet. 
{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "status": "RUNNING",
  "paidUntil": "2026-04-09T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}

​
Statusprüfung

GET /v1/claw/health
Gibt den Status des Claw-Dienstes zurück. Keine Authentifizierung erforderlich. 
{"status": "ok", "timestamp": "2026-02-08T15:00:00.000Z"}