Zum Hauptinhalt springen
  1. Dokumentation/

Einstellungsreferenz

Synchronisierung
#

PocketHook synchronisiert deine Unterhaltungen und App-Einstellungen über deine Geräte hinweg mit deinem privaten iCloud-Konto — kein PocketHook-Konto, kein Server eines Drittanbieters beteiligt.

ErfordertBei iCloud angemeldet, iCloud Drive aktiviert
Was synchronisiert wirdUnterhaltungen, Serverkonfiguration und die meisten Einstellungen
Was nicht synchronisiert wirdEinige Einstellungen sind bewusst geräteabhängig — siehe URLs automatisch öffnen weiter unten

Melde dich mit demselben iCloud-Konto auf deinem iPhone, iPad und Mac an, und alles erscheint automatisch — keine Einrichtung nötig. Deine Daten bleiben in deiner eigenen privaten iCloud-Datenbank; die Server von PocketHook sehen sie nie.

Serverkonfiguration
#

Die zentralen Verbindungseinstellungen für deinen PocketHook-Server.

Server-URL
#

TypTextfeld (URL)
StandardLeer
Gespeichert iniOS Keychain

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
#

TypSicheres Textfeld
StandardLeer
Länge10–1.000 Zeichen
Gespeichert iniOS Keychain

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
#

TypSchalter
StandardOFF

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
#

TypStepper (±5 Sekunden)
Standard5 Sekunden
Bereich1–600 Sekunden

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. Für einfache Webhook-Server sind die standardmäßigen 5 Sekunden meist ausreichend.

Ressourcen-Timeout
#

TypStepper (±10 Sekunden)
Standard60 Sekunden
Bereich30–600 Sekunden

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
#

TypSchalter
StandardOFF

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
#

TypTextfeld (URL)
StandardLeer
Sichtbar wennHealth Check ON ist

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
#

TypSchalter
StandardON

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
#

TypSlider
Standard2.0 Sekunden
Bereich0.5–10.0 Sekunden

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
#

TypSegmentierte Auswahl
Standard5 Minuten (300s)
Optionen30s, 1 Min, 2 Min, 5 Min

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
#

TypSchalter
StandardOFF

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
#

TypTextfeld (URL)
StandardLeer
Sichtbar wennPersonal UI ON ist

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#

TypSchalter
StandardON

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
#

TypSchalter
StandardON
Synchronisiert?Nein — wird auf jedem Gerät unabhängig festgelegt

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
#

TypAuswahl
StandardSystemstandard
OptionenSystemstandard, English, Español

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

Diktiersprache
#

TypAuswahl
StandardSystemgebietsschema
Optionen21 Sprachen

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

SpracheCode
Englisch (USA)en-US
Englisch (UK)en-GB
Spanisch (Spanien)es-ES
Spanisch (Mexiko)es-MX
Französischfr-FR
Deutschde-DE
Italienischit-IT
Portugiesisch (Brasilien)pt-BR
Portugiesisch (Portugal)pt-PT
Katalanischca-ES
Chinesisch (vereinfacht)zh-CN
Japanischja-JP
Koreanischko-KR
Arabischar-SA
Russischru-RU
Niederländischnl-NL
Schwedischsv-SE
Polnischpl-PL
Türkischtr-TR
Thailändischth-TH
Vietnamesischvi-VN

Hintergrundaufgaben
#

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

Hintergrundaufgaben
#

TypSchalter
StandardOFF

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
#

TypSegmentierte Auswahl
Standard15 Minuten
Optionen5 Min, 15 Min, 30 Min, 1 Std, 2 Std

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
#

TypTextfeld (URL)
StandardLeer
Sichtbar wennHintergrundaufgaben ON ist

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
#

TypTextfeld
StandardfetchPendingTasks
Maximale Länge10.000 Zeichen

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
#

TypSchreibgeschützte Anzeige
Format“X von 500 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.

FeldBeschreibung
App-VersionAktuelle PocketHook-Version (z. B. 1.0.0)
BuildBuild-Nummer dieser Version
iOS-VersioniOS-/iPadOS-Version auf deinem Gerät