> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

> 在 OpenClaw 中配置 4096bytes 自定义模型 Provider

OpenClaw 可以通过自定义模型 Provider 接入 4096bytes。你需要写入 OpenAI 兼容 Provider 配置，设置 agent 默认模型，重启 gateway，然后激活新模型。

## 准备工作

* 已完成 [创建账号](/quickstart/create-account)。
* 已完成 [获取 API Key](/quickstart/get-api-key)。
* 已安装 OpenClaw，并确认 `openclaw --version` 可以正常运行。
* 已准备好 4096bytes 的 API Key、Base URL 和模型名。

<Warning>
  下面的命令会把 API Key 写入 OpenClaw 本机配置。不要把包含真实 API Key 的命令、配置文件、截图或终端输出提交到仓库，也不要发到聊天工具里。
</Warning>

## 配置自定义 Provider

在终端中运行下面的命令，把 4096bytes 添加为自定义模型 Provider。

```bash theme={null}
openclaw config set models.providers.4096bytes '{
  "api": "openai-completions",
  "baseUrl": "https://api.4096bytes.com/v1",
  "apiKey": "YOUR_4096BYTES_API_KEY",
  "auth": "api-key",
  "headers": {
    "User-Agent": "Mozilla/5.0"
  },
  "models": [
    {
      "id": "gpt-5.5",
      "name": "GPT-5.5",
      "contextWindow": 200000,
      "reasoning": true,
      "input": [
        "text"
      ]
    }
  ]
}' --strict-json --merge
```

把 `YOUR_4096BYTES_API_KEY` 替换为你在控制台创建的 API Key。`id`、`name`、`contextWindow` 和 `reasoning` 请以控制台当前展示的模型信息为准。

<Tip>
  命令使用了 `--strict-json`。JSON 中不能出现尾逗号，否则 OpenClaw 会拒绝写入配置。
</Tip>

## 设置 agent 默认模型

把 4096bytes 模型设置为 agent 默认模型，并给它设置一个短别名。

```bash theme={null}
openclaw config set agents.defaults.models '{"4096bytes/gpt-5.5": {"alias": "G55"}}' --strict-json --merge
```

如果你使用的模型名不是 `gpt-5.5`，请同步替换 `4096bytes/gpt-5.5`。

## 重启 gateway

配置写入后，重启 OpenClaw gateway。

```bash theme={null}
openclaw gateway restart
```

## 激活新模型

设置当前会话使用 4096bytes 模型。

```bash theme={null}
openclaw models set 4096bytes/gpt-5.5
```

如果你使用其他模型名，请把命令中的 `gpt-5.5` 替换为控制台展示的模型 ID。

## 测试模型调用

发送一条短消息验证接入是否成功。

```bash theme={null}
openclaw chat --message "hi"
```

如果 OpenClaw 可以正常回复，并且没有认证失败或找不到模型的错误，说明配置已生效。

## 常见问题

<AccordionGroup>
  <Accordion title="OpenClaw 提示 JSON 无效">
    检查命令里的 JSON 是否有尾逗号、未转义引号或缺少括号。使用 `--strict-json` 时必须是合法 JSON。
  </Accordion>

  <Accordion title="提示认证失败">
    检查 `apiKey` 是否完整，是否复制了多余空格或换行。确认 API Key 没有被删除、过期或超过额度。
  </Accordion>

  <Accordion title="提示模型不存在">
    确认 `models` 中的 `id` 和 `openclaw models set` 使用的是同一个模型 ID。模型名请从控制台复制，不要使用旧截图或其他用户配置。
  </Accordion>

  <Accordion title="配置后仍然没有生效">
    先执行 `openclaw gateway restart`。如果仍然无效，重新检查 `models.providers.4096bytes` 和 `agents.defaults.models` 是否都写入成功。
  </Accordion>
</AccordionGroup>