這篇適合誰看？

• 第一次在 Windows 上安裝 OpenClaw 的人
• 已經(jīng)裝上了，但卡在模型接入的人
• 不確定 BaseURL、API Key、模型名、Gateway Token 到底該怎么配的人

很多人第一次裝 OpenClaw，卡住的其實不是安裝命令本身，而是后面這幾步：

• 配置向導到底該怎么選？
• API Key 填在哪里？
• BaseURL、模型名怎么配？
• 網(wǎng)頁控制臺為什么打不開？
• Gateway Token 又從哪來？

我自己前面也實測跑過一遍，發(fā)現(xiàn)真正最容易出錯的，不是在“裝不上”，而是在：

裝完以后，不知道怎么把模型真正接通。

這篇我就按 Windows 首次安裝 的場景，把一套已經(jīng)驗證可用的流程講清楚。目標很簡單：

讓 OpenClaw 從 0 到真正跑起來，并順利接通大模型 API。

一、先說結論：首次安裝最短可用路徑

如果你只是想先把 OpenClaw 跑起來，不想一開始研究太多高級配置，可以直接按下面這條最短路徑走：

1. 打開 PowerShell
2. 執(zhí)行安裝命令
3. 配置向導里選擇 QuickStart
4. 配置處理方式優(yōu)先選 Use existing values
5. 模型服務選擇 OpenAI（或對應兼容接口）
6. 填入 API Key
7. 模型選擇 openai/gpt-5.4
8. 網(wǎng)頁搜索先 Skip for now
9. 網(wǎng)絡配置保持默認，尤其是 Loopback (Local only)
10. 打開 http://127.0.0.1:18789
11. 從 openclaw.json 里找到 gateway.auth.token，復制到網(wǎng)頁登錄框

如果你只是想先跑通第一版可用配置，這條路徑已經(jīng)夠用了。

二、安裝前先準備什么？

建議先準備好這幾樣：

• 一臺 Windows 電腦
• 可正常聯(lián)網(wǎng)的 PowerShell
• 一個可用的大模型 API Key
• 一個瀏覽器（安裝后需要打開本機網(wǎng)頁控制臺）

如果你走的是 OpenAI 兼容接口，還建議提前確認這兩項：

• Base URL
• 模型名

因為后面真正決定能不能接通的，通常就是這兩個配置項和 API Key。

三、安裝 OpenClaw

打開 PowerShell，執(zhí)行下面這條命令：

iwr -useb https://openclaw.ai/install.ps1 | iex

執(zhí)行后等待安裝完成即可。正常情況下，安裝結束后會自動進入初始化配置向導。

四、首次配置向導到底怎么選？

這是新手最容易猶豫的部分。我把關鍵選項直接說結論。

1）安全提示

安裝完成后，一般會先看到一個安全提示。

這里直接選擇 確認 就可以繼續(xù)。

2）安裝模式（Setup mode）

通常會看到兩個選項：

• QuickStart
• Manual

如果你是第一次安裝，優(yōu)先建議選 QuickStart。

原因很簡單：

• QuickStart 更適合首次快速跑通
• Manual 更適合已經(jīng)明確知道自己要改哪些配置的人

如果目標只是先把 OpenClaw 跑起來，不建議一上來就走太細的手動配置路線。

3）配置處理方式（Config handling）

這里一般會看到三個選項：

• Use existing values
• Update values
• Reset

這幾個名字第一次看會有點繞，直接記住這條就行：

如果你是首次安裝

優(yōu)先選：

• Use existing values
• 或者 Reset

都可以。

原因是：第一次安裝時，本地通常沒有真正可用的歷史配置。

所以：

• Use existing values 可以理解成沿用當前空配置，然后繼續(xù)往下填
• Reset 則是從頭初始化

如果機器上沒有歷史配置，通常選 Use existing values 就夠了。

如果你之前已經(jīng)配過，只是想換 Key 或換模型

那就選：

• Update values

4）選擇模型服務提供商（Model / Auth provider）

這一環(huán)節(jié)需要選擇后續(xù)要接入的大模型服務。

如果你走的是 OpenAI 或 OpenAI 兼容接口，示例里可以直接選：

• OpenAI

接著在后續(xù)提示中填入對應的 API Key。

這里有個非常關鍵的點：

如果你用的是 OpenAI 兼容接口，不只是 API Key 要對，BaseURL 和模型名也必須配對。

