openclaw - 💡(How to fix) Fix hooks/agent with deliver: false accepts request but never processes agent session [1 participants]

Summary

When sending a POST to /hooks/agent with deliver: false, the gateway returns HTTP 200 with a valid runId, but the agent session is never executed. The session remains in empty status with 0 messages and 0 tool calls.

Steps to reproduce

1. Send a hooks request with deliver: false:

curl -X POST http://localhost:3777/hooks/agent \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "main",
    "channel": "cliq",
    "channelId": "quality-audit",
    "message": "Hello from Cliq",
    "from": "cliq:channel:quality-audit",
    "deliver": false
  }'

1. Response is HTTP 200 with a valid runId:

{"runId": "abc123-..."}

1. Check the session — it stays in empty status:

# Session has 0 messages, 0 tool calls, status: "done" (never started)

Expected behavior

The agent session should be created and processed normally. The deliver: false flag should only suppress the delivery/announcement of the response back to the channel, not prevent the agent from running entirely.

Actual behavior

The gateway accepts the request, returns a success response with a runId, but the agent never processes the session. The session is created but remains empty.

Context

This was discovered while building a Zoho Cliq ↔ OpenClaw integration. The relay sends deliver: false because it handles response delivery itself (polling the session and forwarding to Cliq). However, since the agent never runs, the relay never gets a response.

Workaround: Setting deliver: true makes the agent process correctly, but then responses are also sent to the default Telegram channel, causing duplicate delivery.

Related issues

• #36325 — deliver: false still injects system event (different but related: in that case the agent does run)
• #33271 — /hooks/wake silently drops requests with 200 (same pattern: accepts but doesn't process)

Environment

• OpenClaw gateway (self-hosted, latest as of 2026-04-01)
• Hook endpoint: /hooks/agent