1. PocketHook installieren#
Lade PocketHook aus dem App Store herunter und öffne es auf deinem iPhone, iPad oder Mac.
2. Deinen Server konfigurieren#
PocketHook benötigt einen HTTPS-Endpoint zur Kommunikation. Du kannst verwenden:
- Agent Server — Selbstgehosteter AI-Agent mit LLM, Tools, Hintergrundaufgaben und Speicher
- Deine eigene API — Jeder Server, der POST-Anfragen akzeptiert und JSON zurückgibt
- n8n — Selbstgehostete Workflow-Automatisierung mit Webhook-Trigger
- OpenClaw — Selbstgehosteter AI-Assistent mit Mehrkanal-Messaging
Serveranforderungen#
Dein Server muss:
- POST-Anfragen mit JSON-Body akzeptieren
- JSON-Antworten zurückgeben
- Über HTTPS erreichbar sein (HTTP wird aus Sicherheitsgründen abgelehnt)
- Optional Bearer-Token-Authentifizierung unterstützen
3. In PocketHook verbinden#
- Öffne Einstellungen → Server verwalten → Server hinzufügen.
- Gib die HTTPS-Server-URL, den Token und einen Namen ein.
- Teste die Verbindung und speichere sie.
- Wähle oben im Chat einen gespeicherten Server aus.
Mit Agent Server 0.8.0 unter macOS zeigt bun run app:qr eine einmalige Einladung an. Wähle beim Hinzufügen QR scannen oder importiere das Bild. Der Befehl kann eine vorhandene Tailscale-HTTPS-Route erkennen; Xcode Command Line Tools sind erforderlich. Ein Server ist kostenlos, mehrere erfordern Pro. QR-Anleitung und Kompatibilität.
4. Anfrageformat#
PocketHook sendet Nachrichten als JSON-Array:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "deine Nachricht hier"
}]
5. Antwortformat#
Dein Server sollte mit einem JSON-Objekt antworten:
{
"msg": "Nachricht fuer den Benutzer",
"shortcut": "OptionalerKurzbefehlName",
"data": { "schluessel": "wert" },
"url": "https://optional-url.com"
}
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
msg | string | Ja | Im Chat angezeigter Text |
shortcut | string | Nein | Auszuführender iOS Shortcut |
data | object | array | Nein | An den Shortcut übergebene Daten |
url | string | Nein | URL zum Öffnen oder Anzeigen |
Für mehrstufige Automatisierungen gib ein Array von Antworten zurück:
[
{ "msg": "Schritt 1...", "shortcut": "ErsterKurzbefehl" },
{ "msg": "Schritt 2...", "shortcut": "ZweiterKurzbefehl", "data": { "input": "wert" } }
]
6. Schnellstart mit dem Starter-Server#
Verwende unsere Starter-Server-Vorlage, um in Minuten loszulegen:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Bearbeite .env mit deinem geheimen Token
bun dev
Der Starter enthält integrierte Befehle (ping, hello, help, time) und Beispiele zum Auslösen von Shortcuts. Siehe die API-Referenz für die vollständige Protokollspezifikation.
7. Das SDK verwenden#
Installiere das pockethook-sdk-Paket, um typsichere Antworten zu erstellen:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Einfache Textantwort
return toResponse(text("Hallo von meinem Server!"));
// Einen Shortcut ausloesen
return toResponse(shortcut("Ausfuehrung...", "MeinKurzbefehl", { schluessel: "wert" }));
// Mehrstufige Automatisierung
return toResponse(responses([
{ msg: "Schritt 1", shortcut: "Erster" },
{ msg: "Schritt 2", shortcut: "Zweiter" }
]));