OpenClaw 中轉(zhuǎn)站配置詳細(xì)教程

發(fā)布時(shí)間：2026-03-02 11:50:29 作者：秒懂AI+

本文介紹了如何在Windows、macOS和Linux系統(tǒng)上配置OpenClaw使用自定義API中轉(zhuǎn)站,通過(guò)安裝OpenClaw、初始化配置文件、編輯主配置文件和鑒權(quán)文件,以及啟動(dòng)Gateway和TUI,本文提供常見(jiàn)問(wèn)題的解決方法和配置要點(diǎn)總結(jié),幫助用戶順利完成配置，感興趣的朋友跟隨小編一起看看吧

OpenClaw 中轉(zhuǎn)站配置教程

前言

本教程教你如何配置 OpenClaw 使用自定義 API 中轉(zhuǎn)站。

適用系統(tǒng)： Windows / macOS / Linux
預(yù)計(jì)時(shí)間： 10 分鐘

第一步：安裝與初始化

1. 安裝 OpenClaw

npm install -g openclaw

注意：Windows 用戶如果提示 openclaw 不是命令，可以使用 clawdbot 代替。

2. 執(zhí)行初始化

openclaw onboard

按提示完成基礎(chǔ)設(shè)置。

第二步：修改主配置文件

?? 重要提示

OpenClaw 不支持通過(guò)環(huán)境變量 ANTHROPIC_BASE_URL 來(lái)設(shè)置自定義 API 端點(diǎn)。必須通過(guò)配置文件的 models.providers 來(lái)配置。

配置文件位置

系統(tǒng)	配置文件路徑
Windows	`C:\Users\你的用戶名\.clawdbot\clawdbot.json`
macOS	`~/.clawdbot/clawdbot.json` 或 `~/openclaw/clawdbot.json`
Linux	`~/.clawdbot/clawdbot.json` 或 `~/openclaw/clawdbot.json`

注意： 配置文件可能在 .clawdbot 或 openclaw 目錄，取決于你的安裝方式。

步驟 1：備份配置文件（可選）

macOS/Linux:

# 如果在 .clawdbot 目錄
cp ~/.clawdbot/clawdbot.json ~/.clawdbot/clawdbot.json.bak
# 或者在 openclaw 目錄
cp ~/openclaw/clawdbot.json ~/openclaw/clawdbot.json.bak

Windows:

copy %USERPROFILE%\.clawdbot\clawdbot.json %USERPROFILE%\.clawdbot\clawdbot.json.bak

步驟 2：編輯配置文件

macOS/Linux:

# 如果在 .clawdbot 目錄
nano ~/.clawdbot/clawdbot.json
# 或者在 openclaw 目錄
nano ~/openclaw/clawdbot.json

Windows:

notepad %USERPROFILE%\.clawdbot\clawdbot.json

步驟 3：復(fù)制以下配置內(nèi)容

{
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://apipro.maynor1024.live/v1",
        "api": "openai-completions",
        "apiKey": "sk-你的API密鑰",
        "models": [
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://apipro.maynor1024.live",
        "api": "anthropic-messages",
        "apiKey": "sk-你的API密鑰",
        "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://apipro.maynor1024.live/v1beta",
        "api": "google-generative-ai",
        "apiKey": "sk-你的API密鑰",
        "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
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      },
      "models": {
        "api-proxy-gpt/gpt-4o": {
          "alias": "GPT-4o"
        },
        "api-proxy-claude/claude-sonnet-4-5-20250929": {
          "alias": "Claude Sonnet 4.5"
        },
        "api-proxy-google/gemini-3-pro-preview": {
          "alias": "Gemini 3 Pro"
        }
      }
    }
  },
  "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"
      }
    }
  }
}

關(guān)鍵配置說(shuō)明

字段	說(shuō)明	必需
`baseUrl`	自定義 API 端點(diǎn)地址	?
`apiKey`	你的 API 密鑰（直接寫在這里）	?
`api`	API 類型	?
`models`	模型列表配置	?

?? 重要：將所有 sk-你的API密鑰 替換為你的真實(shí) API Key！

第三步：配置鑒權(quán)文件

配置文件位置

系統(tǒng)	鑒權(quán)文件路徑
Windows	`C:\Users\你的用戶名\.clawdbot\agents\main\agent\auth-profiles.json`
macOS	`~/.clawdbot/agents/main/agent/auth-profiles.json` 或 `~/openclaw/agents/main/agent/auth-profiles.json`
Linux	`~/.clawdbot/agents/main/agent/auth-profiles.json` 或 `~/openclaw/agents/main/agent/auth-profiles.json`

編輯鑒權(quán)文件

macOS/Linux:

# 如果在 .clawdbot 目錄
nano ~/.clawdbot/agents/main/agent/auth-profiles.json
# 或者在 openclaw 目錄
nano ~/openclaw/agents/main/agent/auth-profiles.json

Windows:

