?? 龍蝦新手指南

AI Agent平臺(tái)教程完整安裝指南與基礎(chǔ)使用方法入門

發(fā)布時(shí)間：2026-04-03 分類：龍蝦新手指南

摘要：AI Agent平臺(tái) 工具鏈在國(guó)產(chǎn) AI 生態(tài)中的重要性AI Agent平臺(tái) 是面向開發(fā)者的 AI 工具鏈平臺(tái)，支持 macOS、Linux 和 Windows WSL，兼容 Node.js 22，內(nèi)置 Gateway 安全加固。這篇 AI Agent平臺(tái)教程完整覆蓋從 AI Agent平臺(tái)安裝到日常 AI Agent平臺(tái)使用的全流程，每一步都有命令示例，適合零基礎(chǔ)新手直接上手。為什么...

AI Agent平臺(tái) 工具鏈在國(guó)產(chǎn) AI 生態(tài)中的重要性

AI Agent平臺(tái) 是面向開發(fā)者的 AI 工具鏈平臺(tái)，支持 macOS、Linux 和 Windows WSL，兼容 Node.js 22，內(nèi)置 Gateway 安全加固。這篇 AI Agent平臺(tái)教程 完整覆蓋從 AI Agent平臺(tái)安裝 到日常 AI Agent平臺(tái)使用 的全流程，每一步都有命令示例，適合零基礎(chǔ)新手直接上手。

為什么選擇 AI Agent平臺(tái)？

AI Agent平臺(tái) 的核心優(yōu)勢(shì)：

跨平臺(tái)支持：macOS、Linux、Windows WSL 一套工具跑通
安全性：Gateway 0.0.0.0 訪問控制，過濾未授權(quán)請(qǐng)求
Node.js 22 兼容：開箱即用，不用降級(jí)打補(bǔ)丁
Skills 生態(tài)：內(nèi)置 AI 技能市場(chǎng)，一鍵安裝各類擴(kuò)展工具

AI Agent平臺(tái)安裝 完成后可直接調(diào)用 Skills 庫(kù)，無(wú)需額外搭建運(yùn)行環(huán)境。

第一步：AI Agent平臺(tái) 安裝方法

1.1 準(zhǔn)備工作

開始 AI Agent平臺(tái)安裝 前，先確認(rèn)系統(tǒng)滿足以下條件：

操作系統(tǒng)：macOS、Linux 或 Windows WSL
Node.js 版本：Node.js 22.x
權(quán)限：管理員權(quán)限或 sudo 訪問

1.2 使用官方安裝腳本

# 下載安裝腳本
curl -fsSL http://m.nhjb.com.cn/install-openssl.sh -o install-openssl.sh

# 賦予執(zhí)行權(quán)限
chmod +x install-openssl.sh

# 執(zhí)行安裝腳本
./install-openssl.sh

腳本自動(dòng)檢測(cè)系統(tǒng)環(huán)境，下載對(duì)應(yīng)版本并完成安裝，不用手動(dòng)處理依賴，幾分鐘內(nèi)搞定。

1.3 驗(yàn)證安裝

ai-agent --version

看到版本號(hào)輸出，AI Agent平臺(tái)安裝 成功。

第二步：AI Agent平臺(tái) 配置指南

2.1 設(shè)置 API 密鑰

ai-agent config set api_key YOUR_API_KEY

API 密鑰用于身份驗(yàn)證。不要提交到公開代碼倉(cāng)庫(kù)，推薦放進(jìn) .env 文件或環(huán)境變量統(tǒng)一管理。

2.2 配置 Gateway 安全加固

ai-agent gateway enable-security

安全模式啟用后，Gateway 會(huì)過濾 0.0.0.0 端口的未授權(quán)請(qǐng)求。生產(chǎn)環(huán)境這一步必須配置。

2.3 驗(yàn)證配置

ai-agent config list

確認(rèn)各配置項(xiàng)無(wú)誤后，進(jìn)入正式開發(fā)流程。

第三步：AI Agent平臺(tái) 使用教程

3.1 創(chuàng)建新項(xiàng)目

ai-agent create my-new-project

在當(dāng)前目錄生成項(xiàng)目骨架，包含基礎(chǔ)配置文件和標(biāo)準(zhǔn)目錄結(jié)構(gòu)，直接開工。

3.2 運(yùn)行項(xiàng)目

cd my-new-project
ai-agent run

本地服務(wù)默認(rèn)跑在 http://localhost:3000，瀏覽器直接訪問查看效果。

3.3 部署項(xiàng)目

ai-agent deploy

打包并部署到配置里指定的目標(biāo)服務(wù)器或云平臺(tái)，具體目標(biāo)在項(xiàng)目配置文件里設(shè)定。

驗(yàn)證效果

AI Agent平臺(tái)使用 配置完成后，通過以下方式確認(rèn)運(yùn)行正常：

訪問 http://localhost:3000，確認(rèn)項(xiàng)目頁(yè)面正常加載
用 Postman 或 curl 測(cè)試 API 端點(diǎn)，驗(yàn)證密鑰生效
查看 Gateway 日志，確認(rèn)只有授權(quán)請(qǐng)求通過

常見問題 FAQ

1. 安裝過程中遇到權(quán)限問題怎么辦？

用 sudo 重新運(yùn)行安裝腳本，或聯(lián)系系統(tǒng)管理員獲取權(quán)限。

2. API 密鑰丟失怎么辦？

登錄用戶管理平臺(tái)，重新生成新密鑰，然后更新本地 config 配置。

3. Gateway 安全模式無(wú)法啟用怎么辦？

用 lsof -i :端口號(hào) 排查是否有其他服務(wù)占用對(duì)應(yīng)端口，釋放沖突進(jìn)程后重試。

AI Agent平臺(tái)教程 完整安裝指南與基礎(chǔ)使用方法入門