OpenClaw 配置指南

OpenClaw 是自托管的 AI Agent 框架，支持通过 1xm 接入 Claude、GPT-5 Codex、Gemini 全系列模型，并可选接入 Telegram、飞书、企业微信等渠道。

1. 配置文件位置

OpenClaw 配置文件默认认路径为 ~/.openclaw/openclaw.json，也可通过启动参数 --config 指定路径。

2. 模型 Provider 配置（核心）

将 sk-1xm-xxxxxx 替换为你在控制台获取的真实 API 密钥，三个 Provider 使用同一密钥：

json

{
  "models": "*",
  "providers": {
    "1xm": {
      "baseURL": "https://api.1xm.ai/v1",
      "apiKey": "sk-1xm-xxxxxx",
      "api": "anthropic-messages",
      "headers": {
        "User-Agent": "Mozilla/5.0"
      },
      "models": [
        {
          "id": "claude-opus-4-6",
          "name": "Claude Opus 4.6",
          "reasoning": false,
          "input": ["text", "image"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 200000,
          "maxTokens": 16384
        },
        {
          "id": "claude-sonnet-4-6",
          "name": "Claude Sonnet 4.6",
          "reasoning": false,
          "input": ["text", "image"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    },
    "1xm-openai": {
      "baseURL": "https://api.1xm.ai/v1",
      "apiKey": "sk-1xm-xxxxxx",
      "api": "openai-completions",
      "headers": {
        "User-Agent": "Mozilla/5.0"
      },
      "models": [
        {
          "id": "gpt-5.2-codex",
          "name": "GPT-5.2 Codex",
          "reasoning": false,
          "input": ["text", "image"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 200000,
          "maxTokens": 16384
        }
      ]
    },
    "1xm-google": {
      "baseURL": "https://api.1xm.ai/gemini",
      "apiKey": "sk-1xm-xxxxxx",
      "api": "openai-completions",
      "headers": {
        "User-Agent": "Mozilla/5.0"
      },
      "models": [
        {
          "id": "gemini-3.0",
          "name": "Gemini 3.0",
          "reasoning": false,
          "input": ["text", "image"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 200000,
          "maxTokens": 16384
        }
      ]
    }
  }
}

Provider 说明

1xm — Anthropic 原生

使用 api: "anthropic-messages" 协议，接入 Claude Opus / Sonnet 系列，Base URL 为 https://api.1xm.ai/v1。

1xm-openai — OpenAI 兼容

使用 api: "openai-completions" 协议，接入 GPT-5 Codex 系列，Base URL 同为 https://api.1xm.ai/v1。

1xm-google — Gemini

使用 api: "openai-completions" 协议接入 Gemini 系列，Base URL 为 https://api.1xm.ai/gemini。

3. Agent 模型调度配置

配置主模型与 Fallback 链，当主模型不可用时自动升级：

json

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "1xm/claude-opus-4-6",
        "fallbacks": [
          "1xm/claude-sonnet-4-6",
          "1xm-openai/gpt-5.2-codex",
          "1xm-google/gemini-3.0"
        ]
      },
      "workspace": "/home/ubuntu/.openclaw/workspace",
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    },
    "list": [
      {
        "id": "main",
        "workspace": "/home/ubuntu/.openclaw/workspace",
        "model": {
          "primary": "1xm/claude-opus-4-6",
          "fallbacks": [
            "1xm/claude-sonnet-4-6",
            "1xm-openai/gpt-5.2-codex",
            "1xm-google/gemini-3.0"
          ]
        }
      },
      {
        "id": "dev",
        "workspace": "/home/ubuntu/.openclaw/workspace-dev",
        "model": {
          "primary": "1xm/claude-sonnet-4-6"
        }
      }
    ]
  }
}

4. 获取 API 密钥

在 1xm.ai 控制台 → 「令牌」 → 「创建令牌」 获取你的 API Key。

复制密钥后，替换配置中所有 Provider 的 apiKey 字段（三个 Provider 使用同一密钥即可）。

OpenClaw 配置指南 ​

1. 配置文件位置 ​

2. 模型 Provider 配置（核心） ​

Provider 说明 ​