OpenClaw Usage Expert

⚠️ Important Note: Document Timeliness

• Prioritize the latest documentation: When encountering uncertain issues, please visit the OpenClaw GitHub Repository to check the latest README and documentation
• Official Documentation: Visit docs.openclaw.ai for the latest official documentation
• Purpose of this skill: Provides basic knowledge and common operation guides, but for new features or changes, refer to the latest resources

Quickly Determine User Status

1. Not installed: User asks how to install, where to start → Refer to

   references/installation.md

2. Installation issues: User encounters installation errors, service startup failures, configuration problems → Refer to

   references/troubleshooting.md

3. Installed and wants to use: User wants to create bots, execute tasks, configure features → Refer to

   references/usage.md

   and

   references/configuration.md

4. Needs uninstallation: User wants to uninstall OpenClaw → Refer to

   references/uninstallation.md

Quick Start

First-time Installation

# Install OpenClaw
npm install -g openclaw@latest

# Run onboarding wizard
openclaw onboard --install-daemon

references/installation.md

Check Status

# Check Gateway status
openclaw gateway status

# Run health check
openclaw doctor

Interact with Agent

openclaw agent --message "Help me complete a task"

Documentation Navigation

Installation and Deployment

• references/installation.md

  - Complete installation guide
  • System requirements
  • Multiple installation methods (official script, npm, source code)
  • Verify installation

• references/deployment.md

  - Deployment and operation guide
  • Onboarding wizard
  • Gateway startup and management
  • Service installation (launchd/systemd)
  • Remote Gateway deployment

Troubleshooting

• references/troubleshooting.md

  - Complete troubleshooting guide
  • Using the Doctor command
  • Diagnosing common issues (Gateway fails to start, authentication failure, channel connection failure, etc.)
  • Troubleshooting process
  • Log viewing methods

Usage Guide

• references/usage.md

  - Usage guide
  • Agent creation and management
  • Interacting with Agent
  • Message sending
  • Channel management
  • Workspace management
  • Automated tasks (Cron, Webhooks)
  • Updates and upgrades

Configuration Management

• references/configuration.md

  - Configuration management guide
  • Configuration file locations
  • Configuration commands (get/set/configure)
  • Examples of common configuration items
  • Multi-instance configuration
  • Configuration file permissions

Best Practices

• references/best-practices.md

  - Best practices and special scenarios
  • Best practices when assisting users
  • Handling special scenarios (creating specific-function bots, automated tasks, multi-Agent routing, remote Gateway)
  • Security recommendations
  • Performance optimization

Uninstallation Guide

• references/uninstallation.md

  - Complete uninstallation guide
  • Stop services and processes
  • Uninstall npm global package
  • Delete configuration files and directories
  • Remove system services (launchd/systemd)
  • Clean up environment variables and logs
  • Verify uninstallation completion

Quick Reference for Common Commands

# Installation and configuration
openclaw onboard --install-daemon    # Onboarding wizard
openclaw configure                    # Reconfigure
openclaw setup                        # Set up workspace

# Service management
openclaw gateway status               # Check status
openclaw gateway start                # Start
openclaw gateway stop                  # Stop
openclaw gateway install              # Install service

# Diagnosis
openclaw doctor                       # Health check
openclaw doctor --repair             # Auto repair
openclaw channels status              # Channel status

# Agent operations
openclaw agents list                  # List Agents
openclaw agent --message "..."       # Interact with Agent
openclaw message send --to ...       # Send message

# Configuration
openclaw config get <key>             # Get configuration
openclaw config set <key> <value>     # Set configuration

Reference Resources

• GitHub Repository: https://github.com/openclaw/openclaw
• Official Documentation: https://docs.openclaw.ai
• Quick Start: https://docs.openclaw.ai/start/getting-started
• Troubleshooting: https://docs.openclaw.ai/gateway/troubleshooting
• Discord Community: https://discord.gg/clawd

Workflow Recommendations

Standard Process for Handling User Requests

1. Determine user status: Based on the question, determine if the user hasn't installed, has installation issues, has installed and wants to use, or needs to uninstall
2. Refer to corresponding documentation:
   • Not installed →

     references/installation.md

   • Installation issues →

     references/troubleshooting.md

   • Wants to use →

     references/usage.md

     and

     references/configuration.md

   • Needs uninstallation →

     references/uninstallation.md

3. Provide solutions:
   • First run

     openclaw doctor

     for diagnosis
   • Provide specific steps based on diagnosis results
   • Guide users to handle sensitive information on their own
4. Verification and follow-up:
   • Verify results after each step
   • If the problem persists, suggest checking the latest GitHub documentation