2026最新OpenClaw(龍蝦AI)安裝配置API思路與推薦方案

很多人第一次用 AI，都会停留在“問答工具”這個階段：幫你寫點文案、改改程式碼、查查資料。但用著用著就會發現一個問題——它很聰明，卻什麼也「做不了」。

你還是得自己打開文件、複製內容、切換應用、執行命令，AI 更像一個「場外顧問」，而不是能真正幫你幹活的助手。

如果你也想過：有沒有一種 AI，可以像真人助理一樣，直接在我的電腦和工具裡動手？

那你很可能會對 OpenClaw 感興趣。

什麼是OpenClaw

OpenClaw 是一個開源、本地部署的 AI 智能體網關，它讓你可以在自己的電腦或伺服器上運行一個智能助手，通過聊天平台隨時使用這個助手來完成任務。它的目標不是像普通聊天機器人那樣只回答問題，而是能真正執行動作，例如訪問本地文件、自動化任務或聯動應用等，這些都是通過統一的 Gateway 網關實現的。

OpenClaw 原名 Clawdbot，因 Anthropic 商標顧慮在 2026年1月27日更名為 Moltbot（過渡名），最終在1月30日確定為 OpenClaw。三個名字本質是同一個項目，功能完全一致。

核心能力和特點

OpenClaw 的設計強調實用性和擴展性，它包含一些核心能力：

• 本地部署與隱私控制：在用戶自己的機器上運行，你的資料不用上傳到第三方伺服器。
• 多平台接入：支持通過各種消息平台（如 Telegram、Discord、企業微信、飛書、QQ 等）和智能體互動。
• 技能擴展系統：通過「Skills（技能）」系統來擴展能力，例如文件管理、知識管理、自動化操作等。
• 工作原理由 Gateway 驅動：Gateway 是核心組件，它負責消息路由、會話管理和不同平台的連接。

OpenClaw安裝

為了獲得最佳體驗，我們推薦：

操作系統：

• Mac（強烈推薦）：原生支持最完善，可操作日曆、備忘錄、截圖等系統功能
• Windows：完全可用，但部分系統集成功能受限
• Linux：適合開發者，配置靈活

Mac本地部署（推薦）

最佳體驗：如果你有Mac電腦，強烈推薦本地部署，體驗最好、功能最全！

系統要求

硬體要求：

• CPU：M系列晶片或Intel i5以上
• 內存：8GB以上（推薦16GB）
• 硬碟：10GB以上空閒空間

系統版本：

• macOS 12 Monterey 或更高版本
• 推薦 macOS 14 Sonoma 或 macOS 15 Sequoia

前置軟體：

• Node.js 22.0.0+（會自動安裝）
• Homebrew（可選，用於安裝依賴）

安裝步驟

第一步：打開終端

1. 按 Command + 空格 打開 Spotlight
2. 輸入 Terminal 或 終端
3. 按回車打開終端

第二步：安裝 OpenClaw

在終端中執行以下命令：

curl -fsSL https://openclaw.ai/install.sh | bash

安裝過程會自動：

• 檢測系統環境
• 安裝Node.js（如果未安裝）
• 下載OpenClaw
• 配置環境變數

預計時間：2-5分鐘

第三步：驗證安裝

安裝完成後，執行以下命令驗證：

openclaw --version

如果顯示版本號（如 2026.2.9），說明安裝成功！

第四步：初始化配置

運行配置嚮導：

openclaw onboard

配置流程：

1. 接受風險提示：

選擇 Yes 繼續

2. 選擇啟動模式：

推薦選擇 QuickStart 快速啟動：

3. 選擇AI模型：

選擇你的AI供應商（支持國內外主流模型）：

4. 輸入API Key：

根據選擇的模型，輸入對應的API Key

5. 選擇聊天工具：

• 如果要接入飛書/Telegram，選擇對應選項
• 如果暫時不接入，選擇 None（後續可配置）

6. Gateway端口設定：

默認 18789 即可：

7. 選擇Skills：

使用空格鍵選擇你需要的技能，也可以直接跳過：

8. API Key配置：

沒有的可以選擇 no 跳過：

9. 啟用Hooks：

推薦啟用這三個鉤子（用於內容引導、日誌和會話記錄）：

10. 完成配置：

配置完成後，會自動啟動Gateway服務並打開Web UI（http://127.0.0.1:18789/chat）

第五步：驗證安裝

# 檢查Gateway狀態
openclaw channels status

# 應該顯示：
# Gateway reachable.

Windows本地部署

🪟 Windows用戶：完全可用，但部分系統集成功能受限。

系統要求

硬體要求：

• CPU：2核以上
• 內存：4GB以上（推薦8GB）
• 硬碟：10GB以上空閒空間

操作系統：

• Windows 10 或 Windows 11

前置軟體：

• Node.js 22.0.0+

PowerShell原生部署

第一步：安裝Node.js 22+

方法一：官網下載安裝

1. 訪問 nodejs.org/zh-cn
2. 下載Windows安裝包（LTS版本22.x）
3. 運行安裝程序，勾選「自動安裝必要的工具」