notepad %USERPROFILE%\.clawdbot\agents\main\agent\auth-profiles.json

復(fù)制以下內(nèi)容

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-你的API密鑰"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-你的API密鑰"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-你的API密鑰"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

?? 重要：將所有 sk-你的API密鑰 替換為你的真實(shí) API Key！

第四步：檢查并啟動(dòng)

1. 運(yùn)行健康檢查（可選）

openclaw doctor

2. 啟動(dòng) Gateway 服務(wù)

openclaw gateway

預(yù)期輸出：

?? OpenClaw Gateway starting...
?? WebSocket server listening on ws://127.0.0.1:18789
?? Web interface available at http://127.0.0.1:18789
? Gateway ready!

保持這個(gè)窗口打開(kāi)！

3. 啟動(dòng) TUI（新窗口）

打開(kāi)新的終端窗口，運(yùn)行：

openclaw tui

4. 測(cè)試對(duì)話

在 TUI 中輸入：

你好

如果 AI 正常回復(fù)，配置成功！??

5. 訪問(wèn) Web 控制臺(tái)（可選）

打開(kāi)瀏覽器訪問(wèn)：http://127.0.0.1:18789/

使用 openclaw onboard 結(jié)尾輸出的 Token 登錄。

常用命令

命令	說(shuō)明
`/models`	查看所有可用模型
`/model api-proxy-gpt/gpt-4o`	切換到 GPT-4o
`/model api-proxy-claude/claude-sonnet-4-5-20250929`	切換到 Claude Sonnet 4.5
`/model api-proxy-google/gemini-3-pro-preview`	切換到 Gemini 3 Pro
`/model status`	查看當(dāng)前模型狀態(tài)
`/clear`	清空對(duì)話歷史
`/save`	保存當(dāng)前會(huì)話
`/quit`	退出 TUI

常見(jiàn)問(wèn)題

問(wèn)題 1: (no output) - 沒(méi)有響應(yīng)

原因： API Key 未配置或配置錯(cuò)誤

解決步驟：

檢查 clawdbot.json 中的 apiKey 字段
檢查 auth-profiles.json 中的 key 字段
確認(rèn)兩個(gè)文件中的 API Key 一致
確認(rèn)沒(méi)有拼寫錯(cuò)誤和多余空格
重啟 Gateway 和 TUI

問(wèn)題 2: fetch failed - 請(qǐng)求失敗

原因： 網(wǎng)絡(luò)連接問(wèn)題或 API 地址錯(cuò)誤

解決步驟：

檢查 baseUrl 是否正確：
- GPT: https://apipro.maynor1024.live/v1
- Claude: https://apipro.maynor1024.live
- Gemini: https://apipro.maynor1024.live/v1beta
測(cè)試網(wǎng)絡(luò)連接：

curl -I https://apipro.maynor1024.live

查看 Gateway 日志查找錯(cuò)誤

問(wèn)題 3: 端口被占用

錯(cuò)誤信息： Port 18789 already in use

Windows 解決：

netstat -ano | findstr :18789
taskkill /PID <PID> /F

macOS/Linux 解決：

lsof -i :18789
kill -9 <PID>

問(wèn)題 4: 找不到配置文件

解決： 確保已經(jīng)運(yùn)行過(guò) openclaw onboard 初始化

如果配置目錄不存在，手動(dòng)創(chuàng)建：

Windows:

mkdir %USERPROFILE%\.clawdbot\agents\main\agent

macOS/Linux:

mkdir -p ~/.clawdbot/agents/main/agent
# 或者
mkdir -p ~/openclaw/agents/main/agent

配置文件完整路徑速查

Windows

主配置文件：
C:\Users\你的用戶名\.clawdbot\clawdbot.json
鑒權(quán)文件：
C:\Users\你的用戶名\.clawdbot\agents\main\agent\auth-profiles.json

macOS/Linux

主配置文件：
~/.clawdbot/clawdbot.json
或
~/openclaw/clawdbot.json
鑒權(quán)文件：
~/.clawdbot/agents/main/agent/auth-profiles.json
或
~/openclaw/agents/main/agent/auth-profiles.json

提示： 使用以下命令查找配置文件位置：

macOS/Linux:

find ~ -name "clawdbot.json" 2>/dev/null

Windows (PowerShell):

Get-ChildItem -Path $env:USERPROFILE -Filter "clawdbot.json" -Recurse -ErrorAction SilentlyContinue

配置要點(diǎn)總結(jié)

? API Key 需要配置在兩個(gè)地方：
- config.json 的 models.providers[].apiKey
- auth-profiles.json 的 profiles[].key
? 兩個(gè)文件中的 API Key 必須一致
? baseUrl 必須正確：
- GPT 需要 /v1 后綴
- Claude 不需要后綴
- Gemini 需要 /v1beta 后綴
? 不支持環(huán)境變量配置
? 配置完成后需要重啟 Gateway