OpenClaw · 受信メール

メールが届きます。 OpenClaw エージェントが起動します。

スキルを 1 つインストールし、エージェントに無料の受信トレイを与え、ヘッダーのみの認証を使用して受信メールを専用のゲートウェイフックにルーティングします。

前提条件: モデルプロバイダーが設定された動作中の OpenClaw エージェント · ポーリングなし · 後でカスタムドメイン

OpenClaw · 現在のインストール

$openclaw skills install @gwendall/domani

インストール済み · @gwendall/domani

$openclaw skills verify @gwendall/domani

検証済み · 最新リリース

$npx domani-cli login --surface skill

承認済み · 認証情報を OS キーチェーンに保存しました

イベントパス

Webhook トリガーは、受信トレイのポーリングループを置き換えます。

メールが届く

メッセージがagent@domani.runに到着します。

Domani が認証する

イベントにはAuthorizationと X-Domani-Signatureが伴います。

ゲートウェイマップ

/hooks/domani-email は、ペイロードを分離されたエージェントタスクに変換します。

代理行為

OpenClaw は、構成されたチャネルに最終応答を配信できます。

ポーリング

繰り返しの読み取り、アイドル要求、およびポーリング間隔によって設定された遅延。

Webhook

メールが処理されるときに 1 回プッシュします。受信機のダウンタイム後にのみ、保存された受信トレイを調整します。

1 · ゲートウェイイングレス

Domani のペイロードを分離されたエージェントの実行にマッピングします。

これをマージします `~/.openclaw/openclaw.json`;より厳格な既存の設定を保持します。 2 つの異なる長いランダム値をゲートウェイ環境に配置するか、 `~/.openclaw/.env`: `OPENCLAW_GATEWAY_TOKEN` コントロールプレーン認証用と `OPENCLAW_HOOK_TOKEN` この進入のために。エージェントフックの実行はデフォルトで分離されます。検証後に再起動します。

openclaw.json · 置換せずにマージします

${ gateway: { mode: "local", bind: "loopback", auth: { mode: "token", token: "${OPENCLAW_GATEWAY_TOKEN}" } }, hooks: { enabled: true, token: "${OPENCLAW_HOOK_TOKEN}", path: "/hooks", allowRequestSessionKey: false, allowedAgentIds: ["main"], mappings: [{ match: { path: "domani-email" }, action: "agent", agentId: "main", wakeMode: "now", name: "Domani email", messageTemplate: "New email for {{email}}\nFrom: {{message.from}}\nSubject: {{message.subject}}\n\n{{message.text}}", deliver: true, channel: "last" }] } }

専用トークン

長いランダム値を使用し、OPENCLAW_GATEWAY_TOKEN を再利用しないでください。 OpenClaw フラグは、重要なセキュリティの検出結果として再利用されます。

信頼できる公開

ゲートウェイループバックのみを維持し、テールネットまたは信頼できるリバースプロキシ経由で HTTPS 経由でフックを公開します。該当する場合は、trustedProxies を正確なプロキシ IP に構成します。

制限付きエージェント

電子メールを信頼できない入力として扱います。制限されたツールポリシーを使用し、安全でないコンテンツのバイパスを無効にしておきます。

公式 OpenClaw Webhook リファレンス公式のセキュリティ設定

2・Domaniメールボックス

環境変数でトークンを渡し、配信を証明します。

マップされたフックの外部から到達可能な HTTPS 形式を使用します。非表示のプロンプトにより、ベアラー値がシェル履歴に保存されず、CLI は出力せずにベアラー値を読み取ります。

Domani CLI · シークレットセーフ

$read -rsp 'OpenClaw hook token: ' OPENCLAW_HOOK_TOKEN; echo

$export OPENCLAW_HOOK_AUTH="Bearer $OPENCLAW_HOOK_TOKEN"

$domani email webhook agent@domani.run --url 'https://YOUR_GATEWAY/hooks/domani-email' --authorization-env OPENCLAW_HOOK_AUTH

Webhook 設定済み · Authorization

$domani email webhook-test agent@domani.run

テスト配信済み · HTTP 200

$unset OPENCLAW_HOOK_TOKEN OPENCLAW_HOOK_AUTH

まずテストしてください

ライブメールを送信する前に 2xx の結果が必要です。

ライブセカンド

実際の電子メールを 1 通送信し、分離されたタスクが 1 つだけ開始されることを確認します。

ダウンタイム後に調整する

ライブメールボックスコールバックは最大 3 回まで試行されます。 Webhook 配信は少なくとも 1 回であり、再試行ウィンドウには制限があるため、ゲートウェイのダウンタイムが長くなった後でも、保存されている受信トレイを引き続き読み取ります。

トラブルシューティング

チェックすべき 4 つの境界線。

401 / 429専用フックトークンを確認してください。 OpenClaw は、繰り返される認証失敗のレートを制限します。より激しく再試行する代わりに、Retry-After を待ちます。

404hooks.enabled、hooks.path、マッピングパスを確認します。この例では、Domani URL は /hooks/domani-email で終わる必要があります。

タイムアウトエージェントの長い作業の前に返品を受け入れます。 Domani のテストには 10 秒の受信タイムアウトがあります。

エージェントが実行されない構成を検証し、ゲートウェイを再起動し、allowedAgentIds を確認してから、マッピングまたはモデルポリシーの拒否についてゲートウェイログを検査します。

Domani テストは、ゲートウェイが HTTP イベントを受け入れたことを証明します。下流モデルの完了時間は測定されません。

最初の結果

受信箱を作成します。フックをテストします。メールを送信します。

カスタムドメインの決定は、イベントループが機能した後まで保持してください。

文書化された OpenClaw および Domani インターフェイスを使用したコミュニティ統合。

Domani Webhook API ClawHub 掲載情報