什么是OpenClaw

OpenClaw 是一個(gè)開源、本地部署的 AI 智能體網(wǎng)關(guān)，它讓你可以在自己的電腦或服務(wù)器上運(yùn)行一個(gè)智能助手，通過(guò)聊天平臺(tái)隨時(shí)使用這個(gè)助手來(lái)完成任務(wù)。它的目標(biāo)不是像普通聊天機(jī)器人那樣只回答問(wèn)題，而是能真正執(zhí)行動(dòng)作，例如訪問(wèn)本地文件、自動(dòng)化任務(wù)或聯(lián)動(dòng)應(yīng)用等，這些都是通過(guò)統(tǒng)一的 Gateway 網(wǎng)關(guān)實(shí)現(xiàn)的。

OpenClaw 原名 Clawdbot，因 Anthropic 商標(biāo)顧慮在 2026年1月27日更名為 Moltbot（過(guò)渡名），最終在1月30日確定為 OpenClaw。三個(gè)名字本質(zhì)是同一個(gè)項(xiàng)目，功能完全一致。

核心能力和特點(diǎn)

OpenClaw 的設(shè)計(jì)強(qiáng)調(diào)實(shí)用性和擴(kuò)展性，它包含一些核心能力：

• 本地部署與隱私控制：在用戶自己的機(jī)器上運(yùn)行，你的數(shù)據(jù)不用上傳到第三方服務(wù)器。
• 多平臺(tái)接入：支持通過(guò)各種消息平臺(tái)（如 Telegram、Discord、企業(yè)微信、飛書、QQ 等）和智能體互動(dòng)。
• 技能擴(kuò)展系統(tǒng)：通過(guò)“Skills（技能）”系統(tǒng)來(lái)擴(kuò)展能力，例如文件管理、知識(shí)管理、自動(dòng)化操作等。
• 工作原理由 Gateway 驅(qū)動(dòng)：Gateway 是核心組件，它負(fù)責(zé)消息路由、會(huì)話管理和不同平臺(tái)的連接。

OpenClaw安裝

為了獲得最佳體驗(yàn)，我們推薦：

操作系統(tǒng)：

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

Mac本地部署（推薦）

最佳體驗(yàn)：如果你有Mac電腦，強(qiáng)烈推薦本地部署，體驗(yàn)最好、功能最全！

系統(tǒng)要求

硬件要求：

• CPU：M系列芯片或Intel i5以上
• 內(nèi)存：8GB以上（推薦16GB）
• 硬盤：10GB以上空閑空間

系統(tǒng)版本：

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

前置軟件：

• Node.js 22.0.0+（會(huì)自動(dòng)安裝）
• Homebrew（可選，用于安裝依賴）

安裝步驟

第一步：打開終端

按 Command + 空格 打開 Spotlight

輸入 Terminal 或終端

按回車打開終端

第二步：安裝 OpenClaw

在終端中執(zhí)行以下命令：

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

安裝過(guò)程會(huì)自動(dòng)：

• 檢測(cè)系統(tǒng)環(huán)境
• 安裝Node.js（如果未安裝）
• 下載OpenClaw
• 配置環(huán)境變量

預(yù)計(jì)時(shí)間：2-5分鐘

第三步：驗(yàn)證安裝

安裝完成后，執(zhí)行以下命令驗(yàn)證：

openclaw --version

如果顯示版本號(hào)（如 2026.2.9），說(shuō)明安裝成功！

第四步：初始化配置

運(yùn)行配置向?qū)В?/p>

openclaw onboard

配置流程：

1. 接受風(fēng)險(xiǎn)提示：

選擇 Yes 繼續(xù)

2. 選擇啟動(dòng)模式：

推薦選擇 QuickStart 快速啟動(dòng)：

3. 選擇AI模型：

選擇你的AI供應(yīng)商（支持國(guó)內(nèi)外主流模型）：

4. 輸入API Key：

根據(jù)選擇的模型，輸入對(duì)應(yīng)的API Key

5. 選擇聊天工具：

如果要接入飛書/Telegram，選擇對(duì)應(yīng)選項(xiàng)

如果暫時(shí)不接入，選擇 None（后續(xù)可配置）

6. Gateway端口設(shè)置：

默認(rèn) 18789 即可：

7. 選擇Skills：

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

8. API Key配置：

沒(méi)有的可以選擇 no 跳過(guò)：

9. 啟用Hooks：

推薦啟用這三個(gè)鉤子（用于內(nèi)容引導(dǎo)、日志和會(huì)話記錄）：

10. 完成配置：

配置完成后，會(huì)自動(dòng)啟動(dòng)Gateway服務(wù)并打開Web UI（http://127.0.0.1:18789/chat）

第五步：驗(yàn)證安裝

# 檢查Gateway狀態(tài) openclaw channels status 
# 應(yīng)該顯示：
# Gateway reachable.

Windows本地部署

