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

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

Linux 桌面已驗證可用 cc-switch 圖形介面設定龍蝦（寫入成功）。（前提：已安裝 cc-switch —— 安裝方式見開發者中心的「cc-switch Linux」分頁。）

端點與模型

Anthropic 原生端點   https://www.myai168.com/nthu/api/anthropic
OpenAI 相容端點      https://www.myai168.com/nthu/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：

node --version

沒有就裝（Ubuntu／Debian）：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

若與內建舊 Node 衝突（libnode-dev）：先移除再裝：

sudo apt-get remove -y libnode-dev
sudo apt-get install -y nodejs

確認 shell：

echo $SHELL

結尾是 /bash → 用 ~/.bashrc；結尾是 /zsh → 用 ~/.zshrc。

npm install -g openclaw@latest

驗證：

openclaw --version

若 command not found，把 npm 全域 bin 目錄加進 PATH：

echo 'export PATH="$PATH:'$(npm config get prefix)'/bin"' >> ~/.bashrc
source ~/.bashrc

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

cc-switch 會把設定寫進 ~/.openclaw/openclaw.json 的 models.providers，格式類似（供確認，通常不需手改）：

"models": {
  "mode": "merge",
  "providers": {
    "myai168-claude": {
      "baseUrl": "https://www.myai168.com/nthu/api/anthropic",
      "apiKey": "你的-key",
      "api": "anthropic-messages",
      "models": [ { "id": "claude-opus-4-8",
                    "name": "claude-opus-4-8", "input": ["text"] } ]
    }
  }
}

（注意：anthropic baseUrl 是 .../anthropic、不含 /v1——OpenClaw 的 Anthropic client 會自動附加 /v1，實測可用。）

確認寫入：

cat ~/.openclaw/openclaw.json

openclaw doctor

doctor 會問幾個設定，建議：

• Tighten permissions on ~/.openclaw to 700? → Yes
• Update gateway service config to recommended defaults? → Yes
• Disable unavailable skills? → Yes（環境沒裝的工具，停用較乾淨）
• Enable bash shell completion? → Yes

確認模型被讀到：

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，即代表接通成功。（別用「你是誰」驗證，模型自我認知不可靠。）

也可開後台試聊（後台需要 Gateway 在跑；全新安裝請先啟動）：

openclaw gateway start
openclaw gateway status     # 看到 Runtime: running 即正常
openclaw dashboard      # 瀏覽器開 http://127.0.0.1:18789/

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

更新：

openclaw update
# 或：npm update -g openclaw

安全稽核：

openclaw security audit --deep

更換 API Key

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

設定檔位置

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

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