Was ist der OpenClaw-Skill?#
Der PocketHook-Skill für OpenClaw ermöglicht Ihrem OpenClaw-Agenten, iOS-Kurzbefehle auf Ihrem Gerät auszulösen. Wenn Sie OpenClaw bitten, eine Notiz zu erstellen, eine Playlist anzulegen oder eine Automatisierung auszuführen, fügt der Agent Markierungen in seine Antwort ein, die PocketHook erkennt und ausführt.
Frühe Version. Dieser Skill muss möglicherweise für Ihr Setup angepasst werden. Die enthaltenen Kurzbefehle sind Beispiele — Sie müssen Ihre eigenen registrieren und den Skill an Ihre PocketHook-Nutzung anpassen.
Wie es funktioniert#
- Sie senden eine Nachricht über PocketHook, die an Ihren OpenClaw-Server weitergeleitet wird
- OpenClaw verarbeitet sie mit seinem LLM und dem PocketHook-Skill
- Die Antwort enthält Inline-Markierungen wie
[SHORTCUT:New Note]und[DATA:{...}] - PocketHook erkennt die Markierungen, entfernt sie aus der angezeigten Nachricht und führt die Kurzbefehle auf Ihrem Gerät aus
PocketHook kommuniziert mit OpenClaw im OpenAI Chat Completions-Format mit dem Header x-openclaw-agent-id: main.
Einrichtung#
1. Skill installieren#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClaw lädt Skills automatisch neu — kein Neustart erforderlich.
2. PocketHook konfigurieren#
Gehen Sie in PocketHook auf Ihrem iOS-Gerät zu Einstellungen:
| Einstellung | Wert |
|---|---|
| Server-URL | Ihre OpenClaw HTTP-Proxy-URL (HTTPS) |
| Auth-Token | Ihr OpenClaw-Authentifizierungstoken |
| OpenClaw-Modus | ON |
Für Hintergrundaufgaben (optional):
| Einstellung | Wert |
|---|---|
| Hintergrundaufgaben | ON |
| Abfrage-URL | Ihr Abfrage-Endpunkt |
| Abrufnachricht | fetchPendingTasks |
Tippen Sie auf Verbindung testen zur Überprüfung.
Unterstützte Markierungen#
| Markierung | Zweck |
|---|---|
[SHORTCUT:name] oder [RUN:name] | Einen iOS-Kurzbefehl auslösen |
[DATA:{...}] | JSON-Daten an den vorherigen Kurzbefehl übergeben |
[URL:https://...] | Eine URL im In-App-Browser öffnen |
Markierungen werden am Ende der Antwort platziert und können kombiniert werden:
Creating your note and opening the recipe.
[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]
Mehrere Kurzbefehle werden nacheinander ausgeführt — PocketHook wartet auf den Abschluss jedes Kurzbefehls, bevor der nächste gestartet wird.
Eigene Kurzbefehle registrieren#
Der Skill enthält Beispiel-Kurzbefehle (New Note, newPlayList). Um eigene hinzuzufügen, bearbeiten Sie SKILL.md an drei Stellen:
1. Das Feld description#
Fügen Sie den Auslöser Ihres Kurzbefehls zur Use when:-Liste hinzu, damit OpenClaw den Skill aktiviert:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. Die Tabelle “When to Use”#
Ordnen Sie die Benutzerabsicht der Kurzbefehl-Aktion zu:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. Der Abschnitt “User’s Shortcuts”#
Dokumentieren Sie den Kurzbefehls-Namen und das Datenformat:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Hintergrundaufgaben#
PocketHook unterstützt Abfragen für asynchrone Arbeit:
- PocketHook sendet periodisch einen GET-Request an die Abfrage-URL
- Wenn die Antwort
trueist, erscheint eine Benachrichtigung - Wenn der Benutzer PocketHook öffnet, sendet es
fetchPendingTasks - OpenClaw antwortet mit den abgeschlossenen Ergebnissen (einschließlich Kurzbefehl-Markierungen)
- Wenn keine ausstehenden Ergebnisse vorliegen, antwortet es nur mit
false
Dies ermöglicht OpenClaw, lange Aufgaben (Recherche, Projekterstellung, Datenanalyse) im Hintergrund zu bearbeiten und die Ergebnisse zu liefern, wenn sie fertig sind.