這篇適合誰看？

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

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

• 配置向?qū)У降自撛趺催x？
• API Key 填在哪里？
• BaseURL、模型名怎么配？
• 網(wǎng)頁控制臺為什么打不開？
• Gateway Token 又從哪來？

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

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

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

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

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

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

1. 打開 PowerShell
2. 執(zhí)行安裝命令
3. 配置向?qū)Ю镞x擇 QuickStart
4. 配置處理方式優(yōu)先選 Use existing values
5. 模型服務(wù)選擇 OpenAI（或?qū)?yīng)兼容接口）
6. 填入 API Key
7. 模型選擇 openai/gpt-5.4
8. 網(wǎng)頁搜索先 Skip for now
9. 網(wǎng)絡(luò)配置保持默認，尤其是 Loopback (Local only)
10. 打開 http://127.0.0.1:18789
11. 從 openclaw.json 里找到 gateway.auth.token，復(fù)制到網(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í)行后等待安裝完成即可。正常情況下，安裝結(jié)束后會自動進入初始化配置向?qū)А?/p>

四、首次配置向?qū)У降自趺催x？

這是新手最容易猶豫的部分。我把關(guān)鍵選項直接說結(jié)論。

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 可以理解成沿用當(dāng)前空配置，然后繼續(xù)往下填
• Reset 則是從頭初始化

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

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

那就選：

• Update values

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

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

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

• OpenAI

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

這里有個非常關(guān)鍵的點：

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

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

5）模型版本怎么選？

本文示例里使用的是：

openai/gpt-5.4

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

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

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

• Skip for now

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

openclaw configure --section web

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

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

端口（Port）

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

18789

Gateway bind mode

建議首次安裝時保持：

• Loopback (Local only)

它的含義是：

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

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

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

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

http://127.0.0.1:18789

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

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

這個 token 到底從哪來？

六、Gateway Token 在哪里看？

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

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

它在本機配置文件里。

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

~\.openclaw\openclaw.json

也就是本機用戶目錄下的 .openclaw\openclaw.json ，絕對路徑可以通過執(zhí)行 openclaw configure 打開配置向?qū)Р榭矗?/p>

打開這個文件后，找到：

gateway.auth.token

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

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

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

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

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

下面這張圖，可以先幫你快速建立配置結(jié)構(gòu)的直覺：

它的路徑是：

~\.openclaw\openclaw.json

如果你后面需要手動核對這些內(nèi)容：

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

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

建議修改前先備份一份，避免 JSON 格式寫錯導(dǎo)致 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
      }
    }
  }
}

八、這幾個配置字段最關(guān)鍵

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 沒問題，模型也調(diào)不通。

5）models.providers.openai.apiKey

這里填寫你的模型 Key。

最常見的坑有：

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

6）agents.defaults.model.primary

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

示例里常見的是：

"primary": "openai/gpt-5.4"

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

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

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

配置明明改對了，但服務(wù)還在吃舊配置。

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

openclaw gateway restart

這一步非常關(guān)鍵。

如果你改完之后：

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

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

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

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

這張圖你可以直接當(dāng)成排錯清單來用：

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

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

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

~\.openclaw\openclaw.json

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

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

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

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

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

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

默認控制臺地址是：

http://127.0.0.1:18789

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

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

openclaw gateway restart

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

十一、如果中途退出了配置向?qū)г趺崔k？

不需要重新安裝。

直接執(zhí)行：

openclaw configure

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

這一點其實挺友好：

• 安裝斷了，不一定要從頭來
• 多數(shù)情況下重新跑配置向?qū)Ь湍苎a上

十二、常用命令速查

重新進入配置向?qū)?/h3>

openclaw configure

重啟網(wǎng)關(guān)服務(wù)

openclaw gateway restart

停止網(wǎng)關(guān)服務(wù)

openclaw gateway stop

啟動后臺服務(wù)

openclaw service start

停止后臺服務(wù)

openclaw service stop

設(shè)置開機自啟

openclaw service enable

關(guān)閉開機自啟

openclaw service disable

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

openclaw configure --section web

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

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

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

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

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

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

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

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

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

先把它用起來。

十四、openclaw接入微信

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

結(jié)尾

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

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

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

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

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

最新評論