小龙虾 OpenClaw 配置教程

1. 准备

先完成 Node.js 安装。OpenClaw 用国内镜像安装更快，以管理员权限打开终端执行：

npm config set registry https://registry.npmmirror.com

TIP

装完 OpenClaw 之后如果还要装 Claude Code / Gemini CLI，记得把 npm 源改回官方源：npm config set registry https://registry.npmjs.org/

2. 安装

npm install -g opencode-ai

npm install -g openclaw-cn@latest

3. 初始化向导

openclaw-cn onboard --install-daemon

按向导一步步走，下面是每一步的截图：

向导结束后本地浏览器会自动弹出网页，首次启动会慢一点，等界面加载完成。如果没有弹出或访问不成功，运行下面这条命令后刷新网页：

openclaw-cn gateway

4. 修改配置文件

打开配置文件：

Windows

按 Win + R，输入 %userprofile%\.openclaw\openclaw.json 回车

macOS / Linux

~/.openclaw/openclaw.json

把内容替换成下面这份，apiKey、workspace、token 三处改成你自己的：

{
  "meta": {
    "lastTouchedVersion": "0.1.7",
    "lastTouchedAt": "2026-03-16T16:00:00.000Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-04T16:42:05.287Z",
    "lastRunVersion": "0.1.7",
    "lastRunCommand": "doctor",
    "lastRunMode": "local"
  },
  "models": {
    "providers": {
      "gmn": {
        "baseUrl": "https://api.solov.cc/v1",
        "apiKey": "换成你在星芒AI创建的API密钥",
        "auth": "api-key",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4",
            "reasoning": true,
            "input": ["text", "image"],
            "cost": {
              "input": 1.75,
              "output": 14,
              "cacheRead": 0.175,
              "cacheWrite": 0.175
            },
            "contextWindow": 400000,
            "maxTokens": 128000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "gmn/gpt-5.4"
      },
      "workspace": "换成你的工作目录",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 1,
      "subagents": {
        "maxConcurrent": 1
      }
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "换成向导里生成的 token"
    }
  }
}

注意 baseUrl 带 /v1

OpenClaw 这里的接口地址是 https://api.solov.cc/v1，和 Codex / Claude Code 不带 /v1 的写法不一样。模型名以 可用渠道 页面为准。

5. 重启

openclaw-cn gateway

常用命令：

openclaw-cn dashboard --no-open   # 打印网页地址但不自动打开
openclaw-cn gateway restart       # 重启
openclaw-cn gateway stop          # 停止

调不通时对照 错误码对照，或把完整报错文案发给客服。