很多“明明有 Key 但還是調不通”的問題，最后都是這兩個字段沒配好。

5）模型版本怎么選？

本文示例里使用的是：

openai/gpt-5.4

如果你的服務方要求使用別的模型名，就以你自己的實際模型名為準。

6）網(wǎng)頁搜索功能先怎么處理？

如果你當前只是想先把 OpenClaw 跑起來，網(wǎng)頁搜索可以先跳過：

• Skip for now

后面如果需要單獨配置網(wǎng)頁搜索，再執(zhí)行：

openclaw configure --section web

7）網(wǎng)絡配置怎么選？

這一步通常包括端口和網(wǎng)關綁定模式。

端口（Port）

一般直接保持默認即可，例如：

18789

Gateway bind mode

建議首次安裝時保持：

• Loopback (Local only)

它的含義是：

• 網(wǎng)關只綁定到 127.0.0.1
• 只有當前這臺電腦自己能訪問
• 局域網(wǎng)其他設備和外網(wǎng)都不能直接連接

這是默認且更安全的本地模式，第一次安裝非常適合保留。

五、安裝完成后，怎么打開網(wǎng)頁控制臺？

配置完成后，在瀏覽器中打開：

http://127.0.0.1:18789

如果頁面能正常打開，下一步一般會要求輸入 Gateway Token（網(wǎng)關令牌）。

這也是很多人第一次會卡住的地方：

這個 token 到底從哪來？

六、Gateway Token 在哪里看？

登錄網(wǎng)頁控制臺時，需要輸入的 token 對應配置項是：

"gateway": {
  "auth": {
    "mode": "token",
    "token": "你的網(wǎng)關令牌"
  }
}

它在本機配置文件里。

Windows 下默認配置文件路徑是：

~\.openclaw\openclaw.json

也就是本機用戶目錄下的 .openclaw\openclaw.json ，絕對路徑可以通過執(zhí)行 openclaw configure 打開配置向導查看：

打開這個文件后，找到：

gateway.auth.token

把這段字符串復制到網(wǎng)頁登錄框里，再點擊連接即可。

注意：這個 token 相當于本地控制臺的訪問憑證，不要隨便發(fā)給別人。

七、真正最容易出錯的一步：openclaw.json

說實話，很多用戶真正卡住的地方，不在安裝命令，而在：

看不懂或者改錯了 openclaw.json。

下面這張圖，可以先幫你快速建立配置結構的直覺：

它的路徑是：

~\.openclaw\openclaw.json

如果你后面需要手動核對這些內容：

• 網(wǎng)關端口
• 網(wǎng)關令牌
• 模型提供商
• Base URL
• API Key
• 默認模型

都優(yōu)先看這個文件。

建議修改前先備份一份，避免 JSON 格式寫錯導致 OpenClaw 啟動異常。

先給一個完整用例：

{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "*****"
    },
    "mode": "local",
    "port": 18789,
    "bind": "loopback",
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.4.21",
    "lastTouchedAt": "2026-04-22T12:02:58.688Z"
  },
  "agents": {
    "defaults": {
      "models": {
        "openai/gpt-5.4": {
          "alias": "GPT"
        }
      },
      "model": {
        "primary": "openai/gpt-5.4"
      }
    }
  },
  "auth": {
    "profiles": {
      "openai:default": {
        "provider": "openai",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://****.com/v1",
        "apiKey": "*******",
        "api": "openai-completions",
        "models": []
      }
    }
  },
  "wizard": {
    "lastRunAt": "2026-04-22T12:02:58.474Z",
    "lastRunVersion": "2026.4.21",
    "lastRunCommand": "configure",
    "lastRunMode": "local"
  },
  "tools": {
    "web": {
      "search": {
        "openaiCodex": {}
      },
      "fetch": {
        "enabled": true
      }
    }
  },
  "plugins": {
    "entries": {
      "openai": {
        "enabled": true
      }
    }
  }
}

八、這幾個配置字段最關鍵

1）gateway.auth.token

這個就是網(wǎng)頁登錄控制臺時要輸入的令牌。

2）gateway.port

默認示例一般是：

"port": 18789

如果你改過端口，瀏覽器訪問地址也要跟著改。

3）gateway.bind

如果是：

"bind": "loopback"

就表示只允許本機訪問。首次安裝一般建議保持這個默認值。

4）models.providers.openai.baseUrl

這里填寫你的 OpenAI 兼容接口地址，例如：

