diff --git a/docs/cli/docs.md b/docs/cli/docs.md
index 744c50e1432..0faeb12d318 100644
--- a/docs/cli/docs.md
+++ b/docs/cli/docs.md
@@ -9,7 +9,20 @@ title: "docs"
 
 Search the live docs index.
 
+Arguments:
+
+- `[query...]`: search terms to send to the live docs index
+
+Examples:
+
 ```bash
+openclaw docs
 openclaw docs browser existing-session
 openclaw docs sandbox allowHostControl
+openclaw docs gateway token secretref
 ```
+
+Notes:
+
+- With no query, `openclaw docs` opens the live docs search entrypoint.
+- Multi-word queries are passed through as one search request.
diff --git a/docs/web/tui.md b/docs/web/tui.md
index e46a57f3f11..4d3eaef7e5f 100644
--- a/docs/web/tui.md
+++ b/docs/web/tui.md
@@ -148,7 +148,9 @@ Other Gateway slash commands (for example, `/context`) are forwarded to the Gate
 - `--session <key>`: Session key (default: `main`, or `global` when scope is global)
 - `--deliver`: Deliver assistant replies to the provider (default off)
 - `--thinking <level>`: Override thinking level for sends
+- `--message <text>`: Send an initial message after connecting
 - `--timeout-ms <ms>`: Agent timeout in ms (defaults to `agents.defaults.timeoutSeconds`)
+- `--history-limit <n>`: History entries to load (default `200`)
 
 Note: when you set `--url`, the TUI does not fall back to config or environment credentials.
 Pass `--token` or `--password` explicitly. Missing explicit credentials is an error.
@@ -161,7 +163,6 @@ No output after sending a message:
 - Check the Gateway logs: `openclaw logs --follow`.
 - Confirm the agent can run: `openclaw status` and `openclaw models status`.
 - If you expect messages in a chat channel, enable delivery (`/deliver on` or `--deliver`).
-- `--history-limit <n>`: History entries to load (default 200)
 
 ## Connection troubleshooting