Czym jest umiejętność OpenClaw?#
Umiejętność PocketHook dla OpenClaw pozwala Twojemu agentowi OpenClaw uruchamiać Skróty iOS na Twoim urządzeniu. Gdy poprosisz OpenClaw o utworzenie notatki, stworzenie playlisty lub uruchomienie dowolnej automatyzacji, agent umieszcza w swojej odpowiedzi znaczniki, które PocketHook wykrywa i wykonuje.
Wczesna wersja. Ta umiejętność może wymagać dodatkowego dostrojenia do Twojej konfiguracji. Dołączone skróty są przykładami — musisz zarejestrować własne i dostosować umiejętność do sposobu, w jaki korzystasz z PocketHook.
Jak to działa#
- Wysyłasz wiadomość z PocketHook, która jest przekazywana do Twojego serwera OpenClaw
- OpenClaw przetwarza ją za pomocą swojego LLM i umiejętności PocketHook
- Odpowiedź zawiera znaczniki w tekście, takie jak
[SHORTCUT:New Note]i[DATA:{...}] - PocketHook wykrywa znaczniki, usuwa je z wyświetlanej wiadomości i wykonuje Skróty na Twoim urządzeniu
PocketHook komunikuje się z OpenClaw za pomocą formatu OpenAI Chat Completions z nagłówkiem x-openclaw-agent-id: main.
Konfiguracja#
1. Zainstaluj umiejętność#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClaw automatycznie przeładowuje umiejętności — restart nie jest potrzebny.
2. Skonfiguruj PocketHook#
W PocketHook na swoim urządzeniu iOS przejdź do Ustawień:
| Ustawienie | Wartość |
|---|---|
| URL Serwera | URL Twojego proxy HTTP OpenClaw (HTTPS) |
| Token Uwierzytelniania | Twój token uwierzytelniania OpenClaw |
| Tryb OpenClaw | ON |
Dla zadań w tle (opcjonalnie):
| Ustawienie | Wartość |
|---|---|
| Zadania w Tle | ON |
| URL Pollingu | Twój endpoint pollingu |
| Wiadomość Pobierania | fetchPendingTasks |
Dotknij Testuj Połączenie, aby zweryfikować.
Obsługiwane Znaczniki#
| Znacznik | Cel |
|---|---|
[SHORTCUT:name] lub [RUN:name] | Uruchamia Skrót iOS |
[DATA:{...}] | Przekazuje dane JSON do poprzedzającego skrótu |
[URL:https://...] | Otwiera URL w przeglądarce wewnątrz aplikacji |
Znaczniki umieszczane są na końcu odpowiedzi i mogą być łączone:
Creating your note and opening the recipe.
[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]
Wiele skrótów wykonuje się sekwencyjnie — PocketHook czeka na zakończenie każdego przed uruchomieniem następnego.
Rejestrowanie Własnych Skrótów#
Umiejętność zawiera przykładowe skróty (New Note, newPlayList). Aby dodać własne, edytuj SKILL.md w trzech miejscach:
1. Pole description#
Dodaj wyzwalacz swojego skrótu do listy Use when:, aby OpenClaw aktywował umiejętność:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. Tabela „When to Use"#
Zmapuj intencję użytkownika na akcję skrótu:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. Sekcja „User’s Shortcuts"#
Udokumentuj nazwę skrótu i format danych:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Zadania w Tle#
PocketHook obsługuje polling dla zadań asynchronicznych:
- PocketHook okresowo wysyła GET na URL Pollingu
- Jeśli odpowiedź to
true, pojawia się powiadomienie - Gdy użytkownik otworzy PocketHook, wysyła
fetchPendingTasks - OpenClaw odpowiada ukończonymi wynikami (w tym znacznikami skrótów)
- Jeśli nie ma oczekujących wyników, odpowiada po prostu
false
Dzięki temu OpenClaw może obsługiwać długie zadania (badania, tworzenie projektów, analizę danych) w tle i dostarczać wyniki, gdy będą gotowe.