• OPENCLAW_HOME
• OPENCLAW_STATE_DIR
• OPENCLAW_CONFIG_PATH

详细说明见官方环境变量文档：Environment Variables。

🚀 使用 New API 作为模型提供商

OpenClaw 支持通过 models.providers 接入自定义或兼容 OpenAI 接口的模型网关。对于 New API，最常见的做法是把它作为一个自定义 provider 加进配置里，再把默认模型指向 newapi/模型ID。

接入思路

1. 在 models.providers 下声明一个 newapi provider
2. 将 baseUrl 指向你的 New API 地址，并确保包含 /v1
3. 将 api 设为 openai-completions
4. 在 models 中列出你希望 OpenClaw 使用的模型 ID
5. 在 agents.defaults.model.primary 中把默认模型切到 newapi/...

推荐做法：用环境变量保存密钥

先在当前 shell、服务环境，或 OpenClaw 可读取的 .env 中提供你的 New API 密钥：

export NEWAPI_API_KEY="sk-your-newapi-key"

然后在 openclaw.json 里补充或修改以下片段：

{
  models: {
    mode: "merge",
    providers: {
      newapi: {
        baseUrl: "https://chatbot.unreachablecity.club/v1",
        apiKey: "${NEWAPI_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "kimi-k2.5", name: "Kimi K2.5" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "newapi/gemini-2.5-flash",
        fallbacks: ["newapi/kimi-k2.5"],
      },
      models: {
        "newapi/gemini-2.5-flash": { alias: "flash" },
        "newapi/kimi-k2.5": { alias: "kimi" },
      },
    },
  },
}

这不是一份必须原样照抄的完整配置，而是接入 New API 最关键的部分。只要 provider、模型 ID 和默认模型引用对应正确，OpenClaw 就能通过 New API 调用你暴露出来的模型资源。

关键配置说明

验证是否接入成功

完成配置后，回到 Control UI 或重新打开：

openclaw dashboard

如果你能在 OpenClaw 中正常发起对话，并且默认模型已经变成 newapi/...，说明接入成功。你也可以使用：

openclaw models list

确认 newapi/ 前缀的模型已经出现在可选列表中。

常见问题

• baseUrl 没带 /v1：这是最常见的接入错误之一。
• 模型 ID 填错：primary 和 fallbacks 必须与 models.providers.newapi.models 里的 id 对应。
• 密钥只在当前终端生效：如果 Gateway 以后台服务运行，请确保服务进程也能读取 NEWAPI_API_KEY。
• 想前台排障：可使用官方前台运行方式 openclaw gateway --port 18789 观察日志与报错。