?? 龍蝦新手指南

AI Agent平臺(tái)開源AI助手框架5分鐘快速上手教程：從零搭建并跑通你的第一個(gè)AI助手

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

摘要：AI Agent平臺(tái) 5分鐘快速上手：從零到跑通你的第一個(gè)AI助手這篇教程解決什么問(wèn)題？很多AI愛(ài)好者想自己部署一個(gè)AI助手，但卡在了"配置太復(fù)雜""不知道從哪開始"。AI Agent平臺(tái)是一個(gè)開源的AI助手框架，能幫你快速搭建屬于自己的AI服務(wù)，還能接入Discord、Telegram等平臺(tái)。這篇教程的目標(biāo)很簡(jiǎn)單：5分鐘內(nèi)，讓你的AI助手跑起來(lái)。準(zhǔn)備工作開始之前，確認(rèn)你的電腦滿足這些條件：...

AI Agent平臺(tái) 5分鐘快速上手：從零到跑通你的第一個(gè)AI助手

這篇教程解決什么問(wèn)題？

很多AI愛(ài)好者想自己部署一個(gè)AI助手，但卡在了"配置太復(fù)雜""不知道從哪開始"。AI Agent平臺(tái)是一個(gè)開源的AI助手框架，能幫你快速搭建屬于自己的AI服務(wù)，還能接入Discord、Telegram等平臺(tái)。

這篇教程的目標(biāo)很簡(jiǎn)單：5分鐘內(nèi)，讓你的AI助手跑起來(lái)。

準(zhǔn)備工作

開始之前，確認(rèn)你的電腦滿足這些條件：

操作系統(tǒng)：macOS、Linux 或 Windows（WSL2）
Node.js：版本 18 或更高
一個(gè)終端：Terminal、iTerm2 或 PowerShell 都行
一個(gè) Discord 賬號(hào)（如果想測(cè)試 Discord 接入）

檢查 Node.js 版本：

# 檢查 Node.js 是否安裝，以及版本號(hào)
node --version
# 應(yīng)該輸出類似 v18.x.x 或 v20.x.x

如果沒(méi)裝 Node.js，去 https://nodejs.org 下載 LTS 版本安裝。

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

打開終端，執(zhí)行以下命令：

# 1. 全局安裝 AI Agent平臺(tái) 命令行工具
# -g 表示全局安裝，之后可以在任意目錄使用 oc 命令
npm install -g ai-agent

# 2. 驗(yàn)證安裝成功
# 如果輸出版本號(hào)，說(shuō)明安裝沒(méi)問(wèn)題
oc --version

為什么用 npm 全局安裝？ 因?yàn)?AI Agent平臺(tái) 是一個(gè) Node.js 項(xiàng)目，npm 是 Node.js 的包管理器。全局安裝后，你可以在任何文件夾里直接使用 oc 命令，不用每次都指定路徑。

第二步：運(yùn)行向?qū)В渲?Gateway

AI Agent平臺(tái) 提供了一個(gè)交互式向?qū)В瑤湍阃瓿苫A(chǔ)配置。執(zhí)行：

# 啟動(dòng) AI Agent平臺(tái) 初始化向?qū)?# 這個(gè)命令會(huì)引導(dǎo)你完成 Gateway 和認(rèn)證的配置
oc init

向?qū)?huì)問(wèn)你幾個(gè)問(wèn)題，按提示操作即可：

? 選擇 AI 提供商：(用方向鍵選擇)
  ? OpenAI
    Anthropic (Claude)
    本地模型 (Ollama)

? 輸入你的 API Key：sk-xxxxxxxxxxxxxxxx

? 設(shè)置 Gateway 端口：(默認(rèn) 3000)
  3000

? 是否啟用認(rèn)證？(推薦開啟)
  Yes

? 設(shè)置管理員密碼：********

什么是 Gateway？ 你可以把它理解成"中轉(zhuǎn)站"。用戶的請(qǐng)求先到 Gateway，Gateway 再把請(qǐng)求轉(zhuǎn)發(fā)給 AI 模型，拿到結(jié)果后返回給用戶。這樣做的好處是：你可以在 Gateway 層做權(quán)限控制、日志記錄、限流等操作，不用直接暴露 AI 的 API Key。

為什么要開啟認(rèn)證？ 如果不開啟，任何人都能用你的 AI 服務(wù)，可能會(huì)被濫用導(dǎo)致 API 費(fèi)用飆升。開啟認(rèn)證后，需要輸入密碼才能使用。

第三步：?jiǎn)?dòng)服務(wù)

配置完成后，啟動(dòng) AI Agent平臺(tái)：

# 啟動(dòng) Gateway 服務(wù)
# 終端會(huì)顯示服務(wù)運(yùn)行的日志
oc start

你應(yīng)該看到類似這樣的輸出：

?? AI Agent平臺(tái) Gateway 已啟動(dòng)
?? 監(jiān)聽地址: http://localhost:3000
? AI 提供商已連接: OpenAI
?? 認(rèn)證已啟用

驗(yàn)證服務(wù)是否正常運(yùn)行：打開瀏覽器，訪問(wèn) http://localhost:3000，如果看到 AI Agent平臺(tái) 的歡迎頁(yè)面，說(shuō)明服務(wù)啟動(dòng)成功。

