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

​
准备工作

  • 已完成 创建账号。
  • 已完成 获取 API Key。
  • 已安装 OpenClaw，并确认 openclaw --version 可以正常运行。
  • 已准备好 4096bytes 的 API Key、Base URL 和模型名。
下面的命令会把 API Key 写入 OpenClaw 本机配置。不要把包含真实 API Key 的命令、配置文件、截图或终端输出提交到仓库，也不要发到聊天工具里。

​
配置自定义 Provider

在终端中运行下面的命令，把 4096bytes 添加为自定义模型 Provider。 
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 请以控制台当前展示的模型信息为准。
命令使用了 --strict-json。JSON 中不能出现尾逗号，否则 OpenClaw 会拒绝写入配置。

​
设置 agent 默认模型

把 4096bytes 模型设置为 agent 默认模型，并给它设置一个短别名。 
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。 
openclaw gateway restart

​
激活新模型

设置当前会话使用 4096bytes 模型。 
openclaw models set 4096bytes/gpt-5.5
如果你使用其他模型名，请把命令中的 gpt-5.5 替换为控制台展示的模型 ID。

​
测试模型调用

发送一条短消息验证接入是否成功。 
openclaw chat --message "hi"
如果 OpenClaw 可以正常回复，并且没有认证失败或找不到模型的错误，说明配置已生效。

​
常见问题

检查命令里的 JSON 是否有尾逗号、未转义引号或缺少括号。使用 --strict-json 时必须是合法 JSON。
检查 apiKey 是否完整，是否复制了多余空格或换行。确认 API Key 没有被删除、过期或超过额度。
确认 models 中的 id 和 openclaw models set 使用的是同一个模型 ID。模型名请从控制台复制，不要使用旧截图或其他用户配置。
先执行 openclaw gateway restart。如果仍然无效，重新检查 models.providers.4096bytes 和 agents.defaults.models 是否都写入成功。