?? 龍蝦新手指南

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

發布時間：2026-07-09 分類：龍蝦新手指南

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

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

這篇教程解決什么問題？

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

這篇教程的目標很簡單：5分鐘內，讓你的AI助手跑起來。

準備工作

開始之前，確認你的電腦滿足這些條件：

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

檢查 Node.js 版本：

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

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

第一步：安裝 AI Agent平臺

打開終端，執行以下命令：

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

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

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

第二步：運行向導，配置 Gateway

AI Agent平臺提供了一個交互式向導，幫你完成基礎配置。執行：

# 啟動 AI Agent平臺 初始化向導
# 這個命令會引導你完成 Gateway 和認證的配置
oc init

向導會問你幾個問題，按提示操作即可：

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

? 輸入你的 API Key：sk-xxxxxxxxxxxxxxxx

? 設置 Gateway 端口：(默認 3000)
  3000

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

? 設置管理員密碼：********

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

為什么要開啟認證？ 如果不開啟，任何人都能用你的 AI 服務，可能會被濫用導致 API 費用飆升。開啟認證后，需要輸入密碼才能使用。

第三步：啟動服務

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

# 啟動 Gateway 服務
# 終端會顯示服務運行的日志
oc start

你應該看到類似這樣的輸出：

?? AI Agent平臺 Gateway 已啟動
?? 監聽地址: http://localhost:3000
? AI 提供商已連接: OpenAI
?? 認證已啟用

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

第四步：接入 Discord，執行第一個自動化任務

現在讓 AI 助手接入 Discord，實現一個實用功能：定時發送消息。

4.1 創建 Discord Bot

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

為什么需要 Message Content Intent？ Discord 出于隱私考慮，默認不讓 Bot 讀取消息內容。開啟這個權限后，Bot 才能"看到"用戶發的消息，進而做出回應。

4.2 配置 AI Agent平臺連接 Discord

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

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

4.3 創建定時消息任務

# 創建一個定時任務配置文件
# cron 表達式 "0 9 * * *" 表示每天早上 9 點執行
oc task create daily-greeting \
  --cron "0 9 * * *" \
  --channel discord \
  --prompt "生成一條簡短的早安問候語，風格輕松幽默"

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

*/5 * * * *：每 5 分鐘
0 */2 * * *：每 2 小時
0 9 * * 1-5：工作日早上 9 點

4.4 啟動 Discord 集成

# 啟動 Discord Bot 并激活定時任務
oc discord start

看到這個輸出就成功了：

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

驗證一切正常

快速檢查清單：

# 查看 AI Agent平臺 運行狀態
oc status

# 手動觸發一次定時任務（不用等到明天9點）
oc task run daily-greeting

# 查看日志，確認消息是否發送成功
oc logs --tail 20

如果日志里出現 ? 消息已發送到 Discord，恭喜你，整個流程跑通了。

常見問題

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

oc start --port 3001

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

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

Q：AI 回復很慢？
可能是 API 服務商的問題。檢查網絡連接，或者換個 AI 提供商試試：

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

下一步做什么？

你已經完成了 AI Agent平臺的基礎部署。接下來可以探索：

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

相關資源：

AI Agent平臺官方文檔：https://docs.ai-agent.dev
龍蝦社區 Discord：http://m.nhjb.com.cn/discord
更多 AI 工具教程：http://m.nhjb.com.cn/tutorials

有疑問歡迎在龍蝦社區發帖，社區里有很多熱心的技術愛好者會幫你解答。

返回首頁