這篇AI Agent平臺(tái)教程講什么

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

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

讀完你能搞定這些：

• macOS、Linux、Windows WSL 上合規(guī)完成AI Agent平臺(tái)安裝
• Node.js 22 環(huán)境配置和 API 密鑰設(shè)置
• Gateway 安全配置
• Skills 技能插件的安裝和AI Agent平臺(tái)使用

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

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

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

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

2. 加執(zhí)行權(quán)限

   chmod +x install_ai-agent.sh

3. 跑安裝腳本

   ./install_ai-agent.sh

   腳本會(huì)自動(dòng)拉依賴、配環(huán)境變量，整個(gè)過(guò)程不用手動(dòng)干預(yù)。這是AI Agent平臺(tái)安裝最省事的方式，新手首選。

方法二：Homebrew（僅 macOS）

1. 裝 Homebrew（沒(méi)裝過(guò)的話）

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

2. 一行命令裝 AI Agent平臺(tái)

   brew install ai-agent

   Homebrew 管版本很方便，后續(xù)升級(jí)直接 brew upgrade ai-agent 就行。

方法三：手動(dòng)下載安裝包

1. 打開(kāi) GitHub 倉(cāng)庫(kù)
   瀏覽器訪問(wèn) https://github.com/ai-agent/ai-agent
2. 下載最新 Release
   點(diǎn) "Releases" 標(biāo)簽，下最新版壓縮包。

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平臺(tái) 運(yùn)行依賴 Node.js 22，版本不對(duì)會(huì)報(bào)錯(cuò)。

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 版本管理器，裝多個(gè)版本也不沖突。

2. 驗(yàn)證版本

   node -v

   輸出 v22.x.x 就對(duì)了。

設(shè)置 API 密鑰

1. 拿到密鑰
   上 m.nhjb.com.cn m.nhjb.com.cn，登錄后進(jìn) "API Keys" 頁(yè)面生成。

2. 寫(xiě)入配置

   ai-agent config set api_key YOUR_API_KEY

   把 YOUR_API_KEY 換成你實(shí)際拿到的密鑰。

API 密鑰是身份驗(yàn)證憑證，沒(méi)配好的話AI Agent平臺(tái)使用過(guò)程中所有功能調(diào)用都會(huì)報(bào) 401。

第三步：Gateway 安全配置

Gateway 負(fù)責(zé) AI Agent平臺(tái) 的內(nèi)外通信，配錯(cuò)了有安全風(fēng)險(xiǎn)。

1. 改監(jiān)聽(tīng)地址
   編輯 config.yaml，找到 gateway 段：

   gateway:
     host: 0.0.0.0
     port: 8080

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

2. 啟動(dòng) Gateway

   ai-agent gateway start

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

   sudo ufw allow 8080

   防火墻能擋掉未授權(quán)訪問(wèn)，生產(chǎn)環(huán)境別跳過(guò)這步。

Skills 使用教程

AI Agent平臺(tái) 最強(qiáng)的地方在于 Skills 生態(tài)。這套技能插件體系讓你按需擴(kuò)展功能，不用自己造輪子。

1. 搜索 Skills

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

2. 安裝 Skills

ai-agent skills install skill_name

skill_name 換成實(shí)際插件名。

3. 配置 Skills

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

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

4. 重啟生效

ai-agent restart

5. 跑測(cè)試

ai-agent skills test skill_name

確認(rèn)輸出正常就可以正式用了。這是AI Agent平臺(tái)使用 Skills 的標(biāo)準(zhǔn)流程。

常見(jiàn)問(wèn)題 FAQ

1. 安裝時(shí)遇到權(quán)限報(bào)錯(cuò)？

用 sudo 提權(quán)，或者 chmod 改文件權(quán)限。nvm 裝的 Node 一般不需要 sudo，如果需要，說(shuō)明路徑配置有問(wèn)題。

2. API 密鑰丟了怎么辦？

登錄m.nhjb.com.cn，進(jìn) "API Keys" 頁(yè)面重新生成一個(gè)。舊密鑰會(huì)自動(dòng)失效。

3. Gateway 起不來(lái)？

先查 config.yaml 格式有沒(méi)有寫(xiě)錯(cuò)（YAML 對(duì)縮進(jìn)敏感），再用 lsof -i :8080 看端口是不是被占了。

寫(xiě)在最后

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

配好 Node.js 22 和 API 密鑰之后，Gateway 安全別偷懶，防火墻一定要開(kāi)。Skills 生態(tài)是 AI Agent平臺(tái) 的核心競(jìng)爭(zhēng)力，多逛逛m.nhjb.com.cn m.nhjb.com.cn 的排行榜，好用的插件能省大量開(kāi)發(fā)時(shí)間。

相關(guān)教程推薦：

• AI Agent平臺(tái) 技能插件排行榜
• AI Agent平臺(tái) 高級(jí)配置指南