Einstellungsreferenz

Server verwalten

#

Unter Einstellungen → Server verwalten kannst du Profile hinzufügen, umbenennen, bearbeiten oder entfernen. Verbindung, OpenClaw-Modus, Zeitlimits, Statusprüfung, Aufgaben und Personal UI gehören zum jeweiligen Server. Ein optionales Emoji ersetzt das Standardsymbol. Ein Server einschließlich QR-Einrichtung ist kostenlos; mehrere erfordern Pro. Einrichtung, Migration und Speicherung.

Synchronisierung

#

Aktiviere Diesen Server mit iCloud synchronisieren, um Name, Emoji, Chat-Hintergrund, Farben und Deckkraft der Sprechblasen, Verbindungseinstellungen, zugestellte Nachrichten und gespeicherte Links zu teilen. Auf anderen Geräten erscheint er unter In iCloud verfügbar. Du wählst, wo du ihn hinzufügst; erst dann wird sein Verlauf geladen. Ohne Synchronisierung bleibt ein Server gerätelokal. Aktiver Server, Entwürfe und ausstehende Sendungen bleiben auf jedem Gerät unabhängig. Authentifizierungstokens werden bei aktivierter Serversynchronisierung sicher über den iCloud-Schlüsselbund synchronisiert. Aktiviere ihn auf beiden Geräten mit demselben Apple Account; Zugangsdaten können später als das Profil ankommen. Das per QR erhaltene Token muss nicht kopiert werden. Die ursprüngliche Unterhaltung behält ihre bisherige iCloud-Synchronisierung.

Server verwalten fragt iCloud beim Öffnen ab. iCloud aktualisieren startet eine erneute Abfrage und zeigt Fortschritt und letzte Prüfung. Profil, Verlauf und Zugangsdaten können zeitversetzt eintreffen. Fehlen Zugangsdaten, zeigt das Profil an, dass es auf den Schlüsselbund wartet, bevor Nachrichten gesendet werden können.

Erscheinungsbild und Navigation

#

Öffne Einstellungen → Server verwalten → dein Server → Erscheinungsbild → Stile. Wähle ein Bild aus Fotos oder Dateien, entferne es, ändere die Farben deiner Nachrichten und der Antworten oder passe die Deckkraft der Sprechblasen an. Die Vorschau zeigt das Ergebnis. Text und Bilder behalten ihre Deckkraft. Sprechblasenfarben zurücksetzen stellt die automatischen Farben wieder her.

Hintergrund auf alle Server anwenden erscheint bei mehreren Profilen und kopiert nur das Bild auf die Server, die auf diesem Gerät hinzugefügt wurden. Farben, Deckkraft und Synchronisierung bleiben je Server erhalten. Hintergrund und Farben werden nicht an den Server gesendet; iCloud überträgt sie nur für Profile mit aktivierter Synchronisierung. Diese Optionen sind kostenlos.

Mac und breite iPad-Fenster bieten eine obere Navigation oder Seitenleiste; auf dem iPhone bleiben die Tabs unten. Liquid Glass folgt den Systemeinstellungen. Transparenz reduzieren hat Vorrang vor der gewählten Deckkraft. Antwortoptionen erscheinen als Karte mit einer Zeile pro Option und der Antwortfarbe des Servers.

Fotos

#

Links zur lokalen Mediathek sind kostenlos. Aktiviere sie auf diesem Gerät, um Fotoabfragen aus dem Chat zu öffnen. iOS fragt weiterhin nach der erforderlichen Mediathek-Berechtigung; das Öffnen eines Foto-Links lädt keine Bilder hoch. Beim Senden eines angehängten Bildes geht es an den ausgewählten Server.

Serverkonfiguration

#

Die zentralen Verbindungseinstellungen für deinen PocketHook-Server.

Server-URL

#

Der HTTPS-Endpunkt, an den PocketHook deine Chat-Nachrichten sendet. Es werden nur HTTPS-URLs akzeptiert — HTTP wird aus Sicherheitsgründen abgelehnt. Dies ist der primäre Endpunkt, auf dem dein Server lauscht.

Authentifizierungs-Token

#

Bearer-Token, das mit jeder Anfrage im Authorization-Header gesendet wird. Dein Server kann damit überprüfen, dass Anfragen von deinem Gerät kommen. Sicher im iOS Keychain gespeichert — niemals im Klartext.

