Quiz: Gateway Architecture — OpenClaw Academy

1 What type of process is the OpenClaw Gateway?

A short-lived script that runs on demand when a message arrives A long-lived Node.js process that runs continuously as a system service A Docker container managed by Kubernetes A serverless function hosted in the cloud

2 What does the default dmScope of 'main' mean for session keying?

Each DM from every sender gets its own separate session Only the main channel (Telegram) is used for DM sessions All direct messages across all channels share a single session key DMs are disabled and only group chats are allowed

3 Where does OpenClaw store session transcripts?

In a PostgreSQL database at localhost:5432 In ~/.openclaw/agents/<agentId>/sessions/ as JSONL files, one per session In Redis as JSON blobs keyed by session ID In the workspace directory alongside AGENTS.md

4 What happens to a running agent turn if the WebSocket client disconnects mid-response?

The agent turn is immediately cancelled to avoid wasted API calls The Gateway continues the turn; the client can rejoin and see the result after reconnecting The turn is paused and replayed from the beginning on reconnect The Gateway crashes and needs to be manually restarted

5 What format does ~/.openclaw/openclaw.json use?

YAML — because it's more human-readable than JSON TOML — because it supports nested tables natively JSON5 — JSON with comments and trailing commas allowed Strict JSON — no comments or trailing commas

6 In the WebSocket protocol, when you send an 'agent' request with a message, what does the Gateway respond with immediately?

The complete agent response text once the turn finishes A {runId, acceptedAt} acknowledgment — the actual response comes via streaming events An error if the agent is already busy with another request The current session token count so the client knows if compaction is needed

7 What does 'openclaw doctor' do?

It installs the latest version of OpenClaw from npm It diagnoses and repairs health issues: config validation, legacy migrations, state checks, and channel status It monitors the Gateway in real time and restarts it when it crashes It deletes old session transcripts to free up disk space

📝 Module 2 Quiz: Gateway Architecture