> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.joytokens.ai/llms.txt.

# OpenClaw

> 使用 OpenClaw 接入 JoyToken

## 前提条件

| 项目           | 值                           |
| ------------ | --------------------------- |
| OpenClaw 版本  | `2026.6.11`                 |
| 配置文件         | `~/.openclaw/openclaw.json` |
| Provider id  | `joytoken`                  |
| 模型名          | `joytoken/auto`             |
| API Key 环境变量 | `JOY_TOKEN_API_KEY`         |

OpenClaw 同时支持两种协议。Base URL、注册时的 compatibility mode 和 JoyToken 侧检查必须选择同一个协议。

## 第 1 步：安装

```bash
npm install -g openclaw@2026.6.11
openclaw --version
```

## 第 2 步：设置 API Key 和 Base URL

#### OpenAI

```bash
export JOY_TOKEN_API_KEY="sk-xxx"
export JOY_TOKEN_OPENAI_BASE_URL="https://api.joytokens.ai/openai/v1"
```

#### Anthropic

```bash
export JOY_TOKEN_API_KEY="sk-xxx"
export JOY_TOKEN_ANTHROPIC_BASE_URL="https://api.joytokens.ai/anthropic/v1"
```

长期使用时，把所选协议对应的变量加入 shell 配置。

## 第 3 步：注册 provider

#### OpenAI

```bash
openclaw onboard \
  --non-interactive \
  --accept-risk \
  --auth-choice custom-api-key \
  --custom-provider-id joytoken \
  --custom-base-url "$JOY_TOKEN_OPENAI_BASE_URL" \
  --custom-compatibility openai \
  --custom-model-id auto \
  --custom-api-key "$JOY_TOKEN_API_KEY" \
  --skip-channels \
  --skip-daemon \
  --skip-skills \
  --skip-search \
  --skip-ui \
  --skip-health
```

#### Anthropic

```bash
openclaw onboard \
  --non-interactive \
  --accept-risk \
  --auth-choice custom-api-key \
  --custom-provider-id joytoken \
  --custom-base-url "$JOY_TOKEN_ANTHROPIC_BASE_URL" \
  --custom-compatibility anthropic \
  --custom-model-id auto \
  --custom-api-key "$JOY_TOKEN_API_KEY" \
  --skip-channels \
  --skip-daemon \
  --skip-skills \
  --skip-search \
  --skip-ui \
  --skip-health
```

## 第 4 步：确认配置

```bash
cat ~/.openclaw/openclaw.json
```

配置中应包含 `joytoken/auto`，并且 API 值与所选 tab 一致：

#### OpenAI

```json
{
  "models": {
    "providers": {
      "joytoken": {
        "baseUrl": "https://api.joytokens.ai/openai/v1",
        "api": "openai-completions"
      }
    }
  }
}
```

#### Anthropic

```json
{
  "models": {
    "providers": {
      "joytoken": {
        "baseUrl": "https://api.joytokens.ai/anthropic/v1",
        "api": "anthropic-messages"
      }
    }
  }
}
```

## 第 5 步：验证

```bash
openclaw models status
```

输出里应看到 `joytoken/auto`。发起一次调用：

```bash
openclaw infer model run \
  --local \
  --model joytoken/auto \
  --prompt "Reply with exactly: pong" \
  --json
```

成功时，返回内容包含 `pong`。

## JoyToken 侧检查

#### OpenAI

| 位置    | 应看到                                 |
| ----- | ----------------------------------- |
| Logs  | 请求路径是 `/openai/v1/chat/completions` |
| 认证    | Bearer 认证                           |
| Usage | 本次调用产生 tokens 和 credits             |

#### Anthropic

| 位置    | 应看到                            |
| ----- | ------------------------------ |
| Logs  | 请求路径是 `/anthropic/v1/messages` |
| 认证    | `x-api-key` 认证                 |
| Usage | 本次调用产生 tokens 和 credits        |

## 常见错误

| 错误                      | 处理方式                                                        |
| ----------------------- | ----------------------------------------------------------- |
| 找不到 `custom-api-key` 参数 | 安装 `openclaw@2026.6.11`                                     |
| 默认模型不是 `joytoken/auto`  | 重新执行 `openclaw onboard`                                     |
| `401 Unauthorized`      | 重新设置 `JOY_TOKEN_API_KEY`                                    |
| JoyToken 没有日志           | 检查 `~/.openclaw/openclaw.json` 中所选协议的 `baseUrl`、`api` 和默认模型 |

## 相关资源

* [JoyToken API 指南](/zh/open-api/api-guides/overview)
* [JoyToken 认证](/zh/user-guide/authentication)
* [JoyToken 用量与账单](/zh/user-guide/usage-billing)