OpenClaw 一键配置安装教程

一条命令安装 OpenClaw，并同时接入AI驿站 的 Claude 和 GPT。默认模型 claude-opus-5-5，备用 gpt-6.1-sol，推理强度中档（medium）。

1. 运行一键配置命令

macOS / Linux

curl -fsSL https://docs.aizhan.space/sh/openclaw.sh | bash

Windows PowerShell

irm https://sh.api.aizhan.space/openclaw.ps1 | iex

菜单：1 安装 OpenClaw、2 配置AI驿站 (Claude + GPT)、3 一键全部安装（第一次用选这个）。

2. 前置：Node.js 24.16+

OpenClaw 要求 Node.js 24.16 以上（24.x）或 26.1 以上，Node 22 装不上。脚本会先检查版本，不满足时会提示升级方法（官网选 24 LTS，或 brew install node@24）。安装命令为 npm i -g openclaw@latest，失败时自动切换国内镜像。

关于两把 Key

Claude 和 GPT 在官网是不同的令牌分组。脚本会先让你选择要配置的模型家族（1 Claude + GPT（回车默认）/ 2 仅 Claude / 3 仅 GPT），然后依次输入：

1. Claude 分组 API Key
2. GPT 分组 API Key（直接回车 = 与 Claude Key 相同）

每把 Key 都会先用 /v1/models 验证，并拉取这个分组下可用的模型列表一起写进配置。

报错 "Requests from the ... framework are not supported"

说明你的 Claude Key 所在令牌分组只允许 Claude 官方客户端使用。请到 api.aizhan.space 在允许第三方工具的分组下新建令牌，然后重新运行脚本选「2) 配置」。

3. 脚本会写哪些文件

只写一个文件：~/.openclaw/openclaw.json（Windows 为 %USERPROFILE%\.openclaw\openclaw.json）。脚本通过 OpenClaw 官方命令 openclaw config patch 写入，会经过 OpenClaw 自己的格式校验。

{
  models: {
    mode: "merge",
    providers: {
      "aizhan-claude": {
        baseUrl: "https://api.aizhan.space",      // Anthropic 格式，不带 /v1
        api: "anthropic-messages",
        apiKey: "sk-你的Claude Key",
        models: [{ id: "claude-opus-5-5", contextWindow: 1000000, maxTokens: 128000 /* ... */ }]
      },
      "aizhan-gpt": {
        baseUrl: "https://api.aizhan.space/v1",   // OpenAI 格式，带 /v1
        api: "openai-responses",
        apiKey: "sk-你的GPT Key",
        models: [{ id: "gpt-6.1-sol", contextWindow: 1050000, maxTokens: 128000 /* ... */ }]
      }
    }
  },
  agents: {
    defaults: {
      model: { primary: "aizhan-claude/claude-opus-5-5", fallbacks: ["aizhan-gpt/gpt-6.1-sol"] },
      thinkingDefault: "medium",
      models: { "aizhan-claude/claude-opus-5-5": { alias: "Claude Opus 5.5" }, "aizhan-gpt/gpt-6.1-sol": { alias: "GPT-6.1 Sol" } /* ... */ }
    }
  }
}

• 你原有的其他供应商、网关（gateway）设置都会保留；改动前备份为 openclaw.json.bak.时间戳。
• 注意：OpenClaw 重写文件时会去掉原文件里的注释（原文件已备份）。

4. 验证与使用

# 用默认模型 (Claude) 测试
openclaw agent --local -m "Reply with exactly: OK"
# 用 GPT 测试
openclaw agent --local --model aizhan-gpt/gpt-6.1-sol -m "Reply with exactly: OK"

• 终端聊天：openclaw chat
• 查看模型：openclaw models list
• 默认改成 GPT：openclaw models set aizhan-gpt/gpt-6.1-sol
• 会话中切换：输入 /model 选择模型，/think 调整推理强度
• 需要网关 / 聊天渠道 / 控制台等完整功能时运行 openclaw onboard --install-daemon，模型与认证步骤选 Skip，以保留AI驿站 配置。网关运行时会自动加载新配置，无需重启。

5. 回滚

把 openclaw.json.bak.时间戳 改回 openclaw.json 即可。