OpenClaw Installation Guide

One: Overview

OpenClaw is an open-source personal AI assistant platform designed for automated tasks, system integration, and multi-channel messaging. It runs natively in your terminal.

By configuring OpenClaw to use APIBox as its provider, you can access GPT-5, Claude 4.6, and other leading models directly—bypassing API restrictions while keeping costs incredibly low.

Two: System Requirements

• macOS: 10.15+
• Linux: Mainstream distributions (Ubuntu 18.04+, Debian 10+, CentOS 7+, etc.)

Three: Installation Steps

1. Install OpenClaw CLI

Open your terminal and run the one-click install script:

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

If you encounter permission errors, prepend sudo:

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

Once installed, the script will print the OpenClaw version number to confirm success.

2. Get Your API Key

Go to the APIBox Console to generate an API Key.

Tip: APIBox supports OpenAI-compatible endpoints, giving you access to all top-tier models from one account.

3. Configure the API Provider

Run the following CLI commands to configure OpenClaw (you can skip the interactive openclaw onboard wizard if you prefer this method).

openclaw config set defaults.model "apibox/claude-sonnet-4-6"
openclaw config set providers.apibox.baseUrl "https://api.apibox.cc/v1"
openclaw config set providers.apibox.apiKey "your_APIBox_Key"

Alternatively, you can manually edit ~/.openclaw/openclaw.json and add the provider block:

"providers": {
  "apibox": {
    "baseUrl": "https://api.apibox.cc/v1",
    "apiKey": "your_APIBox_Key"
  }
}

4. Start the Gateway

Launch the OpenClaw background service:

openclaw gateway start

You can verify the status anytime using openclaw gateway status or monitor the logs via openclaw logs --follow.

Four: Troubleshooting

❌ Terminal says “command not found”

Cause: The OpenClaw executable isn’t in your system PATH. Fix: The install script usually handles this, but if it failed, add it manually:

export PATH="$HOME/.openclaw/bin:$PATH"
source ~/.bashrc # or ~/.zshrc

❌ API Connection Errors

Cause: The baseUrl is missing the /v1 suffix or the config tree is wrong. Fix: Run openclaw config get providers.apibox and ensure the URL is exactly https://api.apibox.cc/v1.

❌ macOS Security Prompts

Cause: macOS blocks unsigned binaries, or the terminal lacks disk access. Fix: Go to System Settings > Privacy & Security > Full Disk Access and check your Terminal app. If an app is blocked, click “Allow Anyway” under the Security section.