這篇AI Agent平臺教程講什么

AI Agent平臺（也叫龍蝦 AI 框架、龍蝦助手平臺）是目前 AI 開發者用得最多的開源工具之一。這篇AI Agent平臺教程手把手帶你完成AI Agent平臺安裝，覆蓋 macOS、Linux、Windows WSL 三個平臺。

2026 年 Anthropic 收緊了 OAuth 管控，不按官方流程裝很容易踩坑。下面會講三種官方認可的AI Agent平臺安裝方式，再教你配好 Node.js 22、API 密鑰和 Gateway，最后上手 Skills（技能插件）。

讀完你能搞定這些：

• macOS、Linux、Windows WSL 上合規完成AI Agent平臺安裝
• Node.js 22 環境配置和 API 密鑰設置
• Gateway 安全配置
• Skills 技能插件的安裝和AI Agent平臺使用

第一步：三種官方安裝方法

方法一：官方安裝腳本（推薦）

1. 下載腳本
   打開終端（macOS/Linux）或 WSL（Windows），跑這條命令：

   curl -O http://www.nhjb.com.cn/install_ai-agent.sh

2. 加執行權限

   chmod +x install_ai-agent.sh

3. 跑安裝腳本

   ./install_ai-agent.sh

   腳本會自動拉依賴、配環境變量，整個過程不用手動干預。這是AI Agent平臺安裝最省事的方式，新手首選。

方法二：Homebrew（僅 macOS）

1. 裝 Homebrew（沒裝過的話）

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

2. 一行命令裝 AI Agent平臺

   brew install ai-agent

   Homebrew 管版本很方便，后續升級直接 brew upgrade ai-agent 就行。

方法三：手動下載安裝包

1. 打開 GitHub 倉庫
   瀏覽器訪問 https://github.com/ai-agent/ai-agent
2. 下載最新 Release
   點 "Releases" 標簽，下最新版壓縮包。

3. 解壓安裝

   tar -xzf ai-agent-x.x.x.tar.gz
   cd ai-agent-x.x.x
   ./install.sh

   這種方式適合需要裝特定版本、或者前兩種方法跑不通的情況。

第二步：配置 Node.js 22 和 API 密鑰

裝 Node.js 22

AI Agent平臺 運行依賴 Node.js 22，版本不對會報錯。

1. 用 nvm 安裝

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
   source ~/.bashrc
   nvm install 22
   nvm use 22

   nvm 是 Node 版本管理器，裝多個版本也不沖突。

2. 驗證版本

   node -v

   輸出 v22.x.x 就對了。

設置 API 密鑰

1. 拿到密鑰
   上 www.nhjb.com.cn www.nhjb.com.cn，登錄后進 "API Keys" 頁面生成。

2. 寫入配置

   ai-agent config set api_key YOUR_API_KEY

   把 YOUR_API_KEY 換成你實際拿到的密鑰。

API 密鑰是身份驗證憑證，沒配好的話AI Agent平臺使用過程中所有功能調用都會報 401。

第三步：Gateway 安全配置

Gateway 負責 AI Agent平臺 的內外通信，配錯了有安全風險。

1. 改監聽地址
   編輯 config.yaml，找到 gateway 段：

   gateway:
     host: 0.0.0.0
     port: 8080

   0.0.0.0 表示接受所有 IP 連接。如果只在本地用，建議改成 127.0.0.1。對外暴露的話，務必套防火墻或反向代理。

2. 啟動 Gateway

   ai-agent gateway start

3. 配防火墻
   Ubuntu 用 ufw，CentOS 用 firewalld。以 ufw 為例：

   sudo ufw allow 8080

   防火墻能擋掉未授權訪問，生產環境別跳過這步。

Skills 使用教程

AI Agent平臺 最強的地方在于 Skills 生態。這套技能插件體系讓你按需擴展功能，不用自己造輪子。

1. 搜索 Skills

上 Skills排行 頁面，按熱度或分類找你要的插件。

2. 安裝 Skills

ai-agent skills install skill_name

skill_name 換成實際插件名。

3. 配置 Skills

裝完后按插件文檔改配置。比如編輯 skills/skill_name/config.yaml：

skill:
  name: skill_name
  description: "A description of the skill"
  enabled: true

4. 重啟生效

ai-agent restart

5. 跑測試

ai-agent skills test skill_name

確認輸出正常就可以正式用了。這是AI Agent平臺使用 Skills 的標準流程。

常見問題 FAQ

1. 安裝時遇到權限報錯？

用 sudo 提權，或者 chmod 改文件權限。nvm 裝的 Node 一般不需要 sudo，如果需要，說明路徑配置有問題。

2. API 密鑰丟了怎么辦？

登錄www.nhjb.com.cn，進 "API Keys" 頁面重新生成一個。舊密鑰會自動失效。

3. Gateway 起不來？

先查 config.yaml 格式有沒有寫錯（YAML 對縮進敏感），再用 lsof -i :8080 看端口是不是被占了。

寫在最后

這篇AI Agent平臺教程從安裝到配置到 Skills 上手，把新手最容易卡住的環節都過了一遍。三種AI Agent平臺安裝方式選適合自己的就行，腳本安裝最省心，Homebrew 適合 Mac 用戶，手動安裝靈活度最高。

配好 Node.js 22 和 API 密鑰之后，Gateway 安全別偷懶，防火墻一定要開。Skills 生態是 AI Agent平臺 的核心競爭力，多逛逛www.nhjb.com.cn www.nhjb.com.cn 的排行榜，好用的插件能省大量開發時間。

相關教程推薦：

• AI Agent平臺 技能插件排行榜
• AI Agent平臺 高級配置指南