AI Agent平臺 5分鐘快速上手：從零到跑通你的第一個AI助手

這篇教程解決什么問題？

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

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

準(zhǔn)備工作

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

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

檢查 Node.js 版本：

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

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

第一步：安裝 AI Agent平臺

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

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

# 2. 驗(yàn)證安裝成功
# 如果輸出版本號，說明安裝沒問題
oc --version

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

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

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

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

向?qū)柲銕讉€問題，按提示操作即可：

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

? 輸入你的 API Key：sk-xxxxxxxxxxxxxxxx

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

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

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

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

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

第三步：啟動服務(wù)

配置完成后，啟動 AI Agent平臺：

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

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

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

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

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

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

4.1 創(chuàng)建 Discord Bot

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

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

4.2 配置 AI Agent平臺 連接 Discord

# 把 Discord Bot Token 添加到 AI Agent平臺 配置
# oc config set 是 AI Agent平臺 的配置命令
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)建定時消息任務(wù)

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

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

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

4.4 啟動 Discord 集成

# 啟動 Discord Bot 并激活定時任務(wù)
oc discord start

看到這個輸出就成功了：

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

驗(yàn)證一切正常

快速檢查清單：

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

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

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

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

常見問題

Q：啟動時報錯 EADDRINUSE 怎么辦？
端口 3000 被占用了。換個端口：

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ǎng)絡(luò)連接，或者換個 AI 提供商試試：

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

下一步做什么？

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

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

相關(guān)資源：

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

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