導語

這份OpenClaw教程覆蓋三大平臺安裝（macOS/Linux/WSL）、API密鑰配置、Gateway安全加固以及Skills調用全流程，適合剛接觸OpenClaw安裝的新手。不管你是AI開發(fā)者還是想搭個私人助手，跟著本文一步步來，半小時內能跑起來。

1. 什么是OpenClaw？

OpenClaw，也叫龍蝦AI框架，是一個開源AI助手平臺。它把多個AI功能模塊（Skills）集成進來，支持跨平臺運行，適合構建智能應用和自動化服務。

本篇OpenClaw教程專門為新手設計，目標只有一個：從零到跑通，不繞彎子。

2. 為什么選擇OpenClaw？

• 開源免費：不需要付許可證費用。
• 跨平臺：macOS、Linux、WSL三端通吃。
• Skills豐富：功能模塊覆蓋對話、自動化、數據處理等場景。
• 社區(qū)活躍：遇到問題基本能在社區(qū)里找到解答。

3. OpenClaw安裝方法

3.1 系統(tǒng)要求

• macOS：10.15 Catalina 及以上。
• Linux：Ubuntu 20.04 LTS 及以上。
• WSL：Windows 10+，需開啟 WSL 2。

3.2 安裝步驟

3.2.1 macOS

第一步：安裝Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

macOS上沒有Homebrew很難受，裝了之后包管理省心很多。

第二步：安裝Node.js 22

brew install node@22

Node.js 22是官方推薦版本，裝其他版本容易踩版本兼容坑。

第三步：OpenClaw安裝

npm install -g openclaw

-g 全局安裝，裝完就能在任何目錄直接用 openclaw 命令。

3.2.2 Linux

第一步：更新包列表

sudo apt update

第二步：安裝Node.js 22

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

通過NodeSource安裝，版本精準，省去手動編譯的麻煩。

第三步：OpenClaw安裝

sudo npm install -g openclaw

3.2.3 WSL

WSL上的安裝步驟和Linux一致：

第一步：更新包列表

sudo apt update

第二步：安裝Node.js 22

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

第三步：安裝OpenClaw

sudo npm install -g openclaw

Windows用戶通過WSL跑OpenClaw，體驗和原生Linux基本沒差別。

4. OpenClaw配置

4.1 API密鑰配置

第一步：獲取API密鑰

登錄OpenClaw官網，進入開發(fā)者控制臺復制密鑰。

第二步：寫入配置

openclaw config set api_key YOUR_API_KEY

把 YOUR_API_KEY 換成實際密鑰。這步沒做好，后面所有AI調用都會報錯，是最容易忽略的坑。

4.2 Gateway安全配置

默認配置文件路徑：~/.openclaw/config.yaml，找到Gateway部分：

gateway:
  host: 0.0.0.0
  port: 8080

把 host 改成 127.0.0.1：

gateway:
  host: 127.0.0.1
  port: 8080

0.0.0.0 對外開放所有網絡接口，改成 127.0.0.1 只允許本地訪問，安全性直接拉滿。

5. OpenClaw使用指南

5.1 啟動服務

openclaw start

啟動后訪問 http://localhost:8080，OpenClaw使用界面就出來了。

5.2 Skills安裝與調用

安裝Skills

去Skills排行挑選需要的模塊，比如 chatbot：

openclaw install chatbot

在代碼里調用

const openclaw = require('openclaw');
const chatbot = new openclaw.Skill('chatbot');

chatbot.process('你好！').then(response => {
  console.log(response);
});

調用 process() 方法，把輸入傳進去，AI回復就出來了。

6. 常見問題FAQ

6.1 安裝時報權限錯誤？

在命令前加 sudo，或者確認當前賬戶有管理員權限。

6.2 API密鑰報無效？

重新登錄OpenClaw官網生成新密鑰，然后重新跑配置命令。

6.3 Gateway啟動失??？

檢查8080端口是否被占用：lsof -i :8080。如果被占，改配置文件里的端口號就行。

7. 總結

本文覆蓋了OpenClaw安裝（macOS/Linux/WSL三平臺）、API密鑰配置、Gateway安全加固，以及OpenClaw使用的完整流程。這份OpenClaw教程能幫你繞開大部分新手常見坑，把環(huán)境搭起來直接開干。

更多Skills插件評測和排名，訪問龍蝦官網 m.gsdl.org.cn 查看，有詳細的安裝教程和使用案例持續(xù)更新。

推薦相關教程：

• OpenClaw技能插件開發(fā)指南
• AI智能代理入門教程
• 國產Claw(AutoClaw等)使用教程