Files
openclaw-openclaw/docs/cli/docs.md
Peter Steinberger f7d7148cf0 docs: rewrite published docs grounded in current source (#100142)
Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green.

Closes #100141
2026-07-05 00:32:47 -04:00

2.0 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.

Usage

openclaw docs                       # print docs entrypoint and example search
openclaw docs <query...>            # search the live docs index
Argument Description
[query...] Free-form search query. Multi-word queries are joined with spaces and sent as one.

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

Examples

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

How it works

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

Output

In a rich (TTY) terminal, results render as a heading followed by a bullet list: page title, 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 prints the error message.