openclaw webhooks 設定チュートリアル

Webhookの概要

Webhook は OpenClaw と外部プラットフォーム間の通信の中核メカニズムです。チャンネルプラットフォーム（Telegram、Discordなど）がWebhook経由でユーザーメッセージをOpenClawにプッシュし、OpenClawもアウトバウンドWebhookでイベントを外部システムにプッシュできます。

Webhook一覧の表示

openclaw webhooks list

インバウンドWebhookの設定

openclaw webhooks set-inbound telegram \
  --url "https://gateway.example.com/webhook/telegram" \
  --verify-signature

アウトバウンドWebhookの作成

openclaw webhooks create event-logger \
  --url "https://log.example.com/events" \
  --events message.received,message.sent,error \
  --secret "webhook-signing-secret"

リトライ戦略

{
  "webhooks": {
    "outbound": {
      "event-logger": {
        "retries": 3,
        "retryDelay": 5000,
        "timeout": 10000
      }
    }
  }
}

まとめ

WebhookシステムはOpenClawと外部世界をつなぐ橋です。リトライ戦略と署名検証を適切に設定することで、メッセージ配信の信頼性と安全性を確保できます。