OpenClaw 命令：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