OpenClaw Commands: O guia de referência completo de 2026 (v2026.4.21) — EasyClaw

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

# Start the gateway (foreground)
openclaw gateway start

# Start gateway as background daemon
openclaw gateway start --daemon

# Stop the gateway
openclaw gateway stop

# Restart the gateway (applies config changes)
openclaw gateway restart

# Check gateway status
openclaw gateway status

# Stream gateway logs
openclaw gateway logs --follow

# Tail last N lines
openclaw gateway logs --tail 100

# List all registered agents
openclaw agent list

# Start a specific agent
openclaw agent start my-agent

# Stop an agent gracefully
openclaw agent stop my-agent

# Force-kill an unresponsive agent
openclaw agent stop my-agent --force

# View agent runtime status and uptime
openclaw agent status my-agent

# Stream logs for a specific agent
openclaw agent logs my-agent --follow

# Reload agent config without full restart
openclaw agent reload my-agent

# List all configured channels
openclaw channel list

# Add a Telegram channel
openclaw channel add --provider telegram --token YOUR_BOT_TOKEN --name my-telegram

# Add a WhatsApp channel (via WhatsApp Cloud API)
openclaw channel add --provider whatsapp --token YOUR_TOKEN --phone-id YOUR_PHONE_ID --name my-whatsapp

# Add a Discord channel
openclaw channel add --provider discord --token YOUR_BOT_TOKEN --guild-id YOUR_GUILD_ID --name my-discord

# Add Google Chat channel
openclaw channel add --provider google-chat --credentials ./service-account.json --space-id YOUR_SPACE --name my-gchat

# Add Synology Chat channel
openclaw channel add --provider synology --webhook-url YOUR_WEBHOOK_URL --name my-synology

# Test a channel connection
openclaw channel test my-telegram

# Remove a channel
openclaw channel remove my-telegram

# Update channel config (e.g., rotate token)
openclaw channel update my-telegram --token NEW_TOKEN

# Enable/disable a channel without removing it
openclaw channel disable my-telegram
openclaw channel enable my-telegram

# List installed skills
openclaw skill list

# Search the skill registry
openclaw skill search "web scrape"

# Install a skill
openclaw skill install web-scraper

# Install a specific version
openclaw skill install web-scraper@2.1.0

# Update a skill
openclaw skill update web-scraper

# Update all skills
openclaw skill update --all

# Remove a skill
openclaw skill remove web-scraper

# Show skill details and required config
openclaw skill info web-scraper

# List available models
openclaw model list

# Set the default model
openclaw model use gpt-4o

# Set model for a specific agent
openclaw model use claude-3-7-sonnet --agent my-agent

# Show current model config
openclaw model show

# 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