"baseUrl": "https://***.com/v1"

如果這里填錯，就算 API Key 沒問題，模型也調不通。

5）models.providers.openai.apiKey

這里填寫你的模型 Key。

最常見的坑有：

• 漏填
• 復制時多了空格
• 填成了錯誤的 Key
• 填的是別的服務商的 Key

6）agents.defaults.model.primary

這里定義默認使用哪個模型。

示例里常見的是：

"primary": "openai/gpt-5.4"

如果模型名和服務端實際支持的不一致，也會直接出問題。

九、改完配置后，別忘了這一步

很多人配完 openclaw.json 以后，還會遇到一個很隱蔽的問題：

配置明明改對了，但服務還在吃舊配置。

所以手動修改完 openclaw.json 后，需要在保存后立刻執(zhí)行：

openclaw gateway restart

這一步非常關鍵。

如果你改完之后：

• 網(wǎng)頁打不開
• 模型調用失敗
• token 校驗異常

優(yōu)先檢查兩件事：

1. 配置是不是改對了
2. 網(wǎng)關是不是已經(jīng)重啟生效了

十、網(wǎng)頁打不開 / 模型調不通時，按這個順序排查

這張圖你可以直接當成排錯清單來用：

如果你網(wǎng)頁控制臺打不開，或者模型就是調不通，建議按這個順序查：

第一步：確認配置文件路徑是不是對的

優(yōu)先確認你改的是不是這個文件：

~\.openclaw\openclaw.json

路徑改錯，是非常常見的問題。

第二步：檢查 BaseURL / API Key / 模型名

這 3 項是最核心的接入?yún)?shù)。

它們里任何一個不對，都會造成：

• 網(wǎng)頁能開
• 工具能啟動
• 但模型就是不返回結果

第三步：檢查 Gateway Token 和網(wǎng)頁地址

默認控制臺地址是：

http://127.0.0.1:18789

如果你改過端口或 token，就要按新值來。

第四步：執(zhí)行網(wǎng)關重啟

openclaw gateway restart

很多時候問題不是“安裝壞了”，而只是配置改了但進程沒刷新。

十一、如果中途退出了配置向導怎么辦？

不需要重新安裝。

直接執(zhí)行：

openclaw configure

然后重新進入配置流程即可。

這一點其實挺友好：

• 安裝斷了，不一定要從頭來
• 多數(shù)情況下重新跑配置向導就能補上

十二、常用命令速查

重新進入配置向導

openclaw configure

重啟網(wǎng)關服務

openclaw gateway restart

停止網(wǎng)關服務

openclaw gateway stop

啟動后臺服務

openclaw service start

停止后臺服務

openclaw service stop

設置開機自啟

openclaw service enable

關閉開機自啟

openclaw service disable

單獨配置網(wǎng)頁搜索

openclaw configure --section web

不使用網(wǎng)頁交互，在終端中打開交互界面

openclaw tui	#默認為交互窗口名為default

不使用網(wǎng)頁交互，在終端中打開多個不同的交互界面

openclaw tui --session work  # work為自定義交互窗口名稱，可以按需修改

十三、我的建議：第一次別追求“全懂”，先追求“可用”

如果你是第一次接觸 OpenClaw，不建議一開始就追求把所有高級功能都研究透。

更穩(wěn)的順序應該是：

1. 先裝上
2. 先把網(wǎng)頁控制臺打開
3. 先讓模型真正調通
4. 再去研究多模型、插件、遠程訪問、自動化能力

因為真正最關鍵的第一步，不是“懂全部功能”，而是：

先把它用起來。

十四、openclaw接入微信

參考：https://www.runoob.com/ai-agent/openclaw-weixin.html

結尾

如果你也在折騰 OpenClaw、Agent 或大模型工具接入，安裝本身通常不是最難的，難的是：

• 配置項理解不清
• BaseURL / API Key / 模型名配錯
• 不知道 token 在哪里看
• 改完配置又忘了重啟網(wǎng)關

把這些關鍵點捋順以后，OpenClaw 的首次可用門檻其實沒有想象中高。

最后， 建議使用如下鏈接提供的token中轉站，價格相對實惠：https://apiqd.com/register?ref=INV-PJPWXJ1Q

以上就是OpenClaw接入大模型API的完整配置流程(Windows實測可用)的詳細內容，更多關于OpenClaw接入大模型API流程的資料請關注腳本之家其它相關文章！

最新評論