OpenClaw（龍蝦）安裝與 MYAI168 設定指南 — macOS 版

本指南目標：在 macOS 安裝 OpenClaw（暱稱「龍蝦」🦞，跑在自己電腦上的開源 AI agent），並接上自己的 MYAI168 API，使用 Claude Opus 4.8（也可備一個 gpt-5.6-sol）。

端點與模型

Anthropic 原生端點   https://www.myai168.com/futaba/api/anthropic
OpenAI 相容端點      https://www.myai168.com/futaba/api/openai/v1
主模型               claude-opus-4-8（走 Anthropic 端點）

重要安全須知

• 龍蝦擁有很廣的系統權限（讀檔、執行指令、發訊息、瀏覽網頁）。不建議裝在存大量敏感資料的主力機；有條件用獨立機器或乾淨帳號。
• 管理後台（Control UI）不要暴露到公開網路，維持 localhost 或放在 Tailscale／SSH 通道後。
• 務必裝最新版（舊版曾有嚴重資安漏洞）。
• 初期 token 消耗可能偏高，到 MYAI168 後台設用量上限。

前置

Node.js 22.22.3+、24.15+ 或 25.9+（官方預設目標為 Node 24，建議直接裝 24）。

確認 Node（沒有就 brew install node）：

node --version

安裝龍蝦（官方腳本，或已有 Node 用 npm）：

curl -fsSL https://openclaw.ai/install.sh | bash
# 或：npm i -g openclaw@latest

若 npm 權限錯誤（EACCES），把全域目錄改到家目錄：

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

驗證：

openclaw --version

openclaw onboard

依序回答：

• Security disclaimer → Yes
• Setup mode → QuickStart
• Model/auth provider → Skip for now（要接自定義 API，稍後改設定檔）
• 通訊軟體（Telegram／WhatsApp…）→ 全部跳過
• Generate gateway token? → Yes
• Tighten permissions? → Yes
• Create session store dir? → Yes
• Disable unavailable skills? → No（保留不影響，日後裝了相依就能用）

設 Gateway 本機模式：

openclaw config set gateway.mode local

mkdir -p ~/.openclaw
nano ~/.openclaw/openclaw.json

貼入（把「你的-key」換成真正金鑰；用 nano 避免 TextEdit 把直引號變彎引號導致 JSON 壞掉）：

{
  models: {
    mode: "merge",
    providers: {
      myai168: {
        baseUrl: "https://www.myai168.com/futaba/api/openai/v1",
        apiKey: "你的-key",
        api: "openai-completions",
        models: [
          { id: "gpt-5.6-sol", name: "GPT-5.6 Sol", input: ["text"],
            contextWindow: 200000, maxTokens: 32000 }
        ]
      },
      myai168_claude: {
        baseUrl: "https://www.myai168.com/futaba/api/anthropic",
        apiKey: "你的-key",
        api: "anthropic-messages",
        models: [
          { id: "claude-opus-4-8", name: "Claude Opus 4.8", input: ["text"],
            contextWindow: 200000, maxTokens: 32000 }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: { primary: "myai168_claude/claude-opus-4-8" },
      models: {
        "myai168_claude/claude-opus-4-8": {},
        "myai168/gpt-5.6-sol": {}
      }
    }
  }
}

（nano 存檔 Ctrl+O、Enter，離開 Ctrl+X。）

重點

• baseUrl 是小寫 u；api 欄位用 openai-completions／anthropic-messages。
• provider 要定義，也要在 agents.defaults.models 列入 allowlist，否則報 model not allowed。
• primary 是預設主模型；想預設 gpt-5.6-sol 就改成 "myai168/gpt-5.6-sol"。
• anthropic 端點的 baseUrl 填 https://www.myai168.com/futaba/api/anthropic（不含 /v1）——OpenClaw 的 Anthropic client 會自動在 baseUrl 後附加 /v1，填了 /v1 會變成 /v1/v1 重複路徑而連不上（官方文件明載）。

確認模型被讀到：

openclaw models list

應看到你的模型，Auth 欄 yes、主模型帶 default／configured 標籤。（若另外出現 claude-cli/... 是偵測到本機 Claude CLI 自動帶入的，忽略。）

啟動測試：

openclaw

進到對話介面後（若先進內建的「OpenClaw 設定助理」（setup agent，舊名 Crestodian），它會把你帶到 main agent；底部狀態列應顯示 myai168-claude/claude-opus-4-8），問一個運算題：

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

答對 97406784，即代表接通成功。（別用「你是誰」驗證，模型自我認知不可靠。）

也可開後台試聊：

openclaw dashboard      # 瀏覽器開 http://127.0.0.1:18789/

• command not found: openclaw → PATH 未生效。執行 source ~/.zshrc 或重開終端機。（Linux 為 source ~/.bashrc。）
• npm ... EACCES → 全域目錄權限問題，改 prefix 到 ~/.npm-global（見「一、前置與安裝」）。
• doctor 報 JSON 語法錯誤（手動編輯時） → 編輯器把直引號換成彎引號。用 nano 編輯，或關閉智慧型引號重貼。
• model not allowed → 模型沒列入 allowlist，在 agents.defaults.models 補上。（Linux 用 cc-switch 通常會處理好。）
• 回話報 model 相關錯誤 → 模型 id 或端點與供應商實際值不符，對照修正。
• 想換主模型 → 改設定檔 agents.defaults.model.primary。（Linux 為在 cc-switch 切換啟用的供應商。）

更新：

openclaw update
# 或：npm update -g openclaw

安全稽核：

openclaw security audit --deep

更換 API Key

改 ~/.openclaw/openclaw.json 裡的 apiKey，重啟 OpenClaw。（Linux 為在 cc-switch 卡片更新 API Key 後重新 Enable。）

設定檔位置

~/.openclaw/openclaw.json（同目錄有 state/、logs/ 等）

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