在 OpenClaw 中使用 OminiGate

概览

OpenClaw 是开源的自托管 AI 助手，可以对接任意 OpenAI 兼容或 Anthropic 兼容的 provider。配置文件位于 ~/.openclaw/openclaw.json，同一个安装可以挂载多个 provider。

OminiGate 同时暴露 /v1/chat/completions（OpenAI）和 /v1/messages（Anthropic）两种端点。你可以挑任意一种注册 —— 或同时注册两种，最大化覆盖模型范围。

• 一份 JSON 文件，无需重新编译。
• OminiGate 与你原有的 provider 共存，OpenClaw 会把它们合并到同一个模型选择器里。
• 给每个模型定义一次 name、modality、上下文窗口等元数据，OpenClaw 的 UI 会自动识别。

前置条件

安装 OpenClaw 并获取 OminiGate API Key。

npm install -g openclaw@latest

配置 provider

把 OminiGate 注册到 models.providers 下。根据目标模型选择协议 —— 走 OpenAI 覆盖面更广，走 Anthropic 可以启用 prompt caching 等 Claude 专属特性。mode: "merge" 会保留 OpenClaw 内建 provider，和 OminiGate 并存。

{
  "agents": {
    "defaults": {
      "model": { "primary": "ominigate/openai/gpt-5.4-pro" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ominigate": {
        "baseUrl": "https://api.ominigate.ai/v1",
        "api": "openai-completions",
        "apiKey": "${OMINIGATE_API_KEY}",
        "models": [
          { "id": "openai/gpt-5.4-pro", "name": "GPT-5.4 Pro" },
          { "id": "anthropic/claude-opus-4.6", "name": "Claude Opus 4.6" },
          { "id": "google/gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro (preview)" }
        ]
      }
    }
  }
}

配置路径： ~/.openclaw/openclaw.json

导出 API Key

OpenClaw 启动时从环境变量读取 OMINIGATE_API_KEY。请把 export 写入 ~/.zshrc 或 ~/.bashrc，新开 shell 也能保留。

export OMINIGATE_API_KEY="sk-omg-your-api-key"

验证、重启、运行

OpenClaw 仅在 gateway 重启时才重新加载 config，因此修改 openclaw.json 之后务必走 验证 → 重启 → 运行 三步。

1. 验证配置

openclaw doctor 会检查 JSON 语法、环境变量解析和 provider 可达性；openclaw models list 确认新注册的 OminiGate slug 已被识别。

openclaw doctor
openclaw models list  # expect to see ominigate/openai/gpt-5.4-pro etc.

2. 重启 Gateway

修改配置后必须重启 gateway 才会生效。跳过这一步，新 provider 和模型不会出现在会话里。

openclaw gateway restart

3. 运行或切换主模型

单次运行用 --model；models set 会持久化修改默认主模型；对话中发 /model 可即时切换。

# One-shot with an explicit model
openclaw run --model ominigate/openai/gpt-5.4-pro "Review the changes in this branch"

# Or change the default primary model persistently
openclaw models set ominigate/anthropic/claude-opus-4.6

# Or swap mid-conversation
/model ominigate/google/gemini-3.1-pro-preview

推荐模型

OminiGate 目录中任意模型都能加入 models 数组。下面四个适合作为起手。

完整模型列表： /models.

常见问题