OpenClaw Commands: la guida di riferimento completa per il 2026 (v2026.4.21)

openclaw <command> <subcommand> [flags]

# Install OpenClaw CLI (npm)
npm install -g openclaw

# Initialize a new project with guided setup
openclaw init

# Initialize non-interactively with defaults
openclaw init --yes --profile production

# Show current resolved configuration
openclaw config show

# Set a config value
openclaw config set gateway.port 8080

# Get a specific config value
openclaw config get gateway.port

# Generate a blank config file template
openclaw config init --output .openclaw/config.json

# Validate current config file
openclaw config validate

# List all environment variable overrides in effect
openclaw config env

# Launch a managed browser session
openclaw browser open --url https://example.com --session my-session

# Take a screenshot
openclaw browser screenshot --session my-session --output ./screenshot.png

# Execute JavaScript in the browser context
openclaw browser exec --session my-session --script "document.title"

# Click an element by CSS selector
openclaw browser click --session my-session --selector "#submit-btn"

# Fill a form field
openclaw browser fill --session my-session --selector "#email" --value "user@example.com"

# Extract page content
openclaw browser extract --session my-session --selector "article.main" --format text

# Close a browser session
openclaw browser close --session my-session

# Run a shell command through the OpenClaw runtime
openclaw shell exec --cmd "python process.py --input data.json"

# Run shell command with timeout
openclaw shell exec --cmd "npm run build" --timeout 120

# List active shell processes
openclaw shell list

# List workspace files
openclaw file list

# Read a file from the workspace
openclaw file read output/report.md

# Write content to a workspace file
openclaw file write output/result.txt --content "processed"

# Copy a file within the workspace
openclaw file copy input/raw.json output/processed.json

# Delete a workspace file
openclaw file delete output/temp.json

# Watch a file for changes (useful in pipelines)
openclaw file watch output/result.txt --on-change "openclaw agent trigger my-agent"

# Export workspace to a zip archive
openclaw workspace export --output ./backup.zip

# Import workspace from archive
openclaw workspace import --input ./backup.zip

#!/bin/bash
set -e

TARGET_URL="https://example.com/news"
CHANNEL="my-telegram"
WORKSPACE_OUT="output/summary.md"

# Step 1: Scrape the page
openclaw browser open --url "$TARGET_URL" --session scrape-session
openclaw browser extract --session scrape-session --selector "article" \\
  --format text > workspace/input/raw.txt
openclaw browser close --session scrape-session

# Step 2: Process with LLM via agent
openclaw agent trigger content-summarizer \\
  --input workspace/input/raw.txt \\
  --output "$WORKSPACE_OUT" \\
  --wait

# Step 3: Post result to Telegram
SUMMARY=$(openclaw file read "$WORKSPACE_OUT")
openclaw channel send "$CHANNEL" --message "$SUMMARY"

echo "Pipeline complete."

# Run a daily content pipeline at 7am
0 7 * * * /usr/local/bin/openclaw agent trigger daily-report --wait --quiet >> /var/log/openclaw-cron.log 2>&1

# Restart gateway every Sunday at 2am (maintenance window)
0 2 * * 0 /usr/local/bin/openclaw gateway restart --yes >> /var/log/openclaw-restart.log 2>&1

# Health check every 5 minutes, alert if failing
*/5 * * * * /usr/local/bin/openclaw gateway status --output json | \\
  grep -q '"status":"running"' || \\
  /usr/local/bin/openclaw channel send ops-alerts --message "Gateway DOWN"

# Get agent status as JSON
openclaw agent status my-agent --output json

# Example output:
# {"agent":"my-agent","status":"running","uptime":3842,"pid":19204}

# Check agent health and branch on status
STATUS=$(openclaw agent status my-agent --output json --quiet | jq -r '.status')
if [ "$STATUS" != "running" ]; then
  openclaw agent start my-agent
fi

- name: Trigger OpenClaw content agent
  run: |
    openclaw agent trigger content-agent \\
      --input ./keywords.json \\
      --output ./output/article.md \\
      --wait \\
      --timeout 300 \\
      --output-format json
  env:
    OPENCLAW_API_KEY: \ secrets.OPENCLAW_API_KEY
    OPENCLAW_GATEWAY_URL: \ secrets.OPENCLAW_GATEWAY_URL

# Generate a scoped API key (read-only)
openclaw auth key create --name ci-readonly --scopes "agent:read,channel:read"

# Generate a key with specific agent access only
openclaw auth key create --name deploy-bot --scopes "agent:trigger:my-agent"

# List active API keys
openclaw auth key list

# Revoke a compromised key immediately
openclaw auth key revoke KEY_ID

# Store API key in system keychain (avoid plaintext in config)
openclaw config set-secret api_key YOUR_KEY

# Restrict workspace file access
openclaw config set security.workspace_isolation true

# Disable shell execution in production (if not needed)
openclaw config set security.allow_shell_exec false

# Enable audit logging
openclaw config set logging.audit true
openclaw config set logging.audit_path /var/log/openclaw/audit.log