FAQ

Schnell Antworten finden und weiterkommen.

Sicherheit & Datenschutz

Ist mein API-Schlüssel sicher?

API-Schlüssel werden nur auf Ihrem Rechner gespeichert (unter ~/.openclaw/). Sie werden nicht auf unsere Server hochgeladen. Auch im Cloud-Modus werden lokal konfigurierte Schlüssel nicht synchronisiert. Sie können Schlüssel in den Sicherheitseinstellungen einsehen.

Wo werden meine Chat-Daten gespeichert?

Standardmäßig bleiben Chats lokal. Wenn Sie sich beim Cloud-Konto anmelden, kann der Verlauf verschlüsselt geräteübergreifend synchronisiert werden. Cloud-Sync ist optional und abschaltbar.

Sammelt SPA personenbezogene Daten?

SPA sammelt keine personenbezogenen Daten zu Tracking-Zwecken. Die App läuft lokal. Cloud-Funktionen aktivieren sich erst nach Registrierung und Anmeldung und speichern nur das für Konto und von Ihnen gewählte Sync notwendige.

Kann im Cloud-Modus jemand meine Nachrichten sehen?

Im Cloud-Modus werden Nachrichten an KI-Anbieter (z. B. OpenAI, Anthropic) weitergeleitet. Wir speichern oder lesen keinen Gesprächsinhalt; es wird nur die Nutzung zur Abrechnung erfasst. Für strengere Privatsphäre nutzen Sie den lokalen Modus mit eigenen API-Schlüsseln.

SPA vs. andere OpenClaw-Setups

Wie hängt SPA mit OpenClaw zusammen?

OpenClaw ist eine Open-Source-KI-Agenten-Gateway-Engine. SPA baut darauf auf: Mit der SPA-Installation wird auch die OpenClaw-Engine installiert — kein manuelles Abhängigkeits-Setup. SPA ergänzt eine vollständige GUI, Cloud-Anmeldung, Ein-Klick-Installation und Auto-Updates.

Wie unterscheidet sich SPA von anderen gehosteten OpenClaw-„Cloud“-Produkten?

Viele gehostete Setups laufen das Gateway serverseitig für Teams. SPA hält das Gateway auf Ihrem Rechner für lokale Daten zuerst, bietet eine ausgereifte Desktop-App (ohne CLI), Cloud-Konten mit optionalem schlüssellosem Nutzen und Sync sowie Ein-Klick-Install ohne eigenes Node.js-Setup.

Ist SPA kostenlos?

Die SPA-Desktop-App ist kostenlos herunterzuladen und zu nutzen. Im lokalen Modus zahlen Sie KI-Anbietern für API-Nutzung. Im Cloud-Modus kaufen Sie Cloud-Guthaben. Modi sind jederzeit wechselbar.

Nutzung

Wie ändere ich Sprache und Design?

Unter Einstellungen können Sie die UI-Sprache (Chinesisch/Englisch) und das Design (hell/dunkel/System) wechseln.

Welche Modelle werden unterstützt?

SPA unterstützt praktisch jede OpenAI-kompatible API: OpenAI, Anthropic, DeepSeek, Gemini, Groq, Mistral, Qwen, Moonshot, SiliconFlow, OpenRouter und mehr. Verwenden Sie eine benutzerdefinierte Basis-URL für Ihren Anbieter.

Wie erstelle ich einen Assistenten?

Gehen Sie zu KI-Assistenten → Erstellen. Namen vergeben, Modell wählen und System-Prompt schreiben. Sie können mehrere Assistenten pflegen und im Chat wechseln.

Wie funktionieren Tools und Skills?

Assistent bearbeiten → Tools: integrierte Tools (Dateien, Suche, Codeausführung usw.) aktivieren und Skills aus dem Marktplatz installieren. Der Assistent ruft aktivierte Tools bei Bedarf auf.

Feishu-Bot antwortet nicht — was prüfen?

1) Neueste App-Version in Feishu veröffentlicht (häufigster Fall). 2) Langverbindungsmodus für Ereignisse. 3) im.message.receive_v1 hinzugefügt. 4) im:message und im:message:send_as_bot erteilt. 5) SPA läuft und Gateway ist verbunden.

Umgebung

Installation schlägt mit Netzwerkfehler fehl

Das Setup lädt Node.js und die OpenClaw-Engine. Bei schlechtem Netz versucht die App automatisch Spiegel. Sie können unter Einstellungen → Proxy einen HTTP-Proxy setzen.

Muss ich Node.js selbst installieren?

Nein. SPA bringt eine eigene Node.js-Runtime mit und kollidiert nicht mit einer System-Installation.

Wo liegen die Datenverzeichnisse?

Engine- & Gateway-Daten: ~/.openclaw/ (Windows: unter Ihrem Benutzerordner .openclaw). App-Einstellungen: ~/Library/Application Support/spaclaw auf macOS, %APPDATA%\spaclaw auf Windows. Die App installiert sich am üblichen Applications-Ort.

Fehlerbehebung

Ich hänge fest — was ist der „Nuklear“-Reset?

SPA vollständig beenden (inkl. Tray). ~/.openclaw/ und den App-Support-Ordner löschen (macOS: ~/Library/Application Support/spaclaw, Windows: %APPDATA%\spaclaw). Neueste Build von der Website neu installieren. Löscht Konfiguration und Daten.

Gateway zeigt dauernd getrennt

Prüfen Sie, ob Port 18789 frei ist; starten Sie das Gateway in den Einstellungen neu; lesen Sie Logs auf der Debug-Seite. Wenn es bleibt, versuchen Sie die saubere Neuinstallation oben.

Weißer Bildschirm beim Start

Selten. Vollständig beenden und neu starten. Wenn es wiederholt auftritt, ~/.openclaw/ und den spaclaw-App-Support-Ordner entfernen und erneut starten, um den Setup-Assistenten zu wiederholen.

Wie deinstalliere ich vollständig?

App deinstallieren (Windows: Apps; macOS: SPA.app in den Papierkorb). Dann ~/.openclaw/ und den spaclaw-Application-Support-Ordner löschen. Keine Datenreste.

macOS: OpenClaw zurücksetzen und Setup-Assistent erneut

Ausführen: rm -rf ~/.openclaw und rm -rf ~/Library/Application\ Support/spaclaw. Die zweite Zeile löscht das „Assistent abgeschlossen“-Flag. SPA erneut öffnen, um den Assistenten zu starten. /Applications/SPA.app entfernen, wenn die App auch weg soll.