ホーム › 使い方ガイド › discord.py の始め方|Discord Bot を作ってオンラインにするまで【初心者向け】
GUIDE

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 を作る

  1. Discord Developer Portal を開き、右上の「New Application」を押します。
  2. Bot の名前を入力して作成します(あとから変更できます)。
  3. 左のメニューから「Bot」を開きます。ここが Bot 本体の設定画面です。
  4. 「Reset Token」を押してトークンを表示し、コピーしておきます。
トークンは Bot のパスワードと同じです。他人に見せたり、SNS や GitHub に載せたりしないでください。漏れた場合の対処は「トークンが漏れたときの対処」で説明しています。

2. Bot をサーバーに招待する

  1. Developer Portal の左メニューから「OAuth2」→「URL Generator」を開きます。
  2. 「SCOPES」で bot と applications.commands にチェックを入れます。
  3. 「BOT PERMISSIONS」で、必要な権限(最初は「Send Messages」「Read Message History」など)にチェックを入れます。
  4. 一番下に出る 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分で、日本のサーバーが自動で用意されます。 プランを見る →

ほかのガイド

discord.py でスラッシュコマンドを作る方法|引数・選択肢・権限までdiscord.py 2.x でスラッシュコマンドを作る方法を解説。基本の書き方から、引数・選択肢・本人だけに見える返信・管理者限定・defer・すぐに反映させる方法まで紹介します。読む → Discord Bot のトークンが漏れたときの対処法と、安全な管理方法Bot のトークンが漏れたときにすぐやること(再発行・被害確認・権限の見直し)と、.env と .gitignore を使った漏れないための管理方法を解説します。読む → Discord Bot をサーバーに招待する方法と、権限(パーミッション)の選び方OAuth2 の URL Generator で招待 URL を作る手順と、用途別のおすすめ権限、Missing Permissions・Missing Access の対処、ロールの順番の注意点を解説します。読む → Replit で動かしていた Discord Bot をサーバーに引っ越す手順Replit で動かしていた Python の Discord Bot を、keep_alive や Secrets を外して24時間動くサーバーへ引っ越す手順を、つまずきやすい点と一緒に解説します。読む → Discord Bot は VPS と Bot 用ホスティングのどっちで動かす?違いと選び方VPS と Bot 用ホスティングの違いを、必要な知識・手間・料金・自由度で比較。どんな人にどちらが向いているかの目安を紹介します。読む → discord.py で埋め込み(Embed)メッセージを作る方法|色・画像・フィールドまでdiscord.py で Embed を作る方法を解説。タイトル・色・フィールド・画像・フッターの付け方、ローカル画像の使い方、文字数の上限とよくあるエラーを紹介します。読む →