Lesson 1 of 7 · 0%Discover commands without copying a command dumpNext
Course map

CLI Essentials and Operator Diagnostics

0 of 7 complete0 of 7

Lesson 1.1 · 25 minutes

Discover commands without copying a command dump

Build a version-scoped command crib sheet from live help and distinguish discovery from execution.

Skip course map
Current lessonDiscover commands without copying a command dump0% complete · 0/7 lessons

CLI Essentials and Operator Diagnostics

0% complete · Current: Discover commands without copying a command dump

Verifiedon 2026.7.1-2

Action boundary

Before you act

Expected result
A crib sheet ties each observed command to an installed version, question, and whether it reads or changes state.
Failure mode
A command copied from a different release or environment is treated as safe because its name sounds familiar.
Rollback
Make no state changes; discard the crib sheet and repeat help discovery against the approved target.

Start with the executable you actually have

Run openclaw --version, then use openclaw --help and narrow help such as openclaw config --help, openclaw channels --help, and openclaw update --help. Help describes the installed command surface; documentation explains intent and constraints. Keep both in the record because command names and flags can change between releases.

Lab: make a five-row crib sheet

Capture only these columns: command, question answered, read/write classification, version, and safe follow-up. Start with --version, config validate, doctor, health, and channels status. Do not run a command merely because it appears in help. Mark config set, channels add/remove, update, and any --fix action as state-changing or potentially state-changing.

Decision check

A colleague sends openclaw update --yes in chat. Is help evidence enough to run it? No. First establish install method, update status, service ownership, maintenance window, rollback evidence, and whether the command will restart the gateway.

Evidence standard

A useful excerpt shows the version and the exact help scope, but never credentials, private paths, or copied terminal history. The next lesson uses this record to separate safe config reads from writes.

Source provenanceVerification and sources

Review receipt rr_cli_command_discovery

Outcome
approved
Method
source-review
Reviewer
forge-independent-review
Reviewed

Evidence

Limitations

  • Independent source review approved read-only command discovery; commands were not run against a learner instance.

Open the public evidence snapshot

Lesson checkpoint

Ready to move on?

Mark this lesson complete when you can apply its outcome without relying on the examples above.