# OpenClaw Setup Guide

> Connect OpenClaw to LLMoxy's Anthropic Messages endpoint through openclaw.json.

Website: [https://openclaw.ai](https://openclaw.ai)

Source: [GitHub openclaw/openclaw](https://github.com/openclaw/openclaw) · China mirror: [Gitee OpenClaw-CN](https://gitee.com/OpenClaw-CN/openclaw-cn)

OpenClaw (renamed from Clawdbot) configures models in a local `openclaw.json`. If a plugin or SDK fails to install, change the package name to OpenClaw and try again.

Before you start, get an [LLMoxy token](https://en.llmoxy.com/docs/get-started/get-token). The **auto** group is recommended.

## Install

```bash
npm i -g openclaw
```

Configuration file location:

| System | Path |
| --- | --- |
| Windows | `%USERPROFILE%\.openclaw\openclaw.json` |
| macOS / Linux | `~/.openclaw/openclaw.json` |

You can also download a full template, replace the key, and overwrite the file above:

- [openclaw.json for Windows](https://en.llmoxy.com/docs-assets/migrated/tutorial-openclaw/file-01.json)
- [openclaw.json for macOS](https://en.llmoxy.com/docs-assets/migrated/tutorial-openclaw/file-02.json)

## Connect to LLMoxy

Merge the two sections below into your existing `openclaw.json`. The Anthropic-compatible URL does **not** include `/v1`.

```json
{
  "models": {
    "providers": {
      "claude": {
        "baseUrl": "https://llmoxy.com",
        "apiKey": "your LLMoxy API Key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-5-5",
            "name": "claude-opus-5-5",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "claude/claude-opus-5-5" },
      "models": {
        "claude/claude-opus-5-5": { "alias": "claude-opus-5-5" }
      }
    }
  }
}
```

If you use the "Custom server / Custom model" option in the UI, enter the same values:

| Field | Value |
| --- | --- |
| `baseUrl` / API endpoint | `https://llmoxy.com` |
| `api` | `anthropic-messages` |
| `apiKey` | LLMoxy token |
| Model ID | `claude-opus-5-5` |

![Custom model](https://en.llmoxy.com/docs-assets/migrated/tutorial-openclaw/image-01.png)

## Launch

```bash
openclaw gateway
```

Open `http://localhost:18789` in your browser.

## FAQ

**Install fails or the package can't be found**
The repository was renamed. Use `openclaw` for installation and plugins, not `clawdbot`.

**Using OpenAI-compatible instead of Anthropic**
Change `api` to `openai-completions` and `baseUrl` to `https://llmoxy.com/v1`.

This is the markdown version of https://en.llmoxy.com/docs/code-tutorials/openclaw.
