SuperFast AISuperFast AI文档中心
Codex & Claude 编程智能体

OpenClaw 安装与配置

配置 openclaw.json 的 Base URL、API Key、思考强度与多 Agent 协同。

OpenClaw(小龙虾)是新一代开源自主智能体(Autonomous Agent)系统,能够自动进行任务拆解、文件读写、指令执行与多 Agent 协同。本教程提供接入本站 API 的标准手动配置方案。


一、系统与环境要求

  • Node.js:版本必须大于等于 22(推荐安装最新的 Node.js 22+ LTS)
  • 支持系统:macOS、Linux,以及 Windows(需通过 WSL2 环境运行)
  • 包管理器:推荐使用 Node.js 自带的 npm,或使用 pnpm。

二、安装 OpenClaw

参考 OpenClaw 官方指南完成基础脚手架安装:

bash
npm install -g openclaw

安装过程中如果提示配置模型,可以直接跳过或回车,安装完成后直接编辑配置文件即可。


三、配置本站模型

打开用户主目录下的配置文件 ~/.openclaw/openclaw.json(Windows WSL2 下位于 ~/.openclaw/openclaw.json):

在 models 与 agents 节点下按以下模板配置。将 你的密钥sk-xxxx 替换为您在本站后台创建的密钥(需绑定对应模型分组):

json
{
  "models": {
    "providers": {
      "superfast": {
        "baseUrl": "https://api.20020723.xyz/v1",
        "apiKey": "你的密钥sk-xxxx",
        "auth": "api-key",
        "api": "openai-responses",
        "authHeader": true,
        "models": [
          {
            "id": "gpt-5.3-codex",
            "name": "GPT-5.3 Codex",
            "reasoning": true,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 1.75,
              "output": 14,
              "cacheRead": 0.175,
              "cacheWrite": 0.175
            },
            "contextWindow": 400000,
            "maxTokens": 128000
          }
        ],
        "headers": {
          "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) OpenClaw/2026.2.14",
          "Accept": "application/json"
        }
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "superfast/gpt-5.3-codex"
      },
      "models": {
        "superfast/gpt-5.3-codex": {
          "alias": "GPT 5.3 Codex"
        }
      },
      "workspace": "/root/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

四、调整推理思考强度(Thinking Level)

若需要调节智能体的思考深度,可在 agents.defaults 中加入 thinkingDefault 选项(建议设置为 "high"):

json
"agents": {
  "defaults": {
    "workspace": "/root/.openclaw/workspace",
    "compaction": { "mode": "safeguard" },
    "maxConcurrent": 4,
    "subagents": { "maxConcurrent": 8 },
    "thinkingDefault": "high",
    "model": { "primary": "superfast/gpt-5.3-codex" }
  }
}

修改完成后,在终端重启 OpenClaw 主进程或网关即可完全生效:

bash
openclaw gateway restart
最后更新:2026-11-03模型以官方模型广场为准 ↗
ESC