openclaw — Agent Guide

No conflict-matrix pairs for this tool yet.

# OpenClaw — Agent Guide

name: openclaw ｜ version_range: 2026.8.1~2026.8.1 ｜ generated: 2026-09-01

title_en: OpenClaw - Your own personal AI assistant (local gateway + channels + automations) ｜ desc_en: Self-hosted personal AI assistant: local Gateway, chat channels, cron automations, browser automation, skills ecosystem.

Preflight

note: Node >= 22.22.3 / 24.15.0+ / 25.9.0+ required; verified with isolated Node 24.15.0 (system Node 22.22.1 rejected). npm mirror required in CN networks (npmmirror verified).

node --version

预期输出: v22.22.3 or newer (22.22.3+ / 24.15.0+ / 25.9.0+); if lower, deploy a supported Node to an isolated dir (e.g. /opt/node-v24.15.0-linux-x64) and prepend its bin to PATH

Install

note: npm global install via Tsinghua mirror; verified 331 packages in 9s (cache-accelerated, first install 1-3 min). Package ~204MB unpacked, ~1GB disk with workspace.

npm_config_registry=https://registry.npmmirror.com npm install -g openclaw@latest --no-audit --no-fund

预期输出: changed 331 packages in 9s

Operations

Verify version

note: isolated Node 24.15.0 verified

openclaw --version

Expected output: OpenClaw 2026.8.1 (ea80657)

Command surface

note: verified; subcommands pass through local Gateway, credentials required after onboard

openclaw --help | head -20

Expected output: top-level command list (cron/browser/channels/gateway/doctor etc.)

Gateway status (diagnostics, no service start)

note: verified; loopback status works without onboard

openclaw gateway status

Expected output: Gateway status on loopback (config missing before onboard is normal)

List scheduled jobs (cron)

note: command surface verified; execution requires gateway credentials (onboard). Real no-credential output below

openclaw cron list

Expected output:

gateway cron.list requires credentials before opening a websocket

Fix: configure gateway.auth token/password, pair this device, or pass --token/--password.

Config: ~/.openclaw/openclaw.json

Browser readiness check

note: command surface verified; execution requires gateway credentials

openclaw browser doctor

Expected output:

FAIL gateway: GatewayCredentialsRequiredError: gateway browser.request requires credentials before opening a websocket

Fix: configure gateway.auth token/password, pair this device, or pass --token/--password.

Config: ~/.openclaw/openclaw.json

List channels

note: command surface verified; connecting channels needs chat accounts (not tested)

openclaw channels list

Expected output:

Chat channels:

- no configured chat channels (run `openclaw channels list --all` to see installable channels)

Health check

note: verified command surface; unconfigured items before onboard are normal diagnostics

openclaw doctor

Expected output: see command output

Uninstall

note: stop daemon first if enabled; removes workspace (config/database/logs) - backup first if needed

npm uninstall -g openclaw --no-audit --no-fund && rm -rf ~/.openclaw

预期输出: removed N packages; ~/.openclaw gone = clean

Facts

writes: ~/.openclaw/ (config openclaw.json + database + logs, created by onboard; nothing written by install-only CLI) ｜ runtime: Node >= 22.22.3/24.15+/25.9+ (isolated deploy verified 24.15.0); npm global ｜ notes: Resident Gateway (daemon) on 127.0.0.1:18789 loopback by default; onboard needs model API key (not tested, zero accounts); channels need chat accounts; inbound messages untrusted, DM pairing default; tools run on host unless sandboxed; conflict matrix pair states: see matrix page (static judgment compatible with moltis - different commands, non-overlapping write surfaces)

Source: openclaw · validated 2026-09-01 · v2026.8.1~2026.8.1

← Agent index