​

Webhook

​

Mengaktifkan Webhook

{
  hooks: {
    enabled: true,
    token: "rahasia-bersama",
    path: "/hooks",
    // Opsional: batasi perutean agentId eksplisit ke daftar izinkan ini.
    allowedAgentIds: ["hooks", "main"],
  },
}

• hooks.token wajib diisi jika hooks.enabled=true.
• hooks.path standarnya adalah /hooks.

​

Autentikasi

• Authorization: Bearer <token> (Direkomendasikan)
• x-openclaw-token: <token>

​

Endpoint

​

POST /hooks/wake

​

POST /hooks/agent

{
  "message": "Jalankan ini",
  "name": "Email",
  "agentId": "hooks",
  "wakeMode": "now",
  "deliver": true,
  "channel": "last",
  "to": "+628123456789",
  "model": "openai/gpt-4o-mini",
  "timeoutSeconds": 120
}

• message (wajib): Prompt atau pesan untuk diproses agen.
• deliver: Jika true, respons agen akan dikirim ke saluran perpesanan.
• wakeMode: now (segera) atau next-heartbeat (tunggu jadwal berikutnya).

​

Keamanan

• Simpan endpoint webhook di belakang loopback, tailnet (Tailscale), atau reverse proxy tepercaya.
• Gunakan token hook khusus; jangan gunakan kembali token autentikasi gateway.
• Kegagalan autentikasi yang berulang akan dibatasi (rate-limited) per alamat klien.
• Payloads hook dianggap tidak tepercaya dan dibungkus dengan batas keamanan secara default.