🚀 龙虾新手指南

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 跑本地模型