設定指南

Mon, 09 Mar 2026 00:00:00 +0000

1. 安裝 PocketHook
#

從 App Store 下載 PocketHook，並在 iPhone、iPad 或 Mac 上開啟。

2. 設定您的伺服器
#

PocketHook 需要一個 HTTPS 端點進行通訊。您可以使用：

代理伺服器

Wed, 11 Mar 2026 00:00:00 +0000

什麼是 PocketHook Agent Server？
#

代理伺服器將 PocketHook 變成一個完整的 AI 助理。無需自己編寫回應邏輯，只需連接一個大型語言模型（Claude、GPT、Gemini 等）來處理訊息、呼叫工具並傳回結構化的 PocketHook 回應——包括捷徑觸發。

伺服器運行在您自己的機器上。您的資料由您掌控。

這是一個起點。 伺服器附帶一組核心工具，並被設計為可由您擴展。新增您自己的整合——郵件、行事曆、文件、API——讓它成為您的。

功能
#

多供應商 LLM — Anthropic、OpenAI、GitHub Copilot、Google、Mistral、Groq、xAI、OpenRouter、Ollama（本地）、LM Studio（本地）
OAuth 認證 — GitHub Copilot 和 OpenAI Codex，透過裝置碼/瀏覽器流程
代理工具 — Shell 指令、檔案讀寫、目錄列表、網路搜尋、網頁擷取、開發伺服器管理
框架/使用者分離 — 框架檔案（skills/、custom-tools/、config/）保持唯讀。您的自訂內容位於 data/user/（技能、自訂工具、說明、型別化偏好）。框架更新不會覆蓋您的工作
型別化使用者偏好 — 將偏好的地圖應用程式或隧道網域等值儲存在 data/user/prefs.json 中。在技能中以 {{prefs.key}} 參照,伺服器會在載入時進行替換
一次呼叫完成程式設計工作 — run_code_job 元工具建立一個 prompt 類型的背景工作（由您設定的 LLM 執行）並在單一步驟中向使用者傳送確認,取代容易出錯的「respond + create-job」模式
型別化協定工具 — 六個專用 respond_* 工具（respond_text、respond_image、respond_buttons、respond_shortcut、respond_html、respond_sequence），加上型別化工作工具（create_once_job、create_cron_job）和型別化工作區工具（create_project、list_projects、delete_project）。在到達裝置之前，結構描述會拒絕格式錯誤的 URL、按鈕語法以及 type/schedule 組合
型別化客製化寫入器 — create_user_skill 和 create_custom_tool 以正確的前置資料建立使用者層 markdown，因此載入器一律能解析它們，代理也無需手寫這些檔案
背景工作 — 使用 cron 運算式或簡單間隔的一次性或重複工作
動態技能 — 將捷徑和行為規則定義為 .md 檔案。僅緊湊索引載入到提示中；完整內容透過 load_skill 工具按需取得
自我管理技能 — 代理可以建立、編輯和刪除技能定義（寫入一律落在使用者層）
語意記憶 — 使用嵌入（Ollama、LM Studio 或 OpenAI）的向量搜尋。記憶由 LLM 自動分類到 wing/room/hall/status 維度
知識圖譜 — 帶有自動失效的時間三元組儲存。多值關係共存；單值事實自動替換
PARA 方法（含專案結束串聯） — 每條記憶都標記了狀態（Project、Area、Resource、Archive）。專案結束時,單次 complete_project 呼叫即可歸檔其向量、使與其 slug 關聯的所有計劃三元組失效並記錄完成 — 一次呼叫而非三次
混合召回 — 使用倒數排名融合將 FTS5 關鍵字搜尋與向量語意搜尋相結合
長期記憶 — 當語意記憶停用時，使用 SQLite + FTS5 全文搜尋作為備援
帶隧道契約的開發伺服器管理 — 啟動、停止和列出開發伺服器。當請求 tunnel: true 時,伺服器會在啟動前和啟動後強制執行 — 無法連線的 localhost 伺服器絕不會被悄悄保留執行
自動 URL 清理 — 若代理在回應中留下 localhost URL,respond_* 工具會將其改寫為對應的隧道 URL,讓您的手機總是收到可連線的連結
自訂工具 — 代理可以安裝 CLI 工具並將其註冊為新功能
版本控制 — 工作區檔案的自動 git 版本控制；技能和權限的設定備份
Web 儀表板 — 背景工作的即時概覽，可按使用者自訂。/dashboard 和 /api/jobs 在設計上是未認證的——請在網路層（Tailscale ACL、防火牆、帶基本認證的反向代理）限制存取，或在不需要時設定 DASHBOARD=false
HTTPS 隧道 — 內建 Tailscale、ngrok 和 Cloudflare Tunnel 支援
系統服務 — 在 macOS、Linux 或 Windows 上安裝為持久服務
速率限制 — 可設定閾值的逐令牌請求限制

