Trang này hiện chỉ có bản tiếng Trung. Điều hướng và menu đã hiển thị bằng tiếng Việt.

配置 OpenClaw

OpenClaw 可以将 InOneAPI 注册为 OpenAI Chat Completions Provider。建议使用环境变量保存 Key，主配置只保留变量引用。

推荐：使用官方向导

运行 openclaw onboard，选择 Custom Provider（部分版本位于 More… 或 Custom setup），填写：

字段值
Provider IDinoneapi
Base URLhttps://api.inoneapi.com/v1
API KeyInOneAPI API Key
CompatibilityOpenAI Chat Completions
Model ID模型详情页中的 YOUR_MODEL_ID

完成向导后选择 inoneapi/YOUR_MODEL_ID。这里使用 Chat Completions，不要误选 Responses 或 Anthropic。已有 Gateway 时执行 openclaw gateway restart，并再次核对默认模型。Windows 推荐在 WSL2 中使用。

可选：手动配置 Provider 与默认模型

创建或打开 ~/.openclaw/openclaw.json：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "inoneapi/YOUR_MODEL_ID"
      }
    }
  },
  "models": {
    "providers": {
      "inoneapi": {
        "baseUrl": "https://api.inoneapi.com/v1",
        "apiKey": "${INONEAPI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  }
}

保存 API Key

创建 ~/.openclaw/.env：

INONEAPI_API_KEY=ioa_sk_...

并限制文件权限：

chmod 600 ~/.openclaw/.env

验证配置

重新启动 OpenClaw，确认当前主模型显示为 inoneapi/YOUR_MODEL_ID。执行一次短任务后，在 InOneAPI 控制台检查请求协议、模型、Trace 和费用。

常见问题

  • 环境变量没有展开：确认 .env 位于 OpenClaw home，而不是项目目录。
  • 请求路径重复 /v1：baseUrl 只保留一个 /v1。
  • 模型不可用：检查项目模型白名单以及 models[].id 是否与模型详情完全一致。
  • 长任务反复失败：查看 Trace 中的上游错误和重试次数，不要在客户端与网关两侧同时配置激进重试。

Agent 能执行的本地操作由 OpenClaw 自身权限控制，InOneAPI 的模型权限不能替代操作系统沙箱和命令审批。

可选：通过 CC Switch 导入

在模型详情页选择本工具和 API Key，点击「打开 CC Switch 并导入」。使用 CC Switch 官方版本，导入链接已包含当前模型 ID，无需重新填写。确认导入后，按本工具的供应商启用与默认模型设置完成接入。若提示不支持该 app，请升级 CC Switch 或按本文手动接入。

导入链接只添加 Provider，不代表已设为默认模型或已成功请求。链接包含 API Key，请勿分享。手动接入与 CC Switch 接入二选一即可。

CC Switch 导入的是供应商和模型列表，仍需在 OpenClaw 中选择默认模型；不要假定导入即自动切换。

官方参考：OpenClaw CLI onboarding。

OpenClaw · Tài liệu · InOneAPI