openclaw

name	openclaw
description	OpenClaw CLI wrapper and docs companion for gateway, channels, models, automation, and operational workflows.

OpenClaw Skill

Local skill package for operating OpenClaw from the terminal. This repository does not install platform dependencies by itself. It wraps the openclaw CLI and provides local reference docs aligned to https://docs.openclaw.ai.

Scope

• Install and onboarding flows
• Gateway lifecycle and health operations
• Channel connection management
• Model listing, authentication, and aliases
• Scheduled automation and browser tooling
• Plugin management
• Deployment references (Docker, Nix, update, rollback)

Prerequisites

Required:

• openclaw CLI available in PATH

Common external prerequisites (depends on feature):

• Node.js and npm (for install/update flows in official docs)
• Playwright system dependencies (for browser tooling)
• Platform-specific tools such as imsg (macOS iMessage channel)
• Private networking setup such as Tailscale (if remote node access is needed)

Environment variables used by OpenClaw runtime:

• OPENCLAW_CONFIG_PATH
• OPENCLAW_STATE_DIR
• OPENCLAW_HOME

Security Boundaries

Default stance is least privilege.

Allowed by default:

• Read-only status and diagnostics (status, doctor, version, gateway status, gateway health)
• Config inspection and non-destructive operational checks

High-risk capabilities (explicit user approval required per action):

• Arbitrary shell execution (exec tool in upstream runtime)
• Elevated privilege flows
• Sub-agent spawning and delegated execution
• Plugin installation from untrusted sources
• Cron creation/modification
• Browser automation against remote websites
• Device pairing and sensor access (camera/audio/location)

Wrapper opt-in gate:

• Commands mapped to high-risk areas require OPENCLAW_WRAPPER_ALLOW_RISKY=1

Non-goals

• This repo is not the OpenClaw runtime source code.
• This repo does not provision system packages automatically.
• This repo does not manage host networking, VPN, or mobile OS permissions.
• This repo does not authorize autonomous privileged execution.

Unified Command Utility

Primary wrapper script: bash scripts/openclaw.sh [command] [args]

Command Mapping

The wrapper routes to official openclaw commands:

• install|setup|doctor|status|reset|version|tui|dashboard
  • Pass-through to openclaw ...
• service ...
  • openclaw gateway service ...
• channel login <name>
  • openclaw channels login --channel <name>
• channel list
  • openclaw channels list
• channel logout <name>
  • openclaw channels logout --channel <name>
• channel pairing
  • openclaw pairing (risky-gated)
• model auth ...
  • openclaw models auth ...
• model alias ...
  • openclaw models aliases ...
• model scan|list|set ...
  • openclaw models ...
• cron ...
  • openclaw cron ... (risky-gated)
• browser ...
  • openclaw browser ... (risky-gated)
• plugin ...
  • openclaw plugins ... (risky-gated)
• msg ...
  • openclaw message send ...
• prose ...
  • Enables open-prose plugin (risky-gated)

Documentation

• references/security-policy.md: Guardrails and approval policy
• references/prerequisites.md: Dependency and capability boundaries
• references/cli-full.md: Consolidated CLI commands
• references/config-schema.md: Config and env variable references
• references/nodes-platforms.md: Platform and node notes
• references/deployment.md: Docker, Nix, update, rollback
• references/advanced-tools.md: Plugins, browser, gateway helpers
• references/hubs.md: Docs hub links

Maintenance Notes

• Last docs normalization: 2026-02-17
• Source of truth: https://docs.openclaw.ai