Kỹ năng OpenClaw là gì?#
Kỹ năng PocketHook dành cho OpenClaw cho phép agent OpenClaw của bạn kích hoạt Phím tắt iOS trên thiết bị của bạn. Khi bạn yêu cầu OpenClaw tạo ghi chú, tạo danh sách phát hoặc chạy bất kỳ tự động hóa nào, agent sẽ chèn các đánh dấu vào phản hồi để PocketHook phát hiện và thực thi.
Bản phát hành sớm. Kỹ năng này có thể cần tinh chỉnh thêm cho thiết lập của bạn. Các phím tắt đi kèm chỉ là ví dụ — bạn sẽ cần đăng ký phím tắt của riêng mình và điều chỉnh kỹ năng cho phù hợp với cách bạn sử dụng PocketHook.
Cách hoạt động#
- Bạn gửi tin nhắn từ PocketHook, ứng dụng sẽ chuyển tiếp tin nhắn đến máy chủ OpenClaw của bạn
- OpenClaw xử lý tin nhắn bằng LLM của nó và kỹ năng PocketHook
- Phản hồi bao gồm các đánh dấu nội tuyến như
[SHORTCUT:New Note]và[DATA:{...}] - PocketHook phát hiện các đánh dấu, loại bỏ chúng khỏi tin nhắn hiển thị và thực thi các Phím tắt trên thiết bị của bạn
PocketHook giao tiếp với OpenClaw bằng định dạng OpenAI Chat Completions với header x-openclaw-agent-id: main.
Cài đặt#
1. Cài đặt kỹ năng#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClaw tự động tải lại kỹ năng — không cần khởi động lại.
2. Cấu hình PocketHook#
Trong PocketHook trên thiết bị iOS của bạn, đi đến Cài đặt:
| Cài đặt | Giá trị |
|---|---|
| URL Máy chủ | URL proxy HTTP OpenClaw của bạn (HTTPS) |
| Token Xác thực | Token xác thực OpenClaw của bạn |
| Chế độ OpenClaw | ON |
Đối với tác vụ nền (tùy chọn):
| Cài đặt | Giá trị |
|---|---|
| Tác vụ Nền | ON |
| URL Polling | Endpoint polling của bạn |
| Tin nhắn Truy xuất | fetchPendingTasks |
Nhấn Kiểm tra Kết nối để xác minh.
Các Đánh dấu Được Hỗ trợ#
| Đánh dấu | Mục đích |
|---|---|
[SHORTCUT:name] hoặc [RUN:name] | Kích hoạt một Phím tắt iOS |
[DATA:{...}] | Truyền dữ liệu JSON cho phím tắt đứng ngay trước |
[URL:https://...] | Mở URL trong trình duyệt tích hợp của ứng dụng |
Các đánh dấu được đặt ở cuối phản hồi và có thể kết hợp với nhau:
Creating your note and opening the recipe.
[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]
Nhiều phím tắt được thực thi tuần tự — PocketHook đợi mỗi phím tắt hoàn thành trước khi chạy phím tắt tiếp theo.
Đăng ký Phím tắt Của Bạn#
Kỹ năng đi kèm các phím tắt ví dụ (New Note, newPlayList). Để thêm phím tắt của riêng bạn, hãy chỉnh sửa SKILL.md ở ba chỗ:
1. Trường description#
Thêm trigger phím tắt của bạn vào danh sách Use when: để OpenClaw kích hoạt kỹ năng:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. Bảng “When to Use”#
Ánh xạ ý định của người dùng tới hành động phím tắt:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. Phần “User’s Shortcuts”#
Ghi lại tên phím tắt và định dạng dữ liệu:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Tác vụ Nền#
PocketHook hỗ trợ polling cho công việc bất đồng bộ:
- PocketHook định kỳ gửi yêu cầu GET đến URL Polling
- Nếu phản hồi là
true, một thông báo sẽ xuất hiện - Khi người dùng mở PocketHook, ứng dụng gửi
fetchPendingTasks - OpenClaw phản hồi với các kết quả đã hoàn thành (bao gồm các đánh dấu phím tắt)
- Nếu không có kết quả đang chờ, chỉ cần phản hồi
false
Điều này cho phép OpenClaw xử lý các tác vụ dài (nghiên cứu, tạo dự án, phân tích dữ liệu) trong nền và trả kết quả khi sẵn sàng.