CLI commands

Webhook

openclaw webhooks

Pembantu dan integrasi Webhook. Saat ini, cakupan fitur ini terbatas pada alur Gmail Pub/Sub yang dibangun di atas pemantau gog bawaan.

Subperintah

bash
openclaw webhooks gmail setup --account <email> [...]openclaw webhooks gmail run   [--account <email>] [...]
Subperintah Deskripsi
gmail setup Panduan satu kali: pemantauan Gmail, topik/langganan Pub/Sub, dan pengiriman hook OpenClaw.
gmail run Menjalankan gog watch serve beserta loop perpanjangan otomatis pemantauan di latar depan.

webhooks gmail setup

bash
openclaw webhooks gmail setup --account you@example.comopenclaw webhooks gmail setup --account you@example.com --project my-gcp-project --jsonopenclaw webhooks gmail setup --account you@example.com --hook-url https://gateway.example.com/hooks/gmail

Menginstal gcloud dan gog jika belum tersedia, mengautentikasi gcloud, membuat topik dan langganan Pub/Sub, memulai pemantauan Gmail, serta menulis konfigurasi hooks.gmail dengan hooks.enabled=true. Menampilkan Next: openclaw webhooks gmail run.

Wajib

Flag Deskripsi
--account <email> Akun Gmail yang akan dipantau.

Opsi Pub/Sub

Flag Bawaan Deskripsi
--project <id> (tidak ada) ID proyek GCP (pemilik klien OAuth). Jika tidak tersedia, menggunakan ID proyek milik topik, lalu proyek yang ditentukan dari kredensial gog.
--topic <name> gog-gmail-watch Nama topik Pub/Sub.
--subscription <name> gog-gmail-watch-push Nama langganan Pub/Sub.
--label <label> INBOX Label Gmail yang akan dipantau.
--push-endpoint <url> (tidak ada) Titik akhir push Pub/Sub eksplisit. Menggantikan Tailscale.

Opsi pengiriman OpenClaw

Flag Bawaan Deskripsi
--hook-url <url> Dibuat dari hooks.path dan porta Gateway URL Webhook OpenClaw.
--hook-token <token> hooks.token, atau token yang dibuat Token Webhook OpenClaw.
--push-token <token> Token yang dibuat Token push yang diteruskan ke gog watch serve.

Opsi gog watch serve

Flag Bawaan Deskripsi
--bind <host> 127.0.0.1 Host pengikatan gog watch serve.
--port <port> 8788 Porta gog watch serve.
--path <path> /gmail-pubsub Jalur gog watch serve. Dipaksa menjadi / ketika Tailscale diaktifkan tanpa target eksplisit karena Tailscale menghapus jalur tersebut sebelum meneruskannya melalui proksi.
--include-body true Menyertakan cuplikan isi surel. Tidak ada flag CLI untuk menonaktifkannya; sebagai gantinya, tetapkan hooks.gmail.includeBody: false dalam konfigurasi.
--max-bytes <n> 20000 Jumlah maksimum bita per cuplikan isi.
--renew-minutes <n> 720 (12 jam) Memperpanjang pemantauan Gmail setiap N menit.

Eksposur Tailscale

Flag Bawaan Deskripsi
--tailscale <mode> funnel Mengekspos titik akhir push melalui Tailscale: funnel, serve, atau off.
--tailscale-path <path> (tidak ada) Jalur untuk Tailscale serve/funnel.
--tailscale-target <t> (tidak ada) Target Tailscale serve/funnel (porta, host:port, atau URL).

Keluaran

Flag Deskripsi
--json Menampilkan ringkasan yang dapat dibaca mesin, bukan teks.

webhooks gmail run

bash
openclaw webhooks gmail run --account you@example.com

Menjalankan gog watch serve beserta loop perpanjangan otomatis pemantauan di latar depan, dan memulai ulang gog watch serve setelah jeda 2 detik jika proses tersebut berhenti secara tidak terduga.

run menerima flag Pub/Sub, pengiriman OpenClaw, gog watch serve, dan Tailscale yang sama seperti setup, kecuali:

  • --account bersifat opsional pada run; jika tidak diberikan, nilainya diambil dari hooks.gmail.account.
  • run tidak menerima --project, --push-endpoint, atau --json.
  • Setiap flag menggunakan nilai konfigurasi hooks.gmail.* yang sesuai (ditulis oleh setup) jika flag tidak diberikan, kemudian menggunakan nilai bawaan internal yang sama dengan setup, dengan satu pengecualian: --tailscale menggunakan nilai bawaan off pada run (bukan funnel) ketika flag maupun hooks.gmail.tailscale.mode tidak ditetapkan.
Kategori Flag
Pub/Sub --account, --topic, --subscription, --label
Pengiriman OpenClaw --hook-url, --hook-token, --push-token
gog watch serve --bind, --port, --path, --include-body, --max-bytes, --renew-minutes
Tailscale --tailscale, --tailscale-path, --tailscale-target

Terkait

Was this useful?
On this page

On this page