OpenClaw-kompatibel

#

Aktiviere dies, wenn dein Server die OpenClaw-Plattform oder eine beliebige OpenAI-kompatible Chat-Completions-API verwendet. Wenn aktiviert, sendet PocketHook Nachrichten im OpenAI-Chat-Format und parst Inline-Shortcut-Marker ([SHORTCUT:name], [DATA:{...}], [URL:...]) aus der Antwort. Ein x-openclaw-agent-id-Header wird den Anfragen beigefügt.

Verbindung testen

#

Button, der eine Testanfrage an deinen konfigurierten Server sendet. Zeigt an:

• Antwortzeit in Millisekunden
• Health-Check-Ergebnis (falls aktiviert)
• Fehlerdetails, wenn die Verbindung fehlschlägt

Verwende dies nach dem Ändern deiner Server-URL oder deines Auth-Tokens, um zu überprüfen, dass alles funktioniert.

Netzwerk

#

Feinabstimmung des Timeout-Verhaltens für verschiedene Arten von Operationen.

Anfrage-Timeout

#

Wie lange PocketHook darauf wartet, dass der Server mit der Antwort beginnt. Wenn dein Server aufwendige Verarbeitung durchführt (z. B. ein KI-Modell aufruft), erhöhe diesen Wert. Der Standardwert beträgt 60 Sekunden.

Ressourcen-Timeout

#

Maximale Zeit, bis die gesamte Antwort abgeschlossen ist, einschließlich Datenübertragung. Dieser Wert sollte höher sein als das Anfrage-Timeout. Erhöhe ihn, wenn dein Server große Payloads zurückgibt oder langsame Upload-Geschwindigkeiten hat.

Health Check

#

Aktiviert die Server-Zustandsüberwachung. Wenn aktiv, sendet PocketHook während der Verbindungstests eine GET-Anfrage an die Health-Check-URL und zeigt an, ob dein Server sich als gesund meldet.

Health-Check-URL

#

Ein separater HTTPS-Endpunkt, der als Klartext true oder false zurückgibt. Diese URL wird während der Verbindungstests abgefragt, um zu überprüfen, dass dein Server betriebsbereit ist. Nützlich, wenn dein Haupt-API-Endpunkt hinter einer Authentifizierung liegt, du aber eine einfache Statusprüfung möchtest.

Automatisierung

#

Steuere, wie PocketHook iOS-Shortcuts ausführt, die durch Serverantworten ausgelöst werden.

iOS Shortcuts

#

Hauptschalter für die Shortcut-Ausführung. Wenn OFF, zeigt PocketHook weiterhin Nachrichten vom Server an, ignoriert aber alle shortcut-Felder in den Antworten. Nützlich zum Debuggen oder um Automatisierungen vorübergehend zu deaktivieren.

Verzögerung zwischen Shortcuts

#

Wartezeit zwischen der Ausführung aufeinanderfolgender Shortcuts, wenn der Server mehrere Automatisierungen in einer einzigen Antwort zurückgibt. Erhöhe diesen Wert, wenn deine Shortcuts voneinander abhängen (z. B. der erste Shortcut eine Datei erstellt, die der zweite liest).

Shortcut-Timeout

#

Maximale Wartezeit, bis jeder einzelne Shortcut abgeschlossen ist, bevor PocketHook ihn als abgelaufen betrachtet. Lang laufende Shortcuts (z. B. solche, die Medien verarbeiten oder mehrere API-Aufrufe machen) benötigen unter Umständen die vollen 5 Minuten.

Personal UI

#

Bette eine eigene Web-Oberfläche direkt in PocketHook ein.

Personal UI

#

Zeigt einen eigenen Tab mit einer eingebetteten Web-Ansicht. Wenn aktiviert, erscheint ein neuer Tab in der Hauptnavigation, in dem deine eigene Webseite angezeigt wird. Die Seite wird für sofortige Anzeige vorgeladen und unterstützt Pull-to-Refresh.

Personal-UI-URL

#

Die URL, die im Personal-UI-Tab angezeigt wird. Sowohl HTTP als auch HTTPS werden akzeptiert (HTTPS empfohlen). Das kann ein Dashboard, ein Admin-Panel oder jede beliebige Webseite sein, auf die du neben deinem Chat schnell zugreifen willst.