第四步：接入 Discord，執(zhí)行第一個(gè)自動(dòng)化任務(wù)

現(xiàn)在讓 AI 助手接入 Discord，實(shí)現(xiàn)一個(gè)實(shí)用功能：定時(shí)發(fā)送消息。

4.1 創(chuàng)建 Discord Bot

打開 https://discord.com/developers/applications
點(diǎn)擊 New Application，給它起個(gè)名字，比如 MyAIAssistant
左側(cè)菜單選 Bot → 點(diǎn)擊 Add Bot
點(diǎn)擊 Reset Token，復(fù)制生成的 Token（一會(huì)兒要用）
開啟 Message Content Intent（在 Privileged Gateway Intents 下面）

為什么需要 Message Content Intent？ Discord 出于隱私考慮，默認(rèn)不讓 Bot 讀取消息內(nèi)容。開啟這個(gè)權(quán)限后，Bot 才能"看到"用戶發(fā)的消息，進(jìn)而做出回應(yīng)。

4.2 配置 AI Agent平臺(tái) 連接 Discord

# 把 Discord Bot Token 添加到 AI Agent平臺(tái) 配置
# oc config set 是 AI Agent平臺(tái) 的配置命令
oc config set discord.token "你的Discord Bot Token"

# 設(shè)置要監(jiān)聽的 Discord 頻道 ID
# 頻道 ID 可以在 Discord 里右鍵頻道 → 復(fù)制頻道 ID（需要開啟開發(fā)者模式）
oc config set discord.channel "你的頻道ID"

4.3 創(chuàng)建定時(shí)消息任務(wù)

# 創(chuàng)建一個(gè)定時(shí)任務(wù)配置文件
# cron 表達(dá)式 "0 9 * * *" 表示每天早上 9 點(diǎn)執(zhí)行
oc task create daily-greeting \
  --cron "0 9 * * *" \
  --channel discord \
  --prompt "生成一條簡(jiǎn)短的早安問(wèn)候語(yǔ)，風(fēng)格輕松幽默"

什么是 cron 表達(dá)式？ 這是一種通用的定時(shí)任務(wù)格式。0 9 * * * 的意思是：第0分鐘、第9小時(shí)、每天、每月、每周——也就是每天早上 9:00。常見示例：

*/5 * * * *：每 5 分鐘
0 */2 * * *：每 2 小時(shí)
0 9 * * 1-5：工作日早上 9 點(diǎn)

4.4 啟動(dòng) Discord 集成

# 啟動(dòng) Discord Bot 并激活定時(shí)任務(wù)
oc discord start

看到這個(gè)輸出就成功了：

?? Discord Bot 已連接: MyAIAssistant#1234
? 定時(shí)任務(wù) daily-greeting 已激活
?? 下次執(zhí)行時(shí)間: 明天 09:00

驗(yàn)證一切正常

快速檢查清單：

# 查看 AI Agent平臺(tái) 運(yùn)行狀態(tài)
oc status

# 手動(dòng)觸發(fā)一次定時(shí)任務(wù)（不用等到明天9點(diǎn)）
oc task run daily-greeting

# 查看日志，確認(rèn)消息是否發(fā)送成功
oc logs --tail 20

如果日志里出現(xiàn) ? 消息已發(fā)送到 Discord，恭喜你，整個(gè)流程跑通了。

常見問(wèn)題

Q：?jiǎn)?dòng)時(shí)報(bào)錯(cuò) EADDRINUSE 怎么辦？
端口 3000 被占用了。換個(gè)端口：

oc start --port 3001

Q：Discord Bot 顯示離線？
檢查 Token 是否正確，以及 Message Content Intent 是否開啟。重新設(shè)置：

oc config set discord.token "正確的Token"
oc discord restart

Q：AI 回復(fù)很慢？
可能是 API 服務(wù)商的問(wèn)題。檢查網(wǎng)絡(luò)連接，或者換個(gè) AI 提供商試試：

oc config set ai.provider anthropic
oc config set ai.key "你的Claude API Key"

下一步做什么？

你已經(jīng)完成了 AI Agent平臺(tái) 的基礎(chǔ)部署。接下來(lái)可以探索：

接入更多平臺(tái)：Telegram、Slack、微信（企業(yè)版）
自定義 AI 人格：修改 system prompt，讓助手有獨(dú)特的說(shuō)話風(fēng)格
搭建工作流：用 AI Agent平臺(tái) 的 Workflow 功能，讓 AI 自動(dòng)處理復(fù)雜任務(wù)
本地模型部署：不想花錢用 API？試試接入 Ollama 跑本地模型

相關(guān)資源：

AI Agent平臺(tái) 官方文檔：https://docs.ai-agent.dev
龍蝦社區(qū) Discord：http://www.nhjb.com.cn/discord
更多 AI 工具教程：http://www.nhjb.com.cn/tutorials

有疑問(wèn)歡迎在龍蝦社區(qū)發(fā)帖，社區(qū)里有很多熱心的技術(shù)愛(ài)好者會(huì)幫你解答。

返回首頁(yè)