Files
openclaw/docs/cli/docs.md
2026-05-27 00:58:09 +01:00

2.1 KiB

summary, read_when, title
summary read_when title
CLI reference for `openclaw docs` (search the live docs index)
You want to search the live OpenClaw docs from the terminal
You need to know which hosted search API the docs CLI calls
Docs

openclaw docs

Search the live OpenClaw docs index from the terminal. The command calls OpenClaw's Cloudflare-hosted docs search API and renders the results in your terminal.

Usage

openclaw docs                       # print docs entrypoint and example search
openclaw docs <query...>            # search the live docs index

Arguments:

Argument Description
[query...] Free-form search query. Multi-word queries are joined with spaces and sent as one.

Examples

openclaw docs browser existing-session
openclaw docs sandbox allowHostControl
openclaw docs gateway token secretref

With no query, openclaw docs prints the docs entrypoint URL plus a sample search command instead of running a search.

How it works

openclaw docs calls https://docs.openclaw.ai/api/search and renders the JSON results. The search call uses a fixed 30 second timeout.

Output

In a rich (TTY) terminal, results render as a heading followed by a bullet list. Each bullet shows the page title, the linked docs URL, and a short snippet on the next line. Empty results print "No results.".

In non-rich output (piped, --no-color, scripts), the same data renders as Markdown:

# Docs search: <query>

- [Title](https://docs.openclaw.ai/...) - snippet
- [Title](https://docs.openclaw.ai/...) - snippet

Exit codes

Code Meaning
0 Search succeeded (including zero-result responses).
1 The hosted docs search API call failed; stderr is printed inline.