Windows用戶：完全可用，但部分系統(tǒng)集成功能受限。

系統(tǒng)要求

硬件要求：

• CPU：2核以上
• 內(nèi)存：4GB以上（推薦8GB）
• 硬盤：10GB以上空閑空間

操作系統(tǒng)：Windows 10 或 Windows 11

前置軟件：Node.js 22.0.0+

PowerShell原生部署

第一步：安裝Node.js 22+

方法一：官網(wǎng)下載安裝

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

第二步：驗(yàn)證Node.js安裝

# 打開PowerShell node -v npm -v

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

重要：必須以管理員身份運(yùn)行PowerShell。

# 安裝最新穩(wěn)定版 npm install -g openclaw@latest # 或安裝漢化版 npm install -g @qingchencloud/openclaw-zh@latest

第四步：解決安裝權(quán)限問(wèn)題

如果遇到權(quán)限錯(cuò)誤：

# 方法A：?jiǎn)⒂肞owerShell腳本執(zhí)行 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")

第五步：驗(yàn)證安裝

version openclaw --help

第六步：解決常見(jiàn)問(wèn)題

問(wèn)題：sharp模塊加載失敗

# 清理npm緩存 npm cache clean --force # 重新安裝 npm install -g openclaw@latest --force

問(wèn)題：Windows Defender阻止

將OpenClaw安裝目錄添加到Windows Defender排除項(xiàng)：

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

初始化配置

安裝完成后，需要運(yùn)行初始化向?qū)А?/p>

啟動(dòng)初始化向?qū)?/p>

openclaw onboard --install-daemon

Linux本地部署

Linux用戶：適合開發(fā)者，配置靈活。

系統(tǒng)要求

推薦發(fā)行版：

• 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 # 驗(yàn)證安裝 node --version

第二步：安裝 OpenClaw

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

第三步：驗(yàn)證安裝

openclaw --version

第四步：初始化配置

openclaw onboard

OpenClaw配置神馬中轉(zhuǎn)API

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

系統(tǒng)文件路徑示例

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

需要手動(dòng)編輯配置文件 ~/.openclaw/openclaw.json，指定：

• baseUrl：API服務(wù)地址
• apiKey：認(rèn)證密鑰
• api：API協(xié)議類型（如 openai-chat、anthropic-messages）
• models：模型列表和參數(shù)

配置神馬中轉(zhuǎn)API代理

如果你使用API代理服務(wù)，配置如下：

{ "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" } } } }

配置參數(shù)說(shuō)明

常見(jiàn)API協(xié)議類型

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

配置后重啟服務(wù)

# 方式1：重
啟Gateway openclaw gateway restart
# 方式2：停止后重新啟動(dòng) 
systemctl --user stop openclaw-gateway.service systemctl --user start openclaw-gateway.service
# 方式3：完全重啟 
systemctl --user restart openclaw-gateway.service

驗(yàn)證配置

# 查看當(dāng)前配置的模型 
openclaw models list
# 測(cè)試模型連接 
openclaw models test whataicc/anthropic/claude-sonnet-4-6

常見(jiàn)問(wèn)題及解決方案

問(wèn)題1：找不到配置文件

排查步驟:

檢查配置文件是否存在

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

運(yùn)行 doctor 命令

openclaw doctor

手動(dòng)創(chuàng)建配置文件

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

問(wèn)題2：多個(gè) Agent 配置混亂

解決方案:

查看所有 Agent

openclaw agents list

查看每個(gè) Agent 的配置

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

統(tǒng)一管理

• 使用全局配置 + Agent 覆蓋
• 或者每個(gè) Agent 完全獨(dú)立配置

問(wèn)題3：Node.js版本不對(duì)

# 檢查版本 
node --version 
# 如果低于22，升級(jí) 
nvm install 22 nvm use 22

問(wèn)題4： 權(quán)限錯(cuò)誤

# macOS/Linux 
sudo chown -R $USER ~/.openclaw 
# Windows 
# 以管理員身份運(yùn)行
PowerShell

問(wèn)題5：API配置問(wèn)題

API Key無(wú)效

• 檢查是否完整復(fù)制（包括sk-前綴）
• 檢查是否有多余空格
• 檢查賬戶余額是否充足

模型不可用

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

Token消耗太快

• 使用更便宜的模型
• 優(yōu)化提示詞
• 定期清理會(huì)話歷史

問(wèn)題6：Gateway問(wèn)題

Q1: Gateway無(wú)法啟動(dòng)

# 查看日志 
tail -f ~/.openclaw/logs/gateway.log 
# 重啟Gateway 
openclaw gateway restart

Q2: 端口被占用

# 查看端口占用 
lsof -i :18789 
# 修改端口 
openclaw config set gateway.port 18790

到此這篇關(guān)于2026年最新OpenClaw(龍蝦ai)的安裝配置API思路與推薦方案的文章就介紹到這了,更多相關(guān)OpenClaw安裝配置API內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論