Links

#

Konfiguriere, wie PocketHook mit URLs aus Serverantworten umgeht.

Links-Tab

#

Zeigt oder verbirgt den Links-Tab in der Hauptnavigation. Wenn aktiviert, werden alle von Serverantworten empfangenen URLs gespeichert und in einem eigenen Tab mit umfangreichen Link-Vorschauen, Suche und Löschfunktion angezeigt.

URLs automatisch öffnen

#

Wenn aktiviert, öffnet PocketHook URLs aus Serverantworten automatisch in deinem Standardbrowser. Wenn deaktiviert, werden URLs weiterhin im Links-Tab gespeichert (falls aktiviert), aber nicht automatisch geöffnet.

Diese Einstellung ist bewusst geräteabhängig: Du möchtest vielleicht, dass Links auf deinem iPhone automatisch geöffnet werden, aber nicht auf deinem Mac. Das Antippen der Link-Pille unter einer Nachricht öffnet sie immer, unabhängig von dieser Einstellung.

Sprache

#

Passe die App- und Diktiersprache an.

App-Sprache

#

Überschreibe die Anzeigesprache der App unabhängig von deiner Gerätesprache. Bei der Einstellung “Systemstandard” folgt PocketHook deiner iOS-Spracheinstellung.

Diktiersprache

#

Sprache für die Sprachdiktierung (Sprache-zu-Text) in der Chat-Eingabe. Verfügbare Sprachen:

Hintergrundaufgaben

#

Prüfe regelmäßig auf ausstehende Aufgaben, auch wenn die App im Hintergrund ist.

Hintergrundaufgaben

#

Aktiviert die Hintergrundabfrage. Wenn aktiv, sendet PocketHook regelmäßig eine GET-Anfrage an die Polling-URL. Ist die Antwort true, sendet es beim Öffnen der App die Abrufnachricht an deinen Hauptserver. Erfordert die Benachrichtigungsberechtigung, um dich über ausstehende Aufgaben zu informieren.

Prüfintervall

#

Wie oft PocketHook die Polling-URL im Hintergrund prüft. Kürzere Intervalle bedeuten schnellere Erkennung ausstehender Aufgaben, verbrauchen aber mehr Akku. iOS kann die tatsächliche Häufigkeit an die Gerätenutzungsmuster anpassen.

Polling-URL

#

HTTPS-Endpunkt, den PocketHook im konfigurierten Intervall abfragt. Muss als Klartext true (Aufgaben ausstehend) oder false (keine Aufgaben) zurückgeben. Dies ist eine leichtgewichtige Prüfung — dein Server sollte schnell und ohne aufwendige Verarbeitung antworten.

Agent Server: Verwende https://your-host/jobs (passe Host und Port an deine Einrichtung an).

Abrufnachricht

#

Die Nachricht, die an deinen Hauptserver gesendet wird, wenn eine Hintergrundprüfung ausstehende Aufgaben findet und die App geöffnet wird. Die Serverantwort erscheint im Chat wie jede andere Nachricht. Passe sie an, um gezieltes serverseitiges Verhalten auszulösen.

Datenverwaltung

#

Überwache und verwalte deine gespeicherten Nachrichten.

Gespeicherte Nachrichten

#

Zeigt, wie viele Nachrichten aktuell gespeichert sind. Der Indikator ist farbcodiert:

• Grün — Unter 70 % Kapazität
• Orange — 70–90 % Kapazität
• Rot — Über 90 % Kapazität

Wenn das Limit von 500 Nachrichten erreicht ist, werden die ältesten Nachrichten automatisch gelöscht, um Platz für neue zu schaffen.

Konversation exportieren

#

Button, der alle gespeicherten Nachrichten als JSON-Datei über das iOS-Teilen-Menü exportiert. Du kannst die Datei speichern, per AirDrop senden oder mit jeder App teilen. Nützlich zum Sichern von Konversationen oder zum Analysieren des Nachrichtenverlaufs.

Alle Nachrichten löschen

#

Destruktiver Button, der alle gespeicherten Nachrichten dauerhaft entfernt. Erfordert eine Bestätigung vor der Ausführung. Diese Aktion kann nicht rückgängig gemacht werden.

Über

#

Schreibgeschützte Informationen über deine PocketHook-Installation.