設定リファレンス

同期

#

PocketHookは、あなたのプライベートなiCloudアカウントを使って、会話とアプリの設定をデバイス間で同期します——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エンドポイントが認証で保護されているものの、シンプルなステータス確認をしたい場合に便利です。

自動化

#

サーバーレスポンスによってトリガーされるiOSショートカットの実行方法を制御します。

iOSショートカット

#

ショートカット実行のマスタートグルです。OFFの場合、PocketHookはサーバーからのメッセージを引き続き表示しますが、レスポンス内の shortcut フィールドは無視します。デバッグや自動化の一時的な無効化に便利です。

ショートカット間の遅延

#

サーバーが1つのレスポンスで複数の自動化を返した場合に、連続するショートカットの実行の間に待機する時間です。ショートカットが互いに依存している場合（例：最初のショートカットが作成したファイルを2番目が読み取る）は、この値を増やしてください。

ショートカットタイムアウト

#

個々のショートカットが完了するまでPocketHookが待つ最大時間で、これを超えるとタイムアウトと見なされます。長時間実行されるショートカット（メディアを処理するものや複数のAPI呼び出しを行うものなど）には、最大の5分が必要になる場合があります。

パーソナルUI

#

カスタムWebインターフェースをPocketHookに直接埋め込みます。

パーソナルUI

#

埋め込みWebビューを備えた専用タブを表示します。有効にすると、メインナビゲーションに新しいタブが現れ、あなたのカスタムWebページが表示されます。ページは即時表示のためにプリロードされ、プルツーリフレッシュに対応しています。

パーソナルUIのURL

#

パーソナルUIタブに表示するURLです。HTTPとHTTPSの両方が受け付けられます（HTTPSを推奨）。ダッシュボード、管理パネルなど、チャットと並行して素早くアクセスしたい任意のWebページを設定できます。

リンク

#

サーバーレスポンスに含まれるURLの扱い方を設定します。

リンクタブ

#

メインナビゲーションのリンクタブの表示・非表示を切り替えます。有効にすると、サーバーレスポンスから受信したすべてのURLが保存され、リッチなリンクプレビュー、検索、削除機能を備えた専用タブに表示されます。

URLの自動オープン

#

有効にすると、PocketHookはサーバーレスポンスに含まれるURLをデフォルトブラウザで自動的に開きます。無効にすると、URLはリンクタブに保存されますが（タブが有効な場合）、自動的には開きません。

この設定は意図的にデバイスごとになっています。たとえばiPhoneではリンクを自動的に開きたいが、Macでは開きたくない、という場合があります。メッセージの下のリンクチップをタップすると、この設定にかかわらず常にリンクが開きます。

言語

#

アプリと音声入力の言語をカスタマイズします。

アプリの言語

#

デバイスの言語とは独立して、アプリの表示言語を上書きします。「システムデフォルト」に設定すると、PocketHookはiOSの言語設定に従います。

音声入力の言語

#

チャット入力での音声入力（音声からテキストへの変換）に使用される言語です。利用可能な言語：

バックグラウンドタスク

#

アプリがバックグラウンドにあるときでも、保留中のタスクを定期的に確認します。

バックグラウンドタスク

#

バックグラウンドポーリングを有効にします。有効な場合、PocketHookはポーリングURLへ定期的にGETリクエストを送信します。レスポンスが true の場合、アプリを開いたときにフェッチメッセージをメインサーバーに送信します。保留中のタスクを知らせるために通知の許可が必要です。

確認間隔

#

PocketHookがバックグラウンドでポーリングURLを確認する頻度です。間隔が短いほど保留中のタスクを速く検出できますが、バッテリーの消費が増えます。iOSはデバイスの使用パターンに基づいて実際の頻度を調整することがあります。

ポーリングURL

#

PocketHookが設定された間隔でポーリングするHTTPSエンドポイントです。平文の true（タスクあり）または false（タスクなし）を返す必要があります。これは軽量なチェックです — サーバーは重い処理をせずに素早く応答すべきです。

Agent Server: https://your-host/jobs を使用してください（ホストとポートはあなたの構成に合わせて調整してください）。

フェッチメッセージ

#

バックグラウンドの確認で保留中のタスクが見つかり、アプリを開いたときにメインサーバーへ送信されるメッセージです。サーバーのレスポンスは他のメッセージと同様にチャットに表示されます。サーバー側で特定の動作をトリガーするようにカスタマイズできます。

データ管理

#

保存されたメッセージを監視・管理します。

保存済みメッセージ

#

現在保存されているメッセージの数を表示します。インジケーターは色分けされています：

• 緑 — 容量の70%未満
• オレンジ — 容量の70〜90%
• 赤 — 容量の90%超

500件の上限に達すると、新しいメッセージのために最も古いメッセージが自動的に削除されます。

会話のエクスポート

#

保存されたすべてのメッセージを、iOSの共有シート経由でJSONファイルとしてエクスポートするボタンです。ファイルを保存したり、AirDropで送ったり、任意のアプリと共有したりできます。会話のバックアップやメッセージ履歴の分析に便利です。

すべてのメッセージを削除

#

保存されたすべてのメッセージを完全に削除する破壊的なボタンです。実行前に確認が必要です。この操作は元に戻せません。

情報

#

PocketHookのインストールに関する読み取り専用の情報です。