設定參考

同步

#

PocketHook 使用你的私人 iCloud 帳號，在你的裝置之間同步對話與 App 設定——不需要 PocketHook 帳號，也沒有任何第三方伺服器介入。

在你的 iPhone、iPad 和 Mac 上登入相同的 iCloud 帳號，所有內容就會自動出現——不需要額外設定。你的資料會留在你自己的私人 iCloud 資料庫中；PocketHook 的伺服器完全看不到。

伺服器設定

#

與你的 PocketHook 伺服器連線的核心設定。

伺服器 URL

#

PocketHook 傳送聊天訊息的 HTTPS 端點。僅接受 HTTPS URL——基於安全考量，HTTP 會被拒絕。這是你的伺服器監聽的主要端點。

驗證權杖

#

隨每個請求在 Authorization 標頭中傳送的 Bearer 權杖。你的伺服器可以用它驗證請求來自你的裝置。安全地儲存在 iOS Keychain 中——絕不以明文保存。

OpenClaw 相容

#

如果你的伺服器使用 OpenClaw 平台或任何相容 OpenAI 的 Chat Completions API，請啟用此項。啟用後，PocketHook 會以 OpenAI 聊天格式傳送訊息，並從回應中解析內嵌捷徑標記（[SHORTCUT:name]、[DATA:{...}]、[URL:...]）。請求中會包含 x-openclaw-agent-id 標頭。

測試連線

#

向已設定的伺服器傳送測試請求的按鈕。顯示：

• 以毫秒計的回應時間
• 健康檢查結果（如已啟用）
• 連線失敗時的錯誤詳細資訊

修改伺服器 URL 或驗證權杖後，請用它來確認一切正常。

網路

#

針對不同類型的操作微調逾時行為。

請求逾時

#

PocketHook 等待伺服器開始回應請求的時間。如果你的伺服器要進行繁重處理（例如呼叫 AI 模型），請調高此值。對於簡單的 Webhook 伺服器，預設的 5 秒通常足夠。

資源逾時

#

整個回應（包括資料傳輸）完成的最長時間。此值應高於請求逾時。如果你的伺服器回傳大量資料或上傳速度較慢，請調高。

健康檢查

#

啟用伺服器健康監測。啟用後，PocketHook 會在連線測試期間向健康檢查 URL 傳送 GET 請求，並顯示伺服器是否回報健康。

健康檢查 URL

#

一個回傳純文字 true 或 false 的獨立 HTTPS 端點。連線測試期間會存取此 URL，以確認你的伺服器正常運作。當你的主要 API 端點需要驗證、但你只想做一個簡單的狀態檢查時非常有用。

自動化

#

控制 PocketHook 如何執行由伺服器回應觸發的 iOS 捷徑。

iOS 捷徑

#

捷徑執行的總開關。設為 OFF 時，PocketHook 仍會顯示來自伺服器的訊息，但會忽略回應中的任何 shortcut 欄位。適合除錯或暫時停用自動化。

捷徑間延遲

#

當伺服器在一次回應中回傳多個自動化時，連續執行捷徑之間的等待時間。如果你的捷徑彼此相依（例如第一個捷徑建立的檔案由第二個讀取），請調高此值。

捷徑逾時

#

PocketHook 等待每個捷徑完成的最長時間，超過即視為逾時。長時間執行的捷徑（例如處理媒體或進行多次 API 呼叫的）可能需要完整的 5 分鐘。

個人 UI

#

將自訂網頁介面直接嵌入 PocketHook。

個人 UI

#

顯示一個帶內嵌網頁檢視的專用分頁。啟用後，主導覽列中會出現一個新分頁，用於顯示你的自訂網頁。頁面會預先載入以便立即顯示，並支援下拉重新整理。

個人 UI URL

#

在個人 UI 分頁中顯示的 URL。HTTP 和 HTTPS 均可接受（建議使用 HTTPS）。它可以是儀表板、管理面板，或任何你想在聊天旁邊快速存取的網頁。

連結

#

設定 PocketHook 如何處理來自伺服器回應的 URL。

連結分頁

#

顯示或隱藏主導覽列中的連結分頁。啟用後，從伺服器回應收到的所有 URL 都會被儲存，並顯示在一個專用分頁中，附有豐富的連結預覽、搜尋和刪除功能。

自動開啟 URL

#

啟用後，PocketHook 會自動在你的預設瀏覽器中開啟來自伺服器回應的 URL。停用後，URL 仍會儲存到連結分頁（如已啟用），但不會自動開啟。

這項設定刻意採用逐裝置設定：你可能想讓連結在 iPhone 上自動開啟，但在 Mac 上不要。無論這項設定為何，點按訊息下方的連結標籤都一定會開啟連結。

語言

#

自訂 App 和聽寫語言。

App 語言

#

獨立於裝置語言來覆寫 App 的顯示語言。設為「系統預設」時，PocketHook 會遵循你的 iOS 語言設定。

聽寫語言

#

聊天輸入中語音聽寫（語音轉文字）使用的語言。可用語言：

背景任務

#

即使 App 在背景，也定期檢查是否有待處理任務。

背景任務

#

啟用背景輪詢。啟用後，PocketHook 會定期向輪詢 URL 傳送 GET 請求。如果回應為 true，則在 App 開啟時向主伺服器傳送擷取訊息。需要通知權限才能提醒你有待處理任務。

檢查間隔

#

PocketHook 在背景檢查輪詢 URL 的頻率。間隔越短，發現待處理任務越快，但耗電也越多。iOS 可能會根據裝置使用模式調整實際頻率。

輪詢 URL

#

PocketHook 按設定的間隔輪詢的 HTTPS 端點。必須回傳純文字 true（有待處理任務）或 false（無任務）。這是一次輕量檢查——你的伺服器應快速回應，無需繁重處理。

**Agent Server：**使用 https://your-host/jobs（依你的部署調整主機和連接埠）。

擷取訊息

#

當背景檢查發現待處理任務且 App 開啟時，傳送給主伺服器的訊息。伺服器回應會像其他訊息一樣出現在聊天中。可自訂此項以觸發特定的伺服器端行為。

資料管理

#

監控並管理你儲存的訊息。

已儲存訊息

#

顯示目前儲存的訊息數量。指示器以顏色區分：

• 綠色 — 低於 70% 容量
• 橘色 — 70–90% 容量
• 紅色 — 超過 90% 容量

達到 500 則訊息上限後，最舊的訊息會被自動刪除，為新訊息騰出空間。

匯出對話

#

透過 iOS 分享頁面將所有已儲存訊息匯出為 JSON 檔案的按鈕。你可以儲存檔案、用 AirDrop 傳送，或分享給任何 App。適合備份對話或分析訊息歷史。

刪除所有訊息

#

永久移除所有已儲存訊息的破壞性按鈕。執行前需要確認。此操作無法復原。

關於

#

關於你的 PocketHook 安裝的唯讀資訊。