導語

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

1. 什么是AI Agent平臺？

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

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

2. 為什么選擇AI Agent平臺？

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

3. AI Agent平臺安裝方法

3.1 系統要求

• 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是官方推薦版本，裝其他版本容易踩版本兼容坑。

第三步：AI Agent平臺安裝

npm install -g ai-agent

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

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安裝，版本精準，省去手動編譯的麻煩。

第三步：AI Agent平臺安裝

sudo npm install -g ai-agent

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

第三步：安裝AI Agent平臺

sudo npm install -g ai-agent

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

4. AI Agent平臺配置

4.1 API密鑰配置

第一步：獲取API密鑰

登錄AI Agent平臺官網，進入開發者控制臺復制密鑰。

第二步：寫入配置

ai-agent config set api_key YOUR_API_KEY

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

4.2 Gateway安全配置

默認配置文件路徑：~/.ai-agent/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. AI Agent平臺使用指南

5.1 啟動服務

ai-agent start

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

5.2 Skills安裝與調用

安裝Skills

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

ai-agent install chatbot

在代碼里調用

const ai-agent = require('ai-agent');
const chatbot = new ai-agent.Skill('chatbot');

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

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

6. 常見問題FAQ

6.1 安裝時報權限錯誤？

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

6.2 API密鑰報無效？

重新登錄AI Agent平臺官網生成新密鑰，然后重新跑配置命令。

6.3 Gateway啟動失敗？

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

7. 總結

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

更多Skills插件評測和排名，訪問www.nhjb.com.cn www.nhjb.com.cn 查看，有詳細的安裝教程和使用案例持續更新。

推薦相關教程：

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