需求
#

Bun 執行環境
LLM 供應商的 API 金鑰或 OAuth 憑證
（可選）Tailscale、ngrok 或 cloudflared（用於 HTTPS 隧道）

快速開始
#

git clone https://github.com/pockethook-app/pockethook-agent-server.git
cd pockethook-agent-server
bun install

# 互動式設定 — 選擇供應商、模型、認證令牌、連接埠
bun run setup

# 啟動伺服器 + HTTPS 隧道
bun run dev:tunnel

設定精靈將引導您選擇 LLM 供應商、設定認證和設定工具權限。

設定參考

Mon, 09 Mar 2026 00:00:00 +0000

Server Configuration
#

The core connection settings for your PocketHook server.

Server URL
#


Type	Text field (URL)
Default	Empty
Stored in	iOS Keychain

The HTTPS endpoint where PocketHook sends your chat messages. Only HTTPS URLs are accepted — HTTP is rejected for security. This is the primary endpoint your server listens on.

OpenClaw 技能

Wed, 11 Mar 2026 00:00:00 +0000

什麼是 OpenClaw 技能？
#

PocketHook 的 OpenClaw 技能讓您的 OpenClaw 代理可以在裝置上觸發 iOS 捷徑。當您要求 OpenClaw 建立筆記、製作播放清單或執行任何自動化時，代理會在回應中包含標記，PocketHook 會偵測並執行這些標記。

早期版本。 此技能可能需要針對您的設定進行額外調整。包含的捷徑是範例 — 您需要註冊自己的捷徑並調整技能以符合您使用 PocketHook 的方式。

API 參考

Mon, 09 Mar 2026 00:00:00 +0000

協定概述
#

PocketHook 透過 HTTPS 使用簡單的基於 JSON 的協定與您的伺服器通訊。應用程式發送 POST 請求並期望 JSON 回應。

認證
#

PocketHook 將設定的認證權杖作為 Bearer 權杖發送：

Siri 與 App Intents

Mon, 09 Mar 2026 00:00:00 +0000

PocketHook 提供六個 App Intents，與 Siri 和 iOS 捷徑應用程式整合。您可以用它們建構由語音、時間、位置或其他 iOS 觸發器啟動的強大自動化。

傳送訊息
#

Intent：SendMessageIntent

向伺服器傳送訊息，並可選擇等待回應。

參數	類型	說明
訊息	string	要傳送的訊息
等待回應	boolean	如果為 true，等待最多 5 分鐘

範例：「嘿 Siri，用 PocketHook 傳送『檢查伺服器』」

文件 on PocketHook

設定指南

1. 安裝 PocketHook #

2. 設定您的伺服器 #

代理伺服器

什麼是 PocketHook Agent Server？ #

功能 #

需求 #

快速開始 #

設定參考

Server Configuration #

Server URL #

OpenClaw 技能

什麼是 OpenClaw 技能？ #

API 參考

協定概述 #

認證 #

Siri 與 App Intents

傳送訊息 #

1. 安裝 PocketHook
#

2. 設定您的伺服器
#

什麼是 PocketHook Agent Server？
#

功能
#

需求
#

快速開始
#

Server Configuration
#

Server URL
#

什麼是 OpenClaw 技能？
#

協定概述
#

認證
#

傳送訊息
#