OpenClaw 配置

官方文档：https://docs.openclaw.ai/zh-CN
OpenClaw 属于典型外接网关场景。分组、Base URL、User-Agent、模型填写的统一规则，建议先看外接兼容与接入说明。

OpenClaw Gateway 是 AI 代理网关，支持通过飞书、Telegram、Discord 等渠道接入 AI 模型。启动后默认 Web UI 地址：http://127.0.0.1:18789/

步骤一：安装

bash

npm install -g openclaw@latest

步骤二：初始化引导

bash

openclaw onboard --install-daemon

选择快速开始（QuickStart，确认 Yes）
跳过供应商选择，选择全模型
保持默认模型，继续下一步（此步骤主要用于生成配置文件）

步骤三：配置通知渠道

从以下渠道中选择一个接入：

渠道	说明
飞书	需安装飞书插件，步骤较多，查看详细配置 →
Telegram	Token 获取最为简便，参考官方文档
Discord	参考官方文档

渠道选择界面

步骤四：配置 Skills

根据需要选择安装 Skills。

Skills 无内置审核机制，来源不明的 Skills 存在安全风险，请仅安装可信来源的内容。

Skills 配置

步骤五：配置 Hooks

建议勾选 session-memory（按空格选中）：

Hooks 配置

步骤六：配置 API 参数

推荐使用 CC Switch 配置，查看 CC Switch 统一配置 →

无论是否通过 CC Switch，只要 OpenClaw 作为外接客户端调用，就要注意以下几点：

同一个 OpenClaw 可以同时接 Claude 和 Codex
也可以接国产模型分组，但外接时同样要带对应 UA
不同 provider 要分别选择对应分组，并分别填写对应 User-Agent
不能把 Claude 的 UA 直接复用到 Codex provider 上
国产模型 provider 不建议省略浏览器型 UA

如果你是第一次接 OpenClaw，建议先按这个顺序排：

先在 CC Switch 统一配置中确认 Key 与分组
再看外接兼容与接入说明确认 Base URL、协议和模型
最后回到本页填写 OpenClaw provider 细节

如果配置的是 Claude provider：

Base URL：https://www.micuapi.ai
API 协议：Anthropic Messages
令牌分组：选择 Claude 外接可用分组
必须添加 Claude 对应 Headers：

json

"headers": {
  "Authorization": "Bearer sk-xxx",
  "User-Agent": "claude-cli/2.0.76 (external, cli)"
}

如果配置的是 Codex provider：

Base URL：https://www.micuapi.ai/v1
API 协议：OpenAI Responses
令牌分组：选择 Codex 对应分组 vip_2
必须添加 Codex 对应 Headers：

json

"headers": {
  "Authorization": "Bearer sk-xxx",
  "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"
}

如果配置的是 国产模型 provider：

令牌分组：选择国产模型混合分组 vip_4、自部署分组 vip_4_aidc，或与目标模型对应的 *_official 分组
模型 ID：从模型广场复制对应模型 ID
Headers：使用浏览器型 User-Agent

json

"headers": {
  "Authorization": "Bearer sk-xxx",
  "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:149.0) Gecko/20100101 Firefox/149.0"
}

无论是 Claude provider、Codex provider 还是国产模型 provider，缺少各自对应 UA 时，都可能报 403 block 或 403 Forbidden。配置模型时，从模型广场复制模型 ID 填入即可。

外接场景的分组和 UA 规则，完整说明见外接调用 User-Agent 说明。
如果你还要接 JetBrains、Trae 等其他外接客户端，可统一从外接兼容与接入说明进入，再按客户端页面分别落地。

完整配置 JSON 参考

展开查看

json

{
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "model": {
        "primary": "micu-codex/gpt-5.6-sol"
      },
      "subagents": {
        "maxConcurrent": 8
      },
      "workspace": "C:\\Users\\<USERNAME>\\.openclaw\\workspace"
    },
    "list": [
      {
        "agentDir": "C:\\Users\\<USERNAME>\\.openclaw\\agents\\main\\agent",
        "id": "main",
        "name": "main",
        "workspace": "C:\\Users\\<USERNAME>\\.openclaw\\workspace"
      }
    ]
  },
  "channels": {
    "feishu": {
      "appId": "<YOUR_FEISHU_APP_ID>",
      "appSecret": "<YOUR_FEISHU_APP_SECRET>",
      "domain": "feishu",
      "enabled": true,
      "groupPolicy": "disabled"
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "ownerDisplay": "raw",
    "restart": true
  },
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "<YOUR_GATEWAY_TOKEN>"
    },
    "bind": "loopback",
    "mode": "local",
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    },
    "port": 18789,
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "session-memory": {
          "enabled": true
        }
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "micu-claude": {
        "api": "anthropic-messages",
        "apiKey": "sk-xxx",
        "baseUrl": "https://www.micuapi.ai",
        "headers": {
          "Authorization": "Bearer sk-xxx",
          "User-Agent": "claude-cli/2.0.76 (external, cli)"
        },
        "models": [
          {
            "contextWindow": 200000,
            "cost": { "cacheRead": 0, "cacheWrite": 0, "input": 0, "output": 0 },
            "id": "claude-opus-4-5-20251101",
            "maxTokens": 32000,
            "name": "claude-opus-4-5"
          },
          { "id": "claude-haiku-4-5-20251001", "name": "claude-haiku-4-5" },
          { "id": "claude-opus-4-6", "name": "claude-opus-4-6" },
          { "id": "claude-sonnet-4-5-20250929", "name": "claude-sonnet-4-5" },
          { "id": "claude-sonnet-4-6", "name": "claude-sonnet-4-6" }
        ]
      },
      "micu-codex": {
        "api": "openai-responses",
        "apiKey": "sk-xxx",
        "baseUrl": "https://www.micuapi.ai/v1",
        "headers": {
          "Authorization": "Bearer sk-xxx",
          "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"
        },
        "models": [
          {
            "contextWindow": 200000,
            "cost": { "cacheRead": 0, "cacheWrite": 0, "input": 0, "output": 0 },
            "id": "gpt-5.4",
            "maxTokens": 32000,
            "name": "gpt-5.4"
          },
          { "id": "gpt-5.6-sol", "name": "gpt-5.6-sol" },
          { "id": "gpt-5.6-terra", "name": "gpt-5.6-terra" },
          { "id": "gpt-5.6-luna", "name": "gpt-5.6-luna" },
          { "id": "gpt-5.5", "name": "gpt-5.5" },
          { "id": "gpt-5.4-mini", "name": "gpt-5.4-mini" },
          { "id": "gpt-5.3-codex-spark", "name": "gpt-5.3-codex-spark" }
        ]
      }
    }
  },
  "plugins": {
    "entries": {
      "feishu": { "enabled": true }
    }
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "tools": {
    "profile": "coding"
  }
}

OpenClaw 配置 ​

步骤一：安装 ​

步骤二：初始化引导 ​

步骤三：配置通知渠道 ​

步骤四：配置 Skills ​

步骤五：配置 Hooks ​

步骤六：配置 API 参数 ​

完整配置 JSON 参考 ​

OpenClaw 配置

步骤一：安装

步骤二：初始化引导

步骤三：配置通知渠道

步骤四：配置 Skills

步骤五：配置 Hooks

步骤六：配置 API 参数

完整配置 JSON 参考