Skip to content

Examples

OpenClaw accepts natural-language requests. You do not need a rigid command grammar unless you want to force the skill explicitly.

Natural-Language Examples

Example 1: Start a task with an explicit engine

Start PRJ-284 in the example project using Claude Code.

Parsed intent:

  • task: PRJ-284
  • project: example
  • engine: claude-code

Example 2: Fix code in a specific project

Use Codex to fix README command examples in the example project.

Parsed intent:

  • engine: codex
  • project: example
  • objective: fix README command examples

Example 3: Documentation work with Gemini CLI

Use Gemini CLI to draft notes for DOC-12 in the example project.

Parsed intent:

  • engine: gemini-cli
  • task: DOC-12
  • project: example

Example 4: Update a mapped project path

Update the example project path to /absolute/path/to/projects/example-project.

Action:

  • update the example mapping in OpenClaw agent memory

Example 5: Default engine

Implement API pagination and add tests in the example project.

Parsed intent:

  • engine: claude-code (default)
  • project: example

Explicit Skill Form

If you want to force the skill name directly:

/skill preqstation-dispatch implement PROJ-284 using codex
!/skill preqstation-dispatch review PROJ-284 using claude-code

Telegram relays typically use the ! prefix form.

Branch Field Example

Implement PROJ-284 in the example project
branch_name="feature/rate-limiting"

Result:

  • branch normalizes to preqstation/PROJ/feature-rate-limiting

Session Management

List running sessions

What is currently running in OpenClaw sessions?

Inspect one session

Show progress for session openclaw-claude-20260221-131240.

Engine Selection Rules

  1. If the message names an engine, OpenClaw uses it.
  2. If omitted, OpenClaw defaults to claude-code.

Examples:

"Use Codex to..." → codex
"Use Gemini CLI to..." → gemini-cli
"Implement PROJ-284" → claude-code

Typical Intents

IntentExample
Plan taskPlan PROJ-284 in the example project
Implement taskImplement PROJ-284 using Codex
Review taskReview PROJ-284
Fix docsUpdate README examples in the docs project
Monitor sessionShow progress for session <id>
Update mappingSet proj path to /absolute/path/to/repo

Output Examples

Success:

completed: PROJ-284 via claude-code at /tmp/openclaw-worktrees/proj/preqstation-proj-feature-rate-limit

Failure:

failed: PROJ-284 via codex at /tmp/openclaw-worktrees/proj/preqstation-proj-feature-rate-limit - Tests failed: 3 failures in auth.test.js