Skip to main content

OpenClaw Configuration Guide

Configure OpenClaw to connect to your AI models and messaging channels.

Basic Configuration​

After completing the installation, use the onboard command:

openclaw onboard

You can choose your AI providers (e.g., Anthropic, OpenAI, OpenRouter) and enter your API keys as prompted.

Manual Configuration​

OpenClaw's primary configuration file is located at: ~/.openclaw/openclaw.json (Linux/macOS) or %USERPROFILE%\.openclaw\openclaw.json (Windows).

In this file, you can manually define:

  • API Keys: e.g., OPENROUTER_API_KEY.
  • Preferred Models: Default models for different tasks.
  • Gateway Token: Used for authentication.

Using the Brave Search API is recommended for web-search capabilities:

openclaw configure --section web

Connecting Messaging Channels​

OpenClaw supports multiple channels:

  • Telegram: Obtain a token via @BotFather.
  • WhatsApp: Connect by scanning a QR code.
  • Discord: Create a Bot and obtain its token.
  • Mattermost: Use a Personal Access Token.

Run openclaw onboard and select Channels to configure them.

Starting the Gateway​

Once configured, start OpenClaw:

openclaw gateway run

Then access the console via openclaw dashboard.