Що таке навичка OpenClaw?#
Навичка PocketHook для OpenClaw дозволяє вашому агенту OpenClaw запускати швидкі команди iOS на вашому пристрої. Коли ви просите OpenClaw створити нотатку, зробити плейлист або виконати будь-яку автоматизацію, агент додає маркери у свою відповідь, які PocketHook виявляє та виконує.
Рання версія. Ця навичка може потребувати додаткового налаштування під ваше середовище. Включені швидкі команди — це приклади: вам потрібно буде зареєструвати власні та адаптувати навичку відповідно до того, як ви використовуєте PocketHook.
Як це працює#
- Ви надсилаєте повідомлення з PocketHook, яке пересилається на ваш сервер OpenClaw
- OpenClaw обробляє його своєю LLM та навичкою PocketHook
- Відповідь містить вбудовані маркери, такі як
[SHORTCUT:New Note]та[DATA:{...}] - PocketHook виявляє маркери, видаляє їх з відображуваного повідомлення та виконує швидкі команди на вашому пристрої
PocketHook спілкується з OpenClaw за допомогою формату OpenAI Chat Completions із заголовком x-openclaw-agent-id: main.
Налаштування#
1. Встановлення навички#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClaw автоматично перезавантажує навички (hot-reload) — перезапуск не потрібен.
2. Налаштування PocketHook#
У PocketHook на вашому пристрої iOS перейдіть до Settings:
| Налаштування | Значення |
|---|---|
| Server URL | URL вашого HTTP-проксі OpenClaw (HTTPS) |
| Auth Token | Ваш токен автентифікації OpenClaw |
| OpenClaw Mode | Увімкнено (ON) |
Для фонових завдань (необов’язково):
| Налаштування | Значення |
|---|---|
| Background Tasks | Увімкнено (ON) |
| Polling URL | Ваша кінцева точка опитування |
| Fetch Message | fetchPendingTasks |
Натисніть Test Connection, щоб перевірити з’єднання.
Підтримувані маркери#
| Маркер | Призначення |
|---|---|
[SHORTCUT:name] або [RUN:name] | Запускає швидку команду iOS |
[DATA:{...}] | Передає дані JSON у попередню швидку команду |
[URL:https://...] | Відкриває URL у вбудованому браузері застосунку |
Маркери розміщуються в кінці відповіді та можуть комбінуватися:
Creating your note and opening the recipe.
[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]
Кілька швидких команд виконуються послідовно — PocketHook чекає завершення кожної, перш ніж запустити наступну.
Реєстрація власних швидких команд#
Навичка постачається з прикладами швидких команд (New Note, newPlayList). Щоб додати власні, відредагуйте SKILL.md у трьох місцях:
1. Поле description#
Додайте свій тригер швидкої команди до списку Use when:, щоб OpenClaw активував навичку:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. Таблиця “When to Use”#
Зіставте намір користувача з дією швидкої команди:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. Розділ “User’s Shortcuts”#
Задокументуйте назву швидкої команди та формат даних:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Фонові завдання#
PocketHook підтримує опитування (polling) для асинхронної роботи:
- PocketHook періодично надсилає GET на Polling URL
- Якщо відповідь
true, з’являється сповіщення - Коли користувач відкриває PocketHook, той надсилає
fetchPendingTasks - OpenClaw відповідає завершеними результатами (включно з маркерами швидких команд)
- Якщо результатів немає, відповідає просто
false
Це дозволяє OpenClaw обробляти тривалі завдання (дослідження, створення проєктів, аналіз даних) у фоновому режимі та доставляти результати, коли вони готові.