OpenClaw Windows

安裝總覽（Windows 原生版，不用 WSL）

OpenClaw（龍蝦）安裝與 MYAI168 設定指南 — Windows 原生版（不用 WSL）

本指南目標：在 Windows 上「不使用 WSL」原生安裝 OpenClaw（暱稱「龍蝦」🦞，跑在自己電腦上的開源 AI agent），並用 cc-switch 接上 MYAI168，使用 Claude Opus 4.8。

說明：龍蝦原本以 Linux 為主，Windows 官方另有 WSL2 路線。本指南走「原生 PowerShell + npm」，不需 WSL。原生模式的最大差異是：背景服務（Gateway）用「Windows 排程工作」而非 Linux 的 systemd，需要手動啟動（見「四、初始化與啟動 Gateway」）。

端點與模型

  • Anthropic 原生端點：https://www.myai168.com/stu/api/anthropic（不含 /v1）
  • 主模型：claude-opus-4-8

設定檔位置

%USERPROFILE%\.openclaw\openclaw.json（通常是 C:\Users\你的帳號\.openclaw\）

重要安全須知

  • 龍蝦擁有很廣的系統權限（讀檔、執行指令、發訊息、瀏覽網頁）。強烈建議裝在測試機或隔離環境，不要裝在存大量敏感資料的主力機。
  • 管理後台（Dashboard／Control UI）預設只綁 127.0.0.1（本機），不要暴露到公開網路。
  • 務必裝最新版（舊版曾有嚴重資安漏洞）。
  • API Key 視同密碼；外流就到 MYAI168 後台撤銷換新。
0.5、安裝 Node.js（若尚未安裝）

龍蝦用 npm 安裝，需要 Node.js（官方需求 22.22.3+、24.15+ 或 25.9+；預設目標為 Node 24，建議直接裝 24）。先在 PowerShell 確認：

node --version
npm --version

有版本號就跳到「一、安裝龍蝦」；若出現「command not recognized」：

  • 方法 A（推薦）：到 https://nodejs.org 下載 LTS 的 Windows 安裝檔（.msi），點兩下一路 Next 裝完，「關掉並重開 PowerShell」再確認 node --version。
  • 方法 B（備用）：winget install OpenJS.NodeJS.LTS，裝完重開 PowerShell。
一、安裝龍蝦

若被 PowerShell 執行原則擋住，先放行（只影響目前使用者）：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

用 npm 安裝：

npm install -g openclaw@latest

（安裝時可能出現 npm warn allow-scripts、新版 npm 可用等提示，無害，忽略。）

確認：

openclaw --version

顯示版本號（例如 OpenClaw 2026.6.11）即安裝成功。

二、用 cc-switch 設定 MYAI168

（前提：已安裝 cc-switch —— 安裝方式見開發者中心的「cc-switch Windows」分頁。）

  • 開 cc-switch，點上方「OpenClaw」分頁。
  • 點「+」新增供應商，填：
    • Provider Key：myai168-claude（小寫、連字號）
    • Provider Name：MYAI168 Claude
    • API Protocol：選 Anthropic（不是預設的 OpenAI Completions）
    • API Endpoint：https://www.myai168.com/stu/api/anthropic（不含 /v1）
    • API Key：你的 MYAI168 金鑰
    • Models：點「+ Add Model」，Model ID 填 claude-opus-4-8
  • 按「+ Add」新增，並在卡片上 Enable。

確認 cc-switch 有寫進設定檔：

Get-Content $env:USERPROFILE\.openclaw\openclaw.json

應看到 models.providers 底下有 myai168-claude、claude-opus-4-8、baseUrl、api: anthropic-messages。

三、補上 gateway.mode（cc-switch 不會寫，關鍵）

cc-switch 只寫「模型供應商」，不會寫 Gateway 設定。而龍蝦的 Gateway 沒有 gateway.mode 就「無法啟動」（log 會出現：Gateway start blocked: existing config is missing gateway.mode）。

所以務必手動補一行：

openclaw config set gateway.mode local

（顯示 Updated gateway.mode. Restart the gateway to apply. 即成功。）

四、初始化與啟動 Gateway

跑 doctor 做初始化（會問幾個設定）：

openclaw doctor

建議回答：

  • Generate and configure a gateway token now? → Yes
  • Create Session store dir? → Yes
  • Tighten permissions? → Yes
  • Update gateway service config to recommended defaults? → Yes
  • Disable unavailable skills? → Yes（環境沒裝的工具，停用較乾淨）
  • Enable shell completion? → Yes

（中間若提示「No command owner configured」，那是給 Telegram／Discord 遠端控制用的，本機使用可忽略。）

Windows 原生重點：Gateway 要手動啟動

原生模式的 Gateway 以「Windows 排程工作」方式受管理，裝好「不會自動在跑」。官方 Windows 流程要求先安裝 Gateway service（建立受管理的排程工作）再啟動：

openclaw gateway install
openclaw gateway start
openclaw gateway status

status 要看到以下內容才代表 Gateway 正常：

Runtime: running
Connectivity probe: ok
Listening: 127.0.0.1:18789

若顯示 ECONNREFUSED／stopped／unreachable，見「六、常見問題速查」。

五、啟動與驗證
openclaw

首次會先進內建的「OpenClaw 設定助理」（setup agent，舊名 Crestodian）。直接打一句話，它會把你帶到正常對話介面（main agent）；底部狀態列應顯示 myai168-claude/claude-opus-4-8。

在 main agent 問一個運算題：

123456 乘以 789 等於多少？只回數字

答對 97406784、狀態列顯示 myai168-claude/claude-opus-4-8、token 有增加，即代表接通成功。（別用「你是誰」驗證，模型自我認知不可靠；實際用量以 MYAI168 後台呼叫紀錄為準。）

也可開後台（瀏覽器）：http://127.0.0.1:18789/

六、常見問題速查
  • Gateway unreachable／ECONNREFUSED 127.0.0.1:18789 → Gateway 沒在跑。先確認「三、補上 gateway.mode」有補，再跑 openclaw gateway install、openclaw gateway start、openclaw gateway status。
  • Gateway 一啟動就 stopped（Service is loaded but not running）且 log 出現「missing gateway.mode」→ 就是缺 gateway.mode。執行 openclaw config set gateway.mode local，再 openclaw gateway start。
  • openclaw 指令找不到 → 開新的 PowerShell 讓 PATH 生效；並確認 %USERPROFILE%\AppData\Roaming\npm 在 PATH 中。
  • 指令碼被執行原則擋住 → Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
  • config set 也被擋（missing gateway.mode／clobbered）→ 加參數：openclaw config set gateway.mode local --allow-unconfigured，或重跑 openclaw onboard --mode local。
  • 看 Gateway 為何退出 → Get-Content "$env:LOCALAPPDATA\Temp\openclaw\openclaw-*.log" -Tail 40
七、維護與安全

更新：npm update -g openclaw（或 openclaw update）。

安全稽核：

openclaw security audit

更換 API Key：在 cc-switch 的 OpenClaw 卡片更新 API Key 後重新 Enable；或直接改 %USERPROFILE%\.openclaw\openclaw.json 裡的 apiKey，然後 openclaw gateway restart。

Gateway 控制：openclaw gateway start / status / restart

設定檔位置：%USERPROFILE%\.openclaw\openclaw.json；Gateway 記錄：%LOCALAPPDATA%\Temp\openclaw\

官方文件：https://docs.openclaw.ai、https://docs.openclaw.ai/platforms/windows

↑

其他常見問題頁面

API 說明文件

CLI 與 Agent 教學

MYAI168 API 與 MCP