適用版本：OpenClaw 2026.6.8。
本指南目標：在 macOS 從零安裝龍蝦，並接上你「自己的 OpenAI／Anthropic 相容 API 端點」。
請依下方各步驟依序操作；若中途遇到問題，可參考最後的「常見問題速查」。
OpenClaw（暱稱「龍蝦」🦞）是一個跑在你自己電腦上的開源 AI agent。它本身不含模型，需要你自己提供 API Key，模型費用直接付給供應商。
需要 Node.js 24（建議）或 22 LTS（最低 22.19+）。檢查版本：
node --version若沒裝或太舊，用 Homebrew 安裝（Apple Silicon 會自動裝對的 ARM64 版本）：
brew install node官方一鍵腳本（會自動偵測 OS、需要時裝 Node、安裝並啟動引導設定）：
curl -fsSL https://openclaw.ai/install.sh | bash或已有 Node，直接用 npm：
npm i -g openclaw如果安裝時出現：
npm error code EACCES
npm error path /usr/local/lib/node_modules/openclaw
npm error Error: EACCES: permission denied, mkdir ...代表 npm 全域目錄是 root 所有，一般使用者寫不進去。推薦解法（把全域目錄改到家目錄，之後更新也不用 sudo）：
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g openclaw@latest注意：之後若在新終端機視窗遇到 command not found: openclaw，多半是 PATH 還沒生效。重開視窗，或再跑一次 source ~/.zshrc 即可。
驗證安裝：
openclaw --version執行：
openclaw onboard依序會問到這些，照下面選即可：
跑完後補設 Gateway 模式（本機自己用）：
openclaw config set gateway.mode local因為 onboarding 選了 Skip，設定檔可能還沒建立。手動建立並編輯：
mkdir -p ~/.openclaw
touch ~/.openclaw/openclaw.json
open -e ~/.openclaw/openclaw.json貼入以下內容（把「你的-key」換成真正的 API Key，baseUrl／模型 id 改成你供應商的值）：
{
models: {
mode: "merge",
providers: {
myai168: {
baseUrl: "https://www.myai168.com/nhu/api/openai/v1",
apiKey: "你的-key",
api: "openai-completions",
models: [
{
id: "gpt-5.5",
name: "GPT-5.5",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 200000,
maxTokens: 32000
}
]
},
myai168_claude: {
baseUrl: "https://www.myai168.com/nhu/api/anthropic/v1",
apiKey: "你的-key",
api: "anthropic-messages",
models: [
{
id: "claude-opus-4-8",
name: "Claude Opus 4.8",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 200000,
maxTokens: 32000
}
]
}
}
},
agents: {
defaults: {
model: { primary: "myai168_claude/claude-opus-4-8" },
models: {
"myai168_claude/claude-opus-4-8": {},
"myai168/gpt-5.5": {}
}
}
}
}baseURL → OpenClaw 的 baseUrl（小寫 u，大小寫不同）。npm:@ai-sdk/openai → OpenClaw 的 api:"openai-completions"。npm:@ai-sdk/anthropic → OpenClaw 的 api:"anthropic-messages"。providers 定義，也要在 agents.defaults.models 列入 allowlist，否則會報「model not allowed」。api 欄位可用值：openai-completions／openai-responses／anthropic-messages／google-generative-ai。
primary 是預設主模型，想預設用 gpt-5.5 就改成 "myai168/gpt-5.5"。OpenAI 相容端點的 baseUrl 結尾通常要是 /v1。
用 TextEdit 時，它會把直引號自動換成彎引號而導致 JSON 壞掉。預防：選單列「編輯 → 替代 → 智慧型引號」取消打勾；或改用終端機編輯器，例如：
nano ~/.openclaw/openclaw.json（nano 存檔按 Ctrl + O 再 Enter，離開按 Ctrl + X。）
openclaw doctor # 檢查設定有無問題
openclaw models list # 確認模型有被讀到models list 應該要看到你的模型，且 Auth 欄為 yes、預設模型帶 default,configured 標籤。例如：
Model Input Ctx Local Auth Tags
myai168_claude/claude-opus-4-8 text 195k no yes default,configured
myai168/gpt-5.5 text 195k no yes configured（若另外出現 claude-cli/... 那是偵測到本機 Claude CLI 自動帶入的，忽略即可。）
開後台試聊：
openclaw dashboard # 瀏覽器開 http://127.0.0.1:18789/或直接在終端機快速測：
openclaw chat "你好，測試一下"能正常回話，代表整套裝好、也接上你的自定義 API 了。
npm ... EACCES → 全域目錄權限問題，見「二、解決 npm 權限錯誤」，改 prefix 到 ~/.npm-global。command not found: openclaw → PATH 未生效，source ~/.zshrc 或重開終端機。open -e ...openclaw.json 說檔案不存在 → 還沒建立，先 touch ~/.openclaw/openclaw.json。agents.defaults.model.primary。更新（取得新功能與安全修補）：
openclaw update
或
npm update -g openclaw定期跑安全稽核：
openclaw security audit --deep
openclaw security audit --fix設定檔位置：~/.openclaw/openclaw.json（同目錄還有 state/、logs/ 等）。