Use OpenClaw with Commonstack

Configure Commonstack as the LLM provider for your OpenClaw instance with a single install script.

1

Prerequisites

Requirement	Details
Operating system	macOS or Linux (Windows not currently supported)
OpenClaw	Installed and running
API key	Get from your Commonstack dashboard

2

Run the install script

The script detects your OpenClaw environment and launches an interactive setup.

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

3

Follow the interactive setup

The script will guide you through language selection, API endpoint selection, and key input:

Commonstack Setup for OpenClaw

◇ Select language
  中文 / English

◇ Select API endpoint
  ● Asia (https://apibot.lingsucloud.cn/v1)
  ○ Global (https://api.commonstack.ai/v1)

◇ Enter your CommonStack API Key
  ak-xxxx...xxxx

◇ 31 available models loaded
◇ CommonStack Provider configured
◇ Gateway restarted

Endpoint	URL	Recommended for
Asia	https://apibot.lingsucloud.cn/v1	China and APAC
Global	https://api.commonstack.ai/v1	All other users

4

Confirm the configuration

After setup, the script outputs a summary:

◇ Configuration summary ────────────────────
  API endpoint:    https://apibot.lingsucloud.cn/v1
  Default model:   commonstack/openai/gpt-5.2
  Available models (31):
    - anthropic/claude-sonnet-4-6
    - anthropic/claude-opus-4-5
    - openai/gpt-5.2, openai/gpt-5
    - google/gemini-3.1-pro-preview
    - deepseek/deepseek-r1-0528
    ... and more

  Switch models:   /model commonstack/<model-id>
  Dashboard:       http://127.0.0.1:18789/?token=****

● Configuration complete

Switching models

Once configured, OpenClaw defaults to calling models through Commonstack. To switch models, use the /model command in OpenClaw:

/model commonstack/anthropic/claude-sonnet-4-6

Model IDs follow the format commonstack/<provider>/<model>. Use the models listed in the configuration summary.

Restoring the original configuration

The install script automatically backs up all modified files. To revert to your previous configuration:

curl -fsSL https://download.commonstack.ai/restore.sh | bash