Knowledge Base

Everything you need to know about OpenClaw

🚀 Getting Started

What is OpenClaw?

OpenClaw is a self-hosted AI agent framework that gives you a personal assistant capable of:

  • Reading and sending emails
  • Managing your calendar
  • Controlling smart home devices
  • Automating repetitive tasks
  • Integrating with Telegram, Discord, WhatsApp, and more

Unlike cloud-based assistants, OpenClaw runs on your infrastructure, giving you complete control over your data and privacy.

Why Choose OpenClaw Pro?

Setting up and maintaining an AI agent can be complex. OpenClaw Pro handles:

  • Installation: We deploy OpenClaw on your chosen infrastructure
  • Configuration: Custom setup tailored to your workflow
  • Security: Hardened setup with best practices
  • Maintenance: Regular updates and monitoring
  • Support: Direct access to experts when you need help

Quick Start Guide

  1. Choose your plan: Visit our pricing page
  2. Submit inquiry: Fill out the contact form with your requirements
  3. Consultation call: We'll discuss your needs (15-30 min)
  4. Setup begins: We deploy and configure your agent
  5. Training session: Learn to use your new AI assistant
  6. Go live: Start automating your workflow

💻 Installation

System Requirements

OpenClaw can run on various platforms:

  • VPS/Cloud: 2GB RAM, 10GB storage (recommended)
  • Raspberry Pi: Pi 4 (4GB+) or Pi 5
  • Local Machine: Linux, macOS, or Windows (WSL2)

Software Requirements:

  • Node.js 18+ or 20+
  • Git
  • PM2 (process manager)

Recommended Hosting Providers

Budget-Friendly ($5-10/month):

  • DigitalOcean Droplets
  • Linode/Akamai
  • Hetzner Cloud
  • Vultr

Premium ($15+/month):

  • AWS Lightsail
  • Google Cloud Compute

DIY Installation (Self-Service)

If you want to try installing OpenClaw yourself:

# Install Node.js 20+
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install OpenClaw globally
sudo npm install -g openclaw

# Initialize
openclaw init

# Start the gateway
openclaw gateway start

Note: Self-installation requires technical knowledge. For hassle-free setup, consider our Basic plan.

⚙️ Configuration

Core Configuration Files

OpenClaw uses several configuration files in ~/.openclaw/:

  • config.yaml: Main configuration (API keys, providers)
  • workspace/AGENTS.md: Agent behavior and rules
  • workspace/SOUL.md: Agent personality
  • workspace/USER.md: Your preferences

Setting Up Your First Integration

Example: Connecting Telegram

  1. Create a bot via @BotFather
  2. Copy your bot token
  3. Add to config.yaml:
plugins:
  entries:
    telegram:
      enabled: true
      config:
        botToken: "YOUR_BOT_TOKEN"
        allowedUsers:
          - your_telegram_id
  • Restart OpenClaw: openclaw gateway restart
  • 🔌 Integrations

    Available Integrations

    💬 Messaging

    • Telegram
    • Discord
    • WhatsApp (via Android node)
    • SMS/iMessage (via iOS node)

    📧 Email & Calendar

    • Gmail
    • Google Calendar
    • Outlook
    • Exchange

    🏠 Smart Home

    • Home Assistant
    • Philips Hue
    • MQTT

    🛠️ Productivity

    • Google Drive
    • Notion
    • Slack
    • GitHub

    🎯 Skills & Automation

    What are Skills?

    Skills are specialized instruction sets that teach your agent how to perform specific tasks. Each skill includes:

    • Documentation (SKILL.md)
    • Reference files (configs, examples)
    • Scripts (automation helpers)

    Built-in Skills

    • gog: Google Workspace (Gmail, Calendar, Drive)
    • weather: Weather forecasts
    • openai-whisper: Speech-to-text
    • tmux: Remote terminal control
    • video-frames: Video processing

    Creating Custom Skills

    Pro and Enterprise plans include custom skill development. Common use cases:

    • Industry-specific workflows
    • Proprietary API integrations
    • Business automation
    • Data processing pipelines

    Contact us to discuss your custom skill needs.

    🛡️ Security

    Security Best Practices

    OpenClaw Pro includes security hardening:

    • Firewall: UFW configured to allow only necessary ports
    • SSH: Key-based auth, disabled password login
    • Updates: Automated security patches
    • Monitoring: Intrusion detection and alerts
    • Backups: Encrypted daily backups

    API Key Management

    ⚠️ Important: Never commit API keys to Git or share them publicly.

    Store sensitive credentials in:

    • ~/.openclaw/config.yaml (file permissions: 600)
    • Environment variables
    • Secret management tools (1Password, Bitwarden)

    🔧 Troubleshooting

    Common Issues

    Agent not responding

    # Check if gateway is running
    openclaw gateway status
    
    # View logs
    openclaw gateway logs --tail 50
    
    # Restart gateway
    openclaw gateway restart

    Integration not working

    Check your config.yaml for:

    • Correct API keys/tokens
    • Plugin enabled: enabled: true
    • Valid user IDs in allowedUsers

    High memory usage

    Adjust model settings in config:

    agents:
      defaults:
        model: deepseek/deepseek-chat  # Lighter model
        thinkingLevel: low

    Getting Help

    OpenClaw Pro customers get priority support:

    • Email: support@openclawpro.me
    • Telegram: @openclawpro
    • Response Times:
      • Basic: 48 hours
      • Pro: 12 hours
      • Enterprise: 2 hours

    📚 API Reference

    Coming Soon

    Detailed API documentation for advanced users and developers will be added here.

    Topics will include:

    • REST API endpoints
    • WebSocket connections
    • Custom plugin development
    • Skill creation API