OpenClaw Commands: 전체 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

# 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