第二步：驗證Node.js安裝

# 打開PowerShell
node -v
npm -v

第三步：以管理員身份安裝 OpenClaw

重要：必須以管理員身份運行PowerShell。

# 安裝最新穩定版
npm install -g openclaw@latest

# 或安裝漢化版
npm install -g @qingchencloud/openclaw-zh@latest

第四步：解決安裝權限問題

如果遇到權限錯誤：

# 方法A：啟用PowerShell腳本執行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 方法B：修改npm安裝目錄
npm config set prefix "C:\npm"
npm config set cache "C:\npm-cache"

# 將目錄添加到PATH
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\npm", "User")

第五步：驗證安裝

openclaw --version
openclaw --help

第六步：解決常見問題

問題：sharp模組加載失敗

# 清理npm快取
npm cache clean --force

# 重新安裝
npm install -g openclaw@latest --force

問題：Windows Defender阻止

將OpenClaw安裝目錄添加到Windows Defender排除項：

C:\Users\你的用戶名\AppData\Roaming\npm
C:\Users\你的用戶名\.openclaw

初始化配置

安裝完成後，需要運行初始化嚮導。

啟動初始化嚮導

openclaw onboard --install-daemon

Linux本地部署

Linux用戶：適合開發者，配置靈活。

系統要求

推薦發行版：

• Ubuntu 20.04+
• Debian 11+
• CentOS 8+

安裝步驟

第一步：安裝Node.js

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

# 驗證安裝
node --version

第二步：安裝 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

第三步：驗證安裝

openclaw --version

第四步：初始化配置

openclaw onboard

OpenClaw配置神馬中轉API

OpenClaw 的配置文件位置通常如下：

系統文件路徑示例

• Windows: C:\Users\用戶名\.openclaw\openclaw.json
• macOS: ~/.openclaw/openclaw.json
• Linux: ~/.openclaw/openclaw.json

需要手動編輯配置文件 ~/.openclaw/openclaw.json，指定：

• baseUrl：API服務地址
• apiKey：認證密鑰
• api：API協議類型（如 openai-chat、anthropic-messages）
• models：模型列表和參數

配置神馬中轉API代理

如果你使用API代理服務，配置如下：

{
  "models": {
    "mode": "merge",
    "providers": {
      "whataicc": {
        "baseUrl": "https://api.whatai.cc/v1",
        "apiKey": "sk-or-v1-你的密鑰",
        "auth": "api-key",
        "api": "openai-chat",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "openai/gpt-4",
            "name": "GPT-4",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "whataicc/anthropic/claude-sonnet-4-6"
      }
    }
  }
}

配置參數說明

常見API協議類型

• openai-chat：OpenAI兼容接口（最常用）
• anthropic-messages：Anthropic Claude接口
• google-generative-ai：Google Gemini接口

配置後重啟服務

# 方式1：重啟Gateway
openclaw gateway restart

# 方式2：停止後重新啟動
systemctl --user stop openclaw-gateway.service
systemctl --user start openclaw-gateway.service

# 方式3：完全重啟
systemctl --user restart openclaw-gateway.service

驗證配置

# 查看當前配置的模型
openclaw models list

# 測試模型連接
openclaw models test whataicc/anthropic/claude-sonnet-4-6

常見問題及解決方案

問題1：找不到配置文件

排查步驟:

1. 檢查配置文件是否存在

   ls -la ~/.openclaw/openclaw.json
   ls -la ~/.openclaw/agents/*/openclaw.json

2. 運行 doctor 命令

   openclaw doctor

3. 手動創建配置文件

   mkdir -p ~/.openclaw
   echo '{}' > ~/.openclaw/openclaw.json

問題2：多個 Agent 配置混亂

解決方案:

1. 查看所有 Agent

   openclaw agents list

2. 查看每個 Agent 的配置

   openclaw config get --agent main-assistant
   openclaw config get --agent tech-dev

3. 統一管理

   • 使用全局配置 + Agent 覆蓋
   • 或者每個 Agent 完全獨立配置

問題3：Node.js版本不對

# 檢查版本
node --version

# 如果低於22，升級
nvm install 22
nvm use 22

問題4：權限錯誤

# macOS/Linux
sudo chown -R $USER ~/.openclaw

# Windows
# 以管理員身份運行PowerShell

問題5：API配置問題

API Key無效

• 檢查是否完整複製（包括sk-前綴）
• 檢查是否有多餘空格
• 檢查賬戶餘額是否充足

模型不可用

• 檢查模型ID是否正確
• 檢查API服務是否正常
• 嘗試切換其他模型

Token消耗太快

• 使用更便宜的模型
• 優化提示詞
• 定期清理會話歷史

問題6：Gateway問題

Q1: Gateway無法啟動

# 查看日誌
tail -f ~/.openclaw/logs/gateway.log

# 重啟Gateway
openclaw gateway restart

Q2: 端口被佔用

# 查看端口佔用
lsof -i :18789

# 修改端口
openclaw config set gateway.port 18790

原文出處：https://juejin.cn/post/7613015638243590186