OpenClaw Feishu / Lark Webhook トンネル

Feishu / Lark Webhook トンネル

Feishu / Lark の Webhook イベント購読 を使う場合、公開 HTTPS ドメイン が必要です。
ローカルの OpenClaw gateway をそのまま使うには、トンネルで安全に外部公開する必要があります。

このガイドでできること

• gateway がローカルで待ち受けているか確認する
• Ngrok / Cloudflare Tunnel / Localtunnel から選ぶ
• 公開 HTTPS ドメインを取得する
• Feishu の event subscription URL を設定して検証を通す

前提条件

• OpenClaw と Feishu plugin が導入済み
• gateway の待受 port が分かっている（例: 3000 / 8080）
• Feishu Open Platform の内部アプリ設定へアクセスできる

Step 0: gateway がローカルで動いているか確認する

openclaw gateway --port 3000curl -i http://127.0.0.1:3000/health || truelsof -i :3000 || true

Step 1: webhook endpoint の path を確認する

よくある path:

• /feishu/events
• /webhook/feishu
• /events

ログから探す例:

openclaw gateway --verboseopenclaw logs | grep -i -E "feishu|webhook|event|callback" || true

Option A: Ngrok

ngrok authtoken REDACTED_NGROK_AUTHTOKENngrok http 3000

発行された https://xxxx.ngrok-free.app のような URL を控えます。

Option B: Cloudflare Tunnel

cloudflared tunnel --url http://localhost:3000

長期運用では named tunnel を作り、config.yml を使って固定 hostname に寄せる方が安定します。

Option C: Localtunnel

npm install -g localtunnellt --port 3000 --subdomain openclawvans

一時確認には使えますが、安定性は高くありません。

Step 2: Feishu 側で event subscription URL を設定する

https://YOUR_DOMAIN/feishu/events

検証で失敗する場合は、https、domain、path の 3 点を再確認してください。

Step 3: 実際にテストする

• bot を group または DM に追加する
• @bot hello のように送る
• Feishu 側または gateway ログで受信が見えるか確認する

よくある失敗

• http や IP を使っている
• tunnel が止まっている
• gateway が違う port で起動している
• endpoint path が plugin と一致していない
• plugin 設定や app key が読まれていない

セキュリティの基本

• tunnel 公開後は必要な path だけを外へ出す
• 高リスク操作は allowlist や mention 制御を使う
• token や app secret を Git に入れない