2026年如何搭建Discord AI机器人:discord.py(1.6万星)+ 大模型,一步步来
Discord没有内置AI助手,但免费的Bot API + discord.py(16,128星)能让你在30分钟左右给任意服务器加上大模型机器人——支持斜杠命令、私聊,且没有托管费用坑。
💡 你将学到
Discord没有内置AI助手,但免费的Bot API + discord.py(16,128星)能让你在30分钟左右给任意服务器加上大模型机器人——支持斜杠命令、私聊,且没有托管费用坑。
💡 核心要点
- Discord没有内置AI助手,但免费bot API + discord.py(16128星,MIT协议)可以让任何服务器接入LLM机器人。
- 约30分钟即可跑通:在Discord开发者平台创建应用→以正确权限邀请bot→运行一个Python脚本。
- 斜杠命令和私信用同一套代码模式,权限和限流由discord.py处理。
- 运行成本为0:配合本地模型(Ollama)免费使用,或按token调用托管LLM API。
- 最常见的两个报错是401(token错误)和限流(缺少intents),5分钟内即可修复。
直接给结论
discord.py(16,128星,MIT)是Discord官方Bot API最流行的Python封装。机器人本质就是一个用token登录、对消息做出反应的Python进程。接上任意大模型API,你就能在服务器的每个频道里用上AI助手。
第一步 - 在Discord开发者后台创建机器人
- 打开 https://discord.com/developers/applications,点击 New Application。
- 进入 Bot -> Reset Token -> 复制token(保密保存,像密码一样对待)。
- 在 Bot Settings 里开启 Message Content Intent(读取消息必需)。
- 在 OAuth2 -> URL Generator 勾选
bot权限和Send Messages+Use Slash Commands,打开生成的URL把机器人邀请进你的服务器。
第二步 - 安装并运行最小机器人
pip install discord.py
import discord
from discord.ext import commands
bot = commands.Bot(command_prefix="!", intents=discord.Intents.default())
@bot.event
async def on_ready():
print(f"Logged in as {bot.user}")
@bot.command()
async def ping(ctx):
await ctx.send("pong")
bot.run("YOUR_BOT_TOKEN")
运行后在任意频道输入 !ping,应该回复 "pong"。
第三步 - 接上大模型
import os, requests
@bot.command()
async def ask(ctx, *, prompt):
r = requests.post("https://api.deepseek.com/chat/completions",
headers={"Authorization": f"Bearer {os.environ['LLM_KEY']}"},
json={"model": "deepseek-chat", "messages": [{"role": "user", "content": prompt}],
"max_tokens": 500})
reply = r.json()["choices"][0]["message"]["content"]
# Discord消息上限2000字符 - 长回复要拆分
for i in range(0, len(reply), 1900):
await ctx.send(reply[i:i+1900])
现在在服务器里输入 !ask 帮我写一首关于猫的诗 就能用了。想要斜杠命令,用 discord.py 自带的 @app_commands.command() 即可。
为什么"how to"长尾教程对AI博客最重要
搜索 "how to build a discord bot" 的用户离动手只差一步——转化率远高于 "AI bot" 这类宽泛词。步骤式教程还容易被AI搜索引擎当作直接答案引用,因为每一步都是自包含、可引用的。
3个常见坑
- Token泄露 - 不要把token提交到GitHub,用环境变量。
- Message Content Intent没开 - 机器人能跑但永远看不到消息。
- 2000字符上限 - 大模型长回复直接发送会报错,必须拆分。
相关文章
❓ 常见问题
搭建Discord AI机器人需要花钱吗?
不需要。discord.py完全免费(MIT开源),Discord开发者后台创建机器人免费,接DeepSeek等大模型API的免费额度即可运行。唯一成本是如果部署到云服务器需要一台小机器,或者直接用本地电脑挂着。
discord.py和discord.js有什么区别,我该选哪个?
discord.py是Python封装(16,128星,MIT),discord.js是Node.js官方库。按技术栈选:会Python选discord.py,会JavaScript选discord.js。两者功能相同,discord.py的异步模型对接大模型API(async调用)更自然。
机器人能读服务器里的所有消息吗?
只有显式开启Message Content Intent并给机器人对应权限后才能读消息内容;2022年后Discord要求100人以上并通过验证的服务器才能读取消息内容,小服务器需要申请豁免。默认情况下机器人只收到被@提及的事件。
本站文章由编辑人工撰写,收录的工具均经过实测或公开资料核验。文中链接指向工具官网或 GitHub 仓库,仅作信息参考,不构成付费推广。
