Přeskočit na hlavní obsah
  1. Dokumentace/

Dovednost OpenClaw

Co je dovednost OpenClaw?
#

Dovednost PocketHook pro OpenClaw umožňuje vašemu agentovi OpenClaw spouštět iOS Zkratky na vašem zařízení. Když požádáte OpenClaw o vytvoření poznámky, sestavení playlistu nebo spuštění jakékoli automatizace, agent do své odpovědi vloží značky, které PocketHook detekuje a provede.

Rané vydání. Tato dovednost může vyžadovat další ladění podle vašeho nastavení. Přiložené zkratky jsou příklady — budete si muset zaregistrovat vlastní a přizpůsobit dovednost tomu, jak PocketHook používáte.

Jak to funguje
#

  1. Odešlete zprávu z PocketHook, která se přepošle na váš server OpenClaw
  2. OpenClaw ji zpracuje pomocí svého LLM a dovednosti PocketHook
  3. Odpověď obsahuje vložené značky jako [SHORTCUT:New Note] a [DATA:{...}]
  4. PocketHook značky detekuje, odstraní je ze zobrazené zprávy a spustí Zkratky na vašem zařízení

PocketHook komunikuje s OpenClaw pomocí formátu OpenAI Chat Completions s hlavičkou x-openclaw-agent-id: main.

Nastavení
#

1. Instalace dovednosti
#

git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/

OpenClaw dovednosti za chodu automaticky znovu načítá — restart není potřeba.

2. Konfigurace PocketHook
#

V PocketHook na vašem iOS zařízení přejděte do Nastavení:

NastaveníHodnota
URL serveruURL vaší HTTP proxy OpenClaw (HTTPS)
Autentizační tokenVáš autentizační token OpenClaw
Režim OpenClawON

Pro úlohy na pozadí (volitelné):

NastaveníHodnota
Úlohy na pozadíON
URL pollinguVáš endpoint pro polling
Zpráva pro načtenífetchPendingTasks

Klepnutím na Otestovat připojení ověříte funkčnost.

Podporované značky
#

ZnačkaÚčel
[SHORTCUT:name] nebo [RUN:name]Spustí iOS Zkratku
[DATA:{...}]Předá JSON data předchozí zkratce
[URL:https://...]Otevře URL v prohlížeči uvnitř aplikace

Značky se umísťují na konec odpovědi a lze je kombinovat:

Creating your note and opening the recipe.

[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]

Více zkratek se spouští postupně — PocketHook čeká na dokončení každé z nich, než spustí další.

Registrace vlastních zkratek
#

Dovednost obsahuje ukázkové zkratky (New Note, newPlayList). Chcete-li přidat vlastní, upravte SKILL.md na třech místech:

1. Pole description
#

Přidejte spouštěč vaší zkratky do seznamu Use when:, aby OpenClaw dovednost aktivoval:

description: >
  ...
  Use when: create a note, make a playlist, set a reminder, ...

2. Tabulka „When to Use"
#

Namapujte záměr uživatele na akci zkratky:

| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |

3. Sekce „User’s Shortcuts"
#

Zdokumentujte název zkratky a formát dat:

### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`

Úlohy na pozadí
#

PocketHook podporuje polling pro asynchronní úlohy:

  1. PocketHook pravidelně odesílá GET na URL pollingu
  2. Pokud je odpověď true, zobrazí se oznámení
  3. Když uživatel otevře PocketHook, odešle fetchPendingTasks
  4. OpenClaw odpoví dokončenými výsledky (včetně značek zkratek)
  5. Pokud nejsou žádné čekající výsledky, odpoví pouze false

To umožňuje OpenClaw zpracovávat dlouhé úlohy (výzkum, vytváření projektů, analýzu dat) na pozadí a doručit výsledky, jakmile jsou hotové.