OpenClaw Becerisi

OpenClaw Becerisi Nedir?
#

OpenClaw için PocketHook becerisi, OpenClaw ajanınızın cihazınızda iOS Kısayollarını tetiklemesini sağlar. OpenClaw’dan bir not oluşturmasını, çalma listesi yapmasını veya herhangi bir otomasyonu çalıştırmasını istediğinizde, ajan yanıtına PocketHook’un algıladığı ve çalıştırdığı işaretçiler ekler.

Erken sürüm. Bu beceri kurulumunuza göre ek ayar gerektirebilir. Dahil edilen kısayollar örnektir — kendi kısayollarınızı kaydetmeniz ve beceriyi PocketHook’u nasıl kullandığınıza göre uyarlamanız gerekir.

Nasıl Çalışır
#

PocketHook’tan bir mesaj gönderirsiniz, bu da mesajı OpenClaw sunucunuza iletir
OpenClaw mesajı LLM’i ve PocketHook becerisiyle işler
Yanıt, [SHORTCUT:New Note] ve [DATA:{...}] gibi satır içi işaretçiler içerir
PocketHook işaretçileri algılar, görüntülenen mesajdan kaldırır ve cihazınızdaki Kısayolları çalıştırır

PocketHook, x-openclaw-agent-id: main başlığıyla OpenAI Chat Completions formatını kullanarak OpenClaw ile iletişim kurar.

Kurulum
#

1. Beceriyi kurun
#

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

OpenClaw becerileri anında yeniden yükler — yeniden başlatma gerekmez.

2. PocketHook’u yapılandırın
#

iOS cihazınızda PocketHook’ta Ayarlar‘a gidin:

Ayar	Değer
Sunucu URL’si	OpenClaw HTTP proxy URL’niz (HTTPS)
Kimlik Doğrulama Token’ı	OpenClaw kimlik doğrulama token’ınız
OpenClaw Modu	AÇIK

Arka plan görevleri için (isteğe bağlı):

Ayar	Değer
Arka Plan Görevleri	AÇIK
Yoklama URL’si	Yoklama uç noktanız
Getirme Mesajı	`fetchPendingTasks`

Doğrulamak için Bağlantı Testi’ne dokunun.

Desteklenen İşaretçiler
#

İşaretçi	Amaç
`[SHORTCUT:name]` veya `[RUN:name]`	Bir iOS Kısayolunu tetikler
`[DATA:{...}]`	Öncesindeki kısayola JSON verisi iletir
`[URL:https://...]`	Uygulama içi tarayıcıda bir URL açar

İşaretçiler yanıtın sonuna yerleştirilir ve birleştirilebilir:

Creating your note and opening the recipe.

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

Birden fazla kısayol sırayla çalıştırılır — PocketHook bir sonrakini çalıştırmadan önce her birinin tamamlanmasını bekler.

Kısayollarınızı Kaydetme
#

Beceri örnek kısayollarla birlikte gelir (New Note, newPlayList). Kendi kısayollarınızı eklemek için SKILL.md dosyasını üç yerde düzenleyin:

1. `description` alanı
#

OpenClaw’ın beceriyi etkinleştirmesi için kısayol tetikleyicinizi Use when: listesine ekleyin:

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

2. “When to Use” tablosu
#

Kullanıcı niyetini kısayol eylemine eşleştirin:

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

3. “User’s Shortcuts” bölümü
#

Kısayol adını ve veri formatını belgeleyin:

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

Arka Plan Görevleri
#

PocketHook, asenkron işler için yoklamayı destekler:

PocketHook periyodik olarak Yoklama URL’sine bir GET isteği gönderir
Yanıt true ise, bir bildirim görünür
Kullanıcı PocketHook’u açtığında, fetchPendingTasks gönderir
OpenClaw, tamamlanan sonuçlarla yanıt verir (kısayol işaretçileri dahil)
Bekleyen sonuç yoksa, yalnızca false ile yanıt verin

Bu, OpenClaw’ın uzun süren görevleri (araştırma, proje oluşturma, veri analizi) arka planda işlemesini ve hazır olduğunda sonuçları teslim etmesini sağlar.