OpenClaw

OpenClaw Deployment Guide

(With Third-Party API Interactive Configuration)

1. System Requirements

• OS: macOS, Linux, Windows (On Windows, we strongly recommend running OpenClaw under WSL2)
• Node.js: Version ≥ 22
• NPM: Bundled with Node.js installation

2. Discord Bot Configuration

1. Go to Discord Developer Portal and create a new application
2. Navigate to the Bot tab and enable the following Intents:
   • Message Content
   • Server Members
   • Presence
3. Copy the Bot Token (save it for Step 4)
4. Use the OAuth2 URL Generator to create an invite link and add the bot to your server
5. Obtain the Channel ID of your target channel (Right-click channel → Copy ID; Developer Mode must be enabled)

3. Installation

Install using the official script (auto-detects OS, installs Node.js if missing, and launches the configuration wizard):

curl -fsSL https://openclaw.ai/install.sh | bash

The installer will automatically:

• Install the OpenClaw CLI
• Launch the interactive onboarding wizard
• Install the daemon (background service) for 24/7 operation

Troubleshooting: If you encounter permission errors, use sudo or verify that curl is installed.

4. Configure Third-Party API (Canopy Wave, etc.)

Interactive Wizard Setup

After running the install script or executing openclaw onboard, follow these steps:

1. Gateway Settings: Keep defaults or modify port/authentication as needed
2. Select Model Provider: Choose Custom Provider
3. API Base URL: Enter your third-party API endpoint
   https://api.canopywave.io/v1
4. API Key Method: Select Paste API key now
5. Enter API Key: Paste your Canopy Wave (or other provider) API key
6. Endpoint Compatibility: Select OpenAI-compatible
7. Model ID: Enter the model identifier
   moonshotai/kimi-k2.5
8. Verification: The system will verify the connection and display Verification successful
9. Endpoint ID: Auto-generated (e.g., custom-inference-canopywave-io), no manual input required

Adding Additional Models

To add more models from the same provider, or to add other providers later:

openclaw onboard --add-model

Alternative: Manual Configuration (Advanced)

If you need to manually edit the configuration file (located at ~/.openclaw/openclaw.json), use this structure:

"models": {
  "mode": "merge",
  "providers": {
    "canopywave": {
      "baseUrl": "https://api.canopywave.io/v1",
      "apiKey": "your-api-key",
      "api": "openai-completions",
      "models": [
        {
          "id": "moonshotai/kimi-k2.5",
          "name": "Kimi K2.5",
          "reasoning": true,
          "contextWindow": 204800,
          "maxTokens": 8192
        }
      ]
    }
  }
}

Validate configuration:

openclaw doctor

5. Configure Communication Channels (Discord)

During the wizard or subsequent configuration:

1. Select Platform: Discord / Telegram / WhatsApp (Discord for this guide)
2. Enter Bot Token: Paste the Discord Bot Token from Step 2
3. Set Channels: Enter allowed Channel IDs (comma-separated for multiple)
4. Permission Setup: Restrict allowedUsers to your Discord ID only (recommended)

6. Startup & Testing

# Start the gateway (background service)
openclaw gateway start

# Check gateway status
openclaw gateway status

# Launch interactive TUI
openclaw tui

# Diagnose and auto-fix issues
openclaw doctor --fix

Testing Workflow

1. @mention the bot or send a message in the configured Discord channel
2. Verify that the bot successfully calls the Canopy Wave API and returns a response

7. Updates & Maintenance

# Update to latest stable version
openclaw update --channel stable

# View real-time logs
openclaw logs --follow

# Complete uninstallation
npm uninstall -g openclaw && rm -rf ~/.openclaw

8. Security Best Practices

• User Restriction: Strictly limit the allowedUsers field in your channel configuration to your Discord ID only, preventing unauthorized access.
• Key Protection: Store API keys securely to prevent exposure. Immediately rotate (revoke and regenerate) any keys that have been leaked or compromised.
• Public Access: When exposing the Gateway to the public internet, ensure your Token remains confidential and enable device authentication to restrict access to authorized devices only. Never grant access to unknown or untrusted devices.

9. Troubleshooting

Tip: After initial setup, you can modify settings anytime using openclaw config, or re-run openclaw onboard to add new model providers.