default to 5.2

Author: matthewlouisbrockman

docs/agents/openclaw-gateway.mdx

@@ -24,7 +24,7 @@ const sandbox = await Sandbox.create('openclaw', {
 })
 
 // 2. Set the default model
-await sandbox.commands.run('openclaw config set agents.defaults.model.primary openai/gpt-5.3-codex')
+await sandbox.commands.run('openclaw config set agents.defaults.model.primary openai/gpt-5.2')
 
 // 3. Start the gateway with token auth
 sandbox.commands.run(
@@ -58,7 +58,7 @@ sandbox = Sandbox.create("openclaw", envs={
 }, timeout=3600)
 
 # 2. Set the default model
-sandbox.commands.run("openclaw config set agents.defaults.model.primary openai/gpt-5.3-codex")
+sandbox.commands.run("openclaw config set agents.defaults.model.primary openai/gpt-5.2")
 
 # 3. Start the gateway with token auth
 sandbox.commands.run(
@@ -158,6 +158,73 @@ Once approved, the browser connects and the gateway UI loads.
 | `--token <value>` | The auth token (passed as `?token=` in the URL) |
 | `--port <number>` | Gateway listen port (default: `18789`) |
 
+## How to restart the gateway
+
+Use this when the gateway is already running and you want a clean restart (for example, after changing model or env settings).
+
+<Info>
+We can't use the `openclaw gateway restart` command here. Some SDK environments cannot target a specific Unix user in `commands.run`. The commands below use the default command user context.
+</Info>
+
+<CodeGroup>
+```typescript JavaScript & TypeScript
+const TOKEN = process.env.OPENCLAW_APP_TOKEN || 'my-gateway-token'
+const PORT = 18789
+
+// 1) Kill existing gateway processes if present
+await sandbox.commands.run(
+  `bash -lc 'for p in "[o]penclaw gateway" "[o]penclaw-gateway"; do for pid in $(pgrep -f "$p" || true); do kill "$pid" >/dev/null 2>&1 || true; done; done'`
+)
+await new Promise((r) => setTimeout(r, 1000))
+
+// 2) Start gateway again
+await sandbox.commands.run(
+  `openclaw gateway --allow-unconfigured --bind lan --auth token --token ${TOKEN} --port ${PORT}`,
+  { background: true }
+)
+
+// 3) Wait for listening socket
+for (let i = 0; i < 45; i++) {
+  const probe = await sandbox.commands.run(
+    `bash -lc 'ss -ltn | grep -q ":${PORT} " && echo ready || echo waiting'`
+  )
+  if (probe.stdout.trim() === 'ready') break
+  await new Promise((r) => setTimeout(r, 1000))
+}
+```
+```python Python
+import os, time
+
+TOKEN = os.environ.get("OPENCLAW_APP_TOKEN", "my-gateway-token")
+PORT = 18789
+
+# 1) Kill existing gateway processes if present
+sandbox.commands.run(
+    """bash -lc 'for p in "[o]penclaw gateway" "[o]penclaw-gateway"; do
+for pid in $(pgrep -f "$p" || true); do
+  kill "$pid" >/dev/null 2>&1 || true
+done
+done'"""
+)
+time.sleep(1)
+
+# 2) Start gateway again
+sandbox.commands.run(
+    f"openclaw gateway --allow-unconfigured --bind lan --auth token --token {TOKEN} --port {PORT}",
+    background=True,
+)
+
+# 3) Wait for listening socket
+for _ in range(45):
+    probe = sandbox.commands.run(
+        f'bash -lc \'ss -ltn | grep -q ":{PORT} " && echo ready || echo waiting\''
+    )
+    if probe.stdout.strip() == "ready":
+        break
+    time.sleep(1)
+```
+</CodeGroup>
+
 ## Related
 
 <CardGroup cols={4}>