discord.py の始め方|Discord Bot を作ってオンラインにするまで【初心者向け】
Python で Discord Bot を作るなら、定番のライブラリが discord.py です。このページでは、Bot アカウントの作成から、トークンの取得、サーバーへの招待、最初のプログラムを動かしてオンラインにするまでを、初めての人でも迷わないように順番に説明します。
準備するもの
- Discord のアカウントと、Bot を入れるための自分のサーバー(テスト用に新しく作るのがおすすめ)
- Python 3.8 以上(3.11 や 3.12 がおすすめ)
- テキストエディタ(VS Code など)
Python が入っているかは、ターミナル(コマンドプロンプト)で次のコマンドを実行すると確認できます。
python --version
1. Discord Developer Portal で Bot を作る
- Discord Developer Portal を開き、右上の「New Application」を押します。
- Bot の名前を入力して作成します(あとから変更できます)。
- 左のメニューから「Bot」を開きます。ここが Bot 本体の設定画面です。
- 「Reset Token」を押してトークンを表示し、コピーしておきます。
2. Bot をサーバーに招待する
- Developer Portal の左メニューから「OAuth2」→「URL Generator」を開きます。
- 「SCOPES」で
botとapplications.commandsにチェックを入れます。 - 「BOT PERMISSIONS」で、必要な権限(最初は「Send Messages」「Read Message History」など)にチェックを入れます。
- 一番下に出る URL をブラウザで開き、招待するサーバーを選んで「認証」します。
権限の選び方は「Bot をサーバーに招待する方法と権限の選び方」で詳しく説明しています。
3. discord.py をインストールする
ターミナルで次のコマンドを実行します。
pip install -U discord.py python-dotenv
python-dotenv は、トークンをプログラムとは別のファイル(.env)に置くために使います。
4. 最初の Bot を書く
作業用のフォルダを作り、その中に2つのファイルを用意します。
# .env
DISCORD_TOKEN=ここにコピーしたトークン
# main.py
import os
import discord
from discord import app_commands
from dotenv import load_dotenv
load_dotenv()
intents = discord.Intents.default()
client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)
@tree.command(name="hello", description="あいさつを返します")
async def hello(interaction: discord.Interaction):
await interaction.response.send_message(f"こんにちは、{interaction.user.mention} さん!")
@client.event
async def on_ready():
await tree.sync() # スラッシュコマンドを Discord に登録
print(f"Logged in as {client.user}")
client.run(os.getenv("DISCORD_TOKEN"))
この例では、/hello と打つとあいさつを返すスラッシュコマンドを作っています。スラッシュコマンドは特権インテントがなくても動くので、最初の一歩におすすめです。
5. 動かしてみる
python main.py
ターミナルに Logged in as Bot名#0000 と表示され、Discord で Bot がオンラインになれば成功です。サーバーのチャットで /hello と打ってみてください(コマンドが出てくるまで、数分かかることがあります)。
よくあるつまずき
ModuleNotFoundError: No module named 'discord'
discord.py がインストールされていないか、別の Python にインストールされています。python -m pip install -U discord.py のように、実行する Python と同じものでインストールしてください。
LoginFailure: Improper token has been passed
トークンが間違っているか、.env が読み込めていません。.env が main.py と同じフォルダにあるか、トークンの前後に余分な空白がないかを確認します。
スラッシュコマンドが表示されない
招待するときに applications.commands のスコープを付けたか確認してください。登録の反映に少し時間がかかることもあるので、Discord を再起動してみるのも有効です。
次のステップ:24時間動かす
PC で動かしている間は、PC を閉じると Bot も止まります。ずっとオンラインにしておきたいときは、24時間動くサーバーで動かしましょう。StellaHost なら、main.py・.env・requirements.txt を置いて「起動」を押すだけで動きます。手順は「Python で作った Discord Bot をサーバーで動かす手順」をどうぞ。
まとめ
- Developer Portal で Bot を作り、トークンを取得する
- OAuth2 の URL Generator で、
botとapplications.commandsを付けて招待する pip install discord.pyでインストールし、トークンは.envに分けて置く- 最初はスラッシュコマンドから始めると、インテントの設定で迷わない
Discord Bot を、月 ¥180 で24時間。
支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →