折腾了两天,最后 5 分钟搞定

上周我想用 OpenClaw 搭一个能自动重构代码的 Agent。选定 Claude 4.6 当大脑——毕竟它在 Tool Use 精准度和长上下文推理上确实是第一梯队。

结果卡在了第一步:Anthropic 官方账号注册要海外手机号,好不容易注册上了,API 调了几轮就被限流。

后来换了个思路:用 88API 做中转,不用注册 Anthropic 账号,一个 Key 就能调 Claude。5 分钟配完,跑了一周没掉过链子。这篇教程把我踩过的坑都填好了,你跟着做就行。

为什么选 Claude 4.6 当 OpenClaw 的大脑?

OpenClaw 的核心能力是"执行"——读写文件、跑 Shell 命令、调用外部工具。这要求背后的模型足够确定,不能瞎编参数。

Claude 4.6 在三个方面表现突出:

  1. Tool Use 精准:生成的 JSON 参数几乎零报错,OpenClaw 拿到就能直接执行
  2. 长任务不掉线:200K 上下文窗口内,逻辑一致性保持得很好,适合复杂重构任务
  3. 懂系统设计:不只是补全代码,能理解架构意图,和 OpenClaw 的文件操作能力配合紧密

整体方案

直接用 88API做 API 中转,省掉注册 Anthropic 账号和处理海外支付的麻烦。

核心好处:

  • 国内直连:不需要翻墙,不需要海外账号
  • 协议兼容:Claude 原生协议完整映射,OpenClaw 无感接入
  • 一个 Key 多模型:同一个平台还能调 GPT、Gemini、DeepSeek,方便切换对比

下面开始配置。

第一步:安装 OpenClaw

确保你已经装好 Node.js,然后在终端跑这两条命令。

全局安装:

npm install -g openclaw@latest

执行引导初始化:

openclaw onboard

⚠️ 做完后终端会输出版本号和初始化成功的提示。如果报 command not found,检查 Node.js 是否正确安装,以及 npm 全局路径是否在 PATH 里。

这步做完,OpenClaw 的骨架就搭好了。接下来配模型。

第二步:修改主配置文件 openclaw.json

找到配置文件:

  • WindowsC:\\Users\\你的用户名\\.openclaw\\openclaw.json
  • Mac / Linux~/.openclaw/openclaw.json

modelsauth 部分替换为以下内容:

⚠️ "primary" 字段决定默认模型。如果你想默认用 GPT-5.2,改成 "primary": "api-proxy-gpt/gpt-5.2";Mac 用户记得把 workspace 路径改成自己的工作目录,比如 "/Users/你的用户名/clawd"

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      },
      "models": {
        "api-proxy-gpt/gpt-5.2": {
          "alias": "GPT-5.2"
        },
        "api-proxy-claude/claude-sonnet-4-5-20250929": {
          "alias": "Claude Sonnet 4.5"
        },
        "api-proxy-google/gemini-3-pro-preview": {
          "alias": "Gemini 3 Pro"
        },
        "api-proxy-deepseek/deepseek-v3.2": {
          "alias": "Deepseek v3.2"
        }
      },
      "workspace": "C:\\\\Users\\\\admin\\\\clawd",
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": {
        "provider": "api-proxy-gpt",
        "mode": "api_key"
      },
      "api-proxy-claude:default": {
        "provider": "api-proxy-claude",
        "mode": "api_key"
      },
      "api-proxy-google:default": {
        "provider": "api-proxy-google",
        "mode": "api_key"
      },
      "api-proxy-deepseek:default": {
        "provider": "api-proxy-deepseek",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "<https://api.88api.shop/v1>",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "GPT-5.2",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "<https://api.88api.shop>",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude Sonnet 4.5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "<https://api.88api.shop/v1>",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-preview",
            "name": "Gemini 3 Pro",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 2000000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-deepseek": {
        "baseUrl": "<https://api.88api.shop/v1>",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-v3.2",
            "name": "Deepseek v3.2",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 2000000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

到这里最难的部分已经过了。剩下的就是填 Key 和启动。

第三步:配置鉴权文件 auth-profiles.json

找到鉴权文件:

  • WindowsC:\\Users\\你的用户名\\.openclaw\\agents\\main\\agent\\auth-profiles.json
  • Mac / Linux~/.openclaw/agents/main/agent/auth-profiles.json

填入你从 88api.shop 获取的 API Key:

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-your-unique-gpt-key-here"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-your-unique-claude-key-here"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-your-unique-google-key-here"
    },
    "api-proxy-deepseek:default": {
      "type": "api_key",
      "provider": "api-proxy-deepseek",
      "key": "sk-your-unique-deepseek-key-here"
    }
  }
}

⚠️ 如果你只用 Claude,只填 api-proxy-claude:default 这一项就够了,其他的可以先留空。Key 的获取方式:去 88api.shop 注册 → 进控制台 → 点「创建密钥」→ 复制。

第四步:启动并验证

1. 启动 Gateway 服务:

openclaw gateway --port 18789

做完后终端会输出类似 Gateway running on http://127.0.0.1:18789 的信息,说明服务起来了。

2. 打开控制台:

浏览器访问 http://127.0.0.1:18789/,你会看到 OpenClaw 的 Web 界面。

3. 测试连通性:

在对话框里随便问一句,比如"你是谁"。如果 AI 正常回复,说明 Claude 已经通过 88API 接入成功了。

⚠️ 如果报 401 Unauthorized,检查 auth-profiles.json 里的 Key 是否正确。如果报 Connection refused,确认 Gateway 服务是否还在运行。

接下来可以做什么

到这里,你的 OpenClaw 已经接上了 Claude 4.6 的大脑。你可以:

  • 在 OpenClaw 界面里随时切换模型——Claude、GPT、Gemini 都配好了,88API 用同一个 Key 就能切
  • 给 Agent 配置 Skill,让它自动完成特定任务
  • maxConcurrent 调高,跑多 Agent 并发

配置过程中遇到问题,留言贴上你的报错信息,我帮你看看。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