> ## Documentation Index
> Fetch the complete documentation index at: https://doc.onetoken.one/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

> OpenClaw is an open agent platform that runs on your machine and works through chat apps you already use.

## Install

<Note>
  Use Node **≥ 22** before installing.
</Note>

```shellscript theme={null} theme={null}
npm install -g openclaw@latest
```

### Terminal onboarding

```shellscript theme={null} theme={null}
openclaw onboard
```

Choose `Yes`

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/1.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=339b172023bbcc05689eeb4fcb185216" alt="Oc 1" width="1212" height="814" data-path="public/cn/oc-1.png" data-path="images/OpenClaw/1.webp" />

Choose `QuickStart`

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/2.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=f8dee94cca842a1974d45690b11a3799" alt="Oc 2" width="1212" height="814" data-path="public/cn/oc-2.png" data-path="images/OpenClaw/2.webp" />

Choose `Skip for now`

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/3.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=65b565123147e70694b374ee9aa0250b" alt="Oc 3" width="1212" height="814" data-path="public/cn/oc-3.png" data-path="images/OpenClaw/3.webp" />

Choose `All providers`

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/4.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=2efe8e15ee311943734c7da03379ad9b" alt="Oc 4" width="1212" height="814" data-path="public/cn/oc-4.png" data-path="images/OpenClaw/4.webp" />

Pick a default model (you can use `Keep current` and edit the config next)

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/5.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=da23934db083dc30a18fdff0a71ccadb" alt="Oc 5" width="1212" height="814" data-path="public/cn/oc-5.png" data-path="images/OpenClaw/5.webp" />

Link an account if needed, otherwise `Skip for now`

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/6.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=699060e0530f70e78fd48fdce4f3be51" alt="Oc 6" width="1212" height="814" data-path="public/cn/oc-6.png" data-path="images/OpenClaw/6.webp" />

Configure skills: choose `Yes`

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/7.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=a2814818acdb405523300abe54163efb" alt="Oc 7" width="1212" height="814" data-path="public/cn/oc-7.png" data-path="images/OpenClaw/7.webp" />

Choose `npm`

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/8.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=fe27c24cba93a28a626445991dd9b09c" alt="Oc 8" width="1212" height="814" data-path="public/cn/oc-8.png" data-path="images/OpenClaw/8.webp" />

Pick the skills you need

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/9.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=56611d756d9118c75670940c107c0036" alt="Oc 9" width="1212" height="814" data-path="public/cn/oc-9.png" data-path="images/OpenClaw/9.webp" />

Select all `No` where shown

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/10.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=23ada16bca2a7db3f1854ee9fe4e33a0" alt="Oc 10" width="1212" height="814" data-path="public/cn/oc-10.png" data-path="images/OpenClaw/10.webp" />

`Skip for now`

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/OpenClaw/11.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=4ba6edacb7c3442331c59968c31039ca" alt="Oc 11" width="1212" height="814" data-path="public/cn/oc-11.png" data-path="images/OpenClaw/11.webp" />

Choose `Hatch in UI`

### 修改配置文件

打开 \~/.openclaw/openclaw\.json 文件，增加以下配置：

```
{
"models": {
    "mode": "merge",
    "providers": {
      "onetoken": {
        "baseUrl": "https://onetoken.one/v1",
        "apiKey": "API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-5",
            "name": "claude-sonnet-4-5",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 1000000,
            "maxTokens": 64000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "onetoken/claude-sonnet-4-5"
      },
      "workspace": "your_workspace_path",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}
```
