Discord Bot と OpenAI API の作り方 – 開発・デプロイ完全ガイド

2026年4月20日

お得なお知らせ

スポンサードリンク

SNSマーケ本が読み放題

SNS運用の最新ノウハウを月額0円で

Kindle Unlimitedなら「Instagram集客」「X(Twitter)運用」「TikTok攻略」系の書籍が30日無料で読み放題。初月で元が取れます。

Kindle Unlimited 30日無料で試す▶

※無料期間中の解約で料金発生なし

▶ 通勤中に耳で学びたい方は Audible 30日無料体験もおすすめ。SNSマーケ系のオーディオブックが対象作品に多数。

Contents

1 Discord アプリと Bot の作成手順
- 1.1 インテントの有効化
2 OpenAI API キー取得とモデル選択のポイント
- 2.1 取得手順
- 2.2 2026 年時点で注目されるモデル（※予測情報）
  - 2.2.1 実装上のヒント
3 ローカル環境構築とサンプルコード
4 会話履歴の管理例
- 4.1 1. インメモリキャッシュ（Node.js）
- 4.2 2. 永続化（SQLite、Python）
5 Bot の招待・テスト手順
6 Docker 化とホスティング比較
7 .env ファイルとシークレット管理のベストプラクティス
- 7.1 GitHub Actions の例（Docker ビルド＋シークレット注入）
8 トラブルシューティング・FAQ
9 最後に

スポンサードリンク

Discord アプリと Bot の作成手順

Discord Developer Portal（https://discord.com/developers/applications）にサインインし、「New Application」 をクリック。
アプリ名を入力して Create。左メニューの Bot → Add Bot → Yes, do it! で Bot ユーザーが生成されます。
表示された Token と Client ID は、後ほどコードやデプロイ時に環境変数として使用します。トークンは一度しか表示されないので必ず安全な場所に保存してください。

重要：Bot の Token は「機密情報」です。漏洩すると第三者が Bot を乗っ取る危険があります。

インテントの有効化

Message Content Intent と Server Members Intent を必ずオンにし、Save Changes を忘れないでください。
これらは「Privileged Gateway Intents」セクションにあります。インテントが無効だと message.content が空になるなど、期待したデータが取得できません。

参考：Discord 開発者向け公式ドキュメント（https://discord.com/developers/docs/topics/gateway#gateway-intents)

OpenAI API キー取得とモデル選択のポイント

取得手順

https://platform.openai.com/account/api-keys にアクセスし Create new secret key をクリック。
表示されたキーをコピーし、ローカルの .env ファイルに OPENAI_API_KEY=YOUR_KEY と記載します。

2026 年時点で注目されるモデル（※予測情報）

モデル	主な特徴	参考料金*
GPT‑4o	音声・画像入力対応、リアルタイム応答に最適化	約 $0.005 / 1k トークン
GPT‑4 Turbo	高速・低コスト、最大 32k トークンの長文コンテキスト	約 $0.003 / 1k トークン
GPT‑3.5 Turbo	コスト最優先、短い対話向き	約 $0.0015 / 1k トークン

*料金は公式プライシングページ（https://openai.com/pricing) の情報を元にした概算です。実際の価格は利用状況・地域によって変動しますので、必ず最新のプラン表をご確認ください。

実装上のヒント

環境変数 OPENAI_MODEL でモデル名を切り替えられるようにしておくと、将来のアップデートが楽になります。

OPENAI_MODEL=gpt-4o   # デフォルトは gpt‑4o（必要に応じて変更可）

1 2	OPENAI_MODEL=gpt-4o # デフォルトは gpt‑4o（必要に応じて変更可）

ローカル環境構築とサンプルコード

1. Node.js (v20 以上) 環境

# macOS / Linux (Homebrew)
brew install node@20

# Windows (Chocolatey)
choco install nodejs --version=20

node -v   # &gt;= v20.x
npm -v

# macOS / Linux (Homebrew)

brew install node@20

# Windows (Chocolatey)

choco install nodejs --version=20

node -v # >= v20.x

npm -v

必要パッケージ

npm i discord.js@14 dotenv node-fetch

1 2	npm i discord.js@14 dotenv node-fetch

2. Python (3.11) 環境

# macOS / Linux (Homebrew)
brew install python@3.11

python --version   # 3.11.x
pip install py-cord python-dotenv httpx aiosqlite

# macOS / Linux (Homebrew)

brew install python@3.11

python --version # 3.11.x

pip install py-cord python-dotenv httpx aiosqlite

サンプルコード（Node.js）

ポイント
- .env の読み込みは require('dotenv').config() で行う。
- エラーハンドリングとレートリミット対策を組み込んでいる。

// src/index.js
require('dotenv').config();
const { Client, GatewayIntentBits } = require('discord.js');
const fetch = (...args) =&gt; import('node-fetch')
  .then(({ default: fetch }) =&gt; fetch(...args));

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.MessageContent,
    GatewayIntentBits.GuildMessages
  ]
});

client.once('ready', () =&gt; console.log(`&#x1f916; Logged in as ${client.user.tag}`));

/* ---------- レートリミット対策用ラッパー ---------- */
let lastReply = 0;
async function safeReply(channel, content) {
  const now = Date.now();
  if (now - lastReply &lt; 200) await new Promise(r =&gt; setTimeout(r, 200 - (now - lastReply)));
  await channel.send(content);
  lastReply = Date.now();
}

/* ---------- メッセージハンドラ ---------- */
client.on('messageCreate', async msg =&gt; {
  if (msg.author.bot) return;
  if (!msg.content.startsWith('!ai')) return;

  const prompt = msg.content.replace(/^!ai\s*/, '');
  try {
    const res = await fetch('https://api.openai.com/v1/chat/completions', {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.OPENAI_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        model: process.env.OPENAI_MODEL || 'gpt-4o',
        messages: [{ role: 'user', content: prompt }],
        max_tokens: 500,
        temperature: 0.6
      })
    });
    const data = await res.json();
    const reply = data?.choices?.[0]?.message?.content ?? '&#x26a0;&#xfe0f; 応答が取得できませんでした。';
    await safeReply(msg.channel, reply);
  } catch (e) {
    console.error(e);
    await safeReply(msg.channel, '&#x2757; エラーが発生しました。コンソールを確認してください。');
  }
});

client.login(process.env.BOT_TOKEN);

// src/index.js

require('dotenv').config();

const { Client, GatewayIntentBits } = require('discord.js');

const fetch = (...args) => import('node-fetch')

.then(({ default: fetch }) => fetch(...args));

const client = new Client({

intents: [

GatewayIntentBits.Guilds,

GatewayIntentBits.MessageContent,

GatewayIntentBits.GuildMessages

]

});

client.once('ready', () => console.log(`🤖 Logged in as ${client.user.tag}`));

/* ---------- レートリミット対策用ラッパー ---------- */

let lastReply = 0;

async function safeReply(channel, content) {

const now = Date.now();

if (now - lastReply < 200) await new Promise(r => setTimeout(r, 200 - (now - lastReply)));

await channel.send(content);

lastReply = Date.now();

}

/* ---------- メッセージハンドラ ---------- */

client.on('messageCreate', async msg => {

if (msg.author.bot) return;

if (!msg.content.startsWith('!ai')) return;

const prompt = msg.content.replace(/^!ai\s*/, '');

try {

const res = await fetch('https://api.openai.com/v1/chat/completions', {

method: 'POST',

headers: {

Authorization: `Bearer ${process.env.OPENAI_API_KEY}`,

'Content-Type': 'application/json'

body: JSON.stringify({

model: process.env.OPENAI_MODEL || 'gpt-4o',

messages: [{ role: 'user', content: prompt }],

max_tokens: 500,

temperature: 0.6

})

});

const data = await res.json();

const reply = data?.choices?.[0]?.message?.content ?? '⚠️ 応答が取得できませんでした。';

await safeReply(msg.channel, reply);

} catch (e) {

console.error(e);

await safeReply(msg.channel, '❗ エラーが発生しました。コンソールを確認してください。');

}

});

client.login(process.env.BOT_TOKEN);

サンプルコード（Python）

# main.py
import os
import discord
from discord.ext import commands
import httpx
from dotenv import load_dotenv

load_dotenv()
intents = discord.Intents.default()
intents.message_content = True   # 必須インテント

bot = commands.Bot(command_prefix='!', intents=intents)

@bot.event
async def on_ready():
    print(f'&#x1f916; Logged in as {bot.user}')

@bot.command(name='ai')
async def ai(ctx, *, prompt: str):
    headers = {
        &quot;Authorization&quot;: f&quot;Bearer {os.getenv('OPENAI_API_KEY')}&quot;,
        &quot;Content-Type&quot;: &quot;application/json&quot;
    }
    payload = {
        &quot;model&quot;: os.getenv('OPENAI_MODEL', 'gpt-4o'),
        &quot;messages&quot;: [{&quot;role&quot;: &quot;user&quot;, &quot;content&quot;: prompt}],
        &quot;max_tokens&quot;: 500,
        &quot;temperature&quot;: 0.6
    }
    async with httpx.AsyncClient() as client:
        resp = await client.post(&quot;https://api.openai.com/v1/chat/completions&quot;,
                                 headers=headers, json=payload)
        data = resp.json()
        reply = data.get('choices', [{}])[0].get('message', {}).get('content',
                                                                  '&#x26a0;&#xfe0f; 応答が取得できませんでした。')
    await ctx.reply(reply)

bot.run(os.getenv('BOT_TOKEN'))

# main.py

import os

import discord

from discord.ext import commands

import httpx

from dotenv import load_dotenv

load_dotenv()

intents = discord.Intents.default()

intents.message_content = True # 必須インテント

bot = commands.Bot(command_prefix='!', intents=intents)

@bot.event

async def on_ready():

print(f'🤖 Logged in as {bot.user}')

@bot.command(name='ai')

async def ai(ctx, *, prompt: str):

headers = {

"Authorization": f"Bearer {os.getenv('OPENAI_API_KEY')}",

"Content-Type": "application/json"

}

payload = {

"model": os.getenv('OPENAI_MODEL', 'gpt-4o'),

"messages": [{"role": "user", "content": prompt}],

"max_tokens": 500,

"temperature": 0.6

}

async with httpx.AsyncClient() as client:

resp = await client.post("https://api.openai.com/v1/chat/completions",

headers=headers, json=payload)

data = resp.json()

reply = data.get('choices', [{}])[0].get('message', {}).get('content',

'⚠️ 応答が取得できませんでした。')

await ctx.reply(reply)

bot.run(os.getenv('BOT_TOKEN'))

共通 `.env` 例

# .env（ローカル専用、必ず .gitignore に追加）
BOT_TOKEN=YOUR_DISCORD_BOT_TOKEN
OPENAI_API_KEY=YOUR_OPENAI_API_KEY
OPENAI_MODEL=gpt-4o   # 任意で変更可

# .env（ローカル専用、必ず .gitignore に追加）

BOT_TOKEN=YOUR_DISCORD_BOT_TOKEN

OPENAI_API_KEY=YOUR_OPENAI_API_KEY

OPENAI_MODEL=gpt-4o # 任意で変更可

会話履歴の管理例

1. インメモリキャッシュ（Node.js）

const cache = new Map(); // key: channelId, value: [{role, content}, ...]

function addToCache(channelId, role, content) {
  const hist = cache.get(channelId) || [];
  if (hist.length &gt;= 10) hist.shift();          // 最新 10 件だけ保持
  hist.push({ role, content });
  cache.set(channelId, hist);
}

const cache = new Map(); // key: channelId, value: [{role, content}, ...]

function addToCache(channelId, role, content) {

const hist = cache.get(channelId) || [];

if (hist.length >= 10) hist.shift(); // 最新 10 件だけ保持

hist.push({ role, content });

cache.set(channelId, hist);

}

2. 永続化（SQLite、Python）

import aiosqlite

DB_PATH = 'conversations.db'

async def init_db():
    async with aiosqlite.connect(DB_PATH) as db:
        await db.execute('''
            CREATE TABLE IF NOT EXISTS history (
                channel_id TEXT,
                role TEXT,
                content TEXT,
                ts INTEGER
            )
        ''')
        await db.commit()

async def save_message(channel_id, role, content):
    async with aiosqlite.connect(DB_PATH) as db:
        await db.execute(
            &quot;INSERT INTO history (channel_id, role, content, ts) VALUES (?, ?, ?, strftime('%s','now'))&quot;,
            (channel_id, role, content)
        )
        await db.commit()

import aiosqlite

DB_PATH = 'conversations.db'

async def init_db():

async with aiosqlite.connect(DB_PATH) as db:

await db.execute('''

CREATE TABLE IF NOT EXISTS history (

channel_id TEXT,

role TEXT,

content TEXT,

ts INTEGER

)

''')

await db.commit()

async def save_message(channel_id, role, content):

async with aiosqlite.connect(DB_PATH) as db:

await db.execute(

"INSERT INTO history (channel_id, role, content, ts) VALUES (?, ?, ?, strftime('%s','now'))",

(channel_id, role, content)

)

await db.commit()

実装上のベストプラクティス
- 「最新 20 件まで」「1 日以上前は自動削除」など、保持件数・保存期間をコードで明示するとメモリ使用量とコストが抑えられます。
- 会話履歴の総トークン数が 2k を超える場合は古いメッセージから順に削除し、OpenAI のコンテキスト上限を超えないようにします。

Bot の招待・テスト手順

OAuth2 → URL Generator
Scopes: bot, applications.commands
Bot Permissions: Send Messages, Read Message History, Add Reactions（必要に応じて）
生成された URL をブラウザで開き、テストサーバーへ Bot を招待します。
ローカルでコードを起動
bash # Node npm run start # package.json の scripts に "start": "node src/index.js" を設定

# Python python main.py

Discord 上でテストコマンドを実行
!ai 今日の東京の天気は？
返答が表示されれば成功です。

ヒント：コンソールに Gateway 関連のログが出ない場合、インテントが無効化されている可能性があります。ポータルで再度確認してください。

Docker 化とホスティング比較

Dockerfile（Node.js）

# ビルドステージ
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .

# 実行ステージ
FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app .
ENV NODE_ENV=production
CMD [&quot;node&quot;, &quot;src/index.js&quot;]

# ビルドステージ

FROM node:20-alpine AS builder

WORKDIR /app

COPY package*.json ./

RUN npm ci --omit=dev

COPY . .

# 実行ステージ

FROM node:20-alpine

WORKDIR /app

COPY --from=builder /app .

ENV NODE_ENV=production

CMD ["node", "src/index.js"]

Dockerfile（Python）

FROM python:3.11-slim AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

FROM python:3.11-slim
WORKDIR /app
COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY . .
CMD [&quot;python&quot;, &quot;main.py&quot;]

FROM python:3.11-slim AS builder

WORKDIR /app

COPY requirements.txt .

RUN pip install --no-cache-dir -r requirements.txt

FROM python:3.11-slim

WORKDIR /app

COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages

COPY . .

CMD ["python", "main.py"]

主要ホスティングサービス比較

項目	Render	Railway	Fly.io
無料枠	750 h/月（Docker）	$5 クレジット相当/月	3 GB RAM + 160 GB データ転送/月
デプロイ方法	GitHub 連携 → 自動ビルド	CLI `railway up` または GitHub Actions	`flyctl deploy`
リージョン数	US, EU, APAC（数拠点）	US / Europe（2 拠点）	30+ ロケーション（エッジデプロイ可）
水平スケール	手動・自動	プラン単位で水平	秒単位の CPU/RAM 調整が可能
ログ/モニタ	ビルトイン UI	Datadog 連携（有料）	Dashboard + Metrics API

選び方サマリー

低コスト・シンプル → Render の無料枠が最も手軽。
CI/CD 重視 → Railway はプレビュー環境生成が速く、GitHub Actions との相性抜群。
グローバルレイテンシ削減 → ユーザー分散が大きい場合は Fly.io のエッジ配置が有利。

.env ファイルとシークレット管理のベストプラクティス

項目	推奨対策
.gitignore	プロジェクトルートに必ず `/.env` を追加し、リポジトリへのコミットを防止。
ファイル権限	Linux/macOS では `chmod 600 .env`、Windows でも「読み取り専用」かつ暗号化されたフォルダに格納。
Git の履歴削除	誤ってコミットした場合は `git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch .env' --prune-empty --tag-name-filter cat -- --all` で履歴から除去し、GitHub にも Force‑push。
CI/CD のシークレット	GitHub Actions → `Settings > Secrets and variables > Actions`、Render/Railway/Fly.io の「Secret Store」に同様に登録し、`.env` を生成せず環境変数だけで動作させる。
ローカルと本番の分離	本番用は `ENV=production` などフラグを立て、コード内で条件分岐してデバッグ情報や余計なログ出力を抑制する。

GitHub Actions の例（Docker ビルド＋シークレット注入）

name: Deploy to Render

on:
  push:
    branches: [ main ]

jobs:
  build-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Set up Node
        uses: actions/setup-node@v3
        with:
          node-version: '20'

      - name: Build Docker image
        env:
          BOT_TOKEN: ${{ secrets.BOT_TOKEN }}
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          echo &quot;BOT_TOKEN=${BOT_TOKEN}&quot; &gt; .env
          echo &quot;OPENAI_API_KEY=${OPENAI_API_KEY}&quot; &gt;&gt; .env
          docker build -t ghcr.io/${{ github.repository }}:${{ github.sha }} .

      - name: Push image to GitHub Container Registry
        run: |
          echo &quot;${{ secrets.GITHUB_TOKEN }}&quot; | docker login ghcr.io -u ${{ github.actor }} --password-stdin
          docker push ghcr.io/${{ github.repository }}:${{ github.sha }}

name: Deploy to Render

on:

push:

branches: [ main ]

jobs:

build-deploy:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v3

- name: Set up Node

uses: actions/setup-node@v3

with:

node-version: '20'

- name: Build Docker image

env:

BOT_TOKEN: ${{ secrets.BOT_TOKEN }}

OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

run: |

echo "BOT_TOKEN=${BOT_TOKEN}" > .env

echo "OPENAI_API_KEY=${OPENAI_API_KEY}" >> .env

docker build -t ghcr.io/${{ github.repository }}:${{ github.sha }} .

- name: Push image to GitHub Container Registry

run: |

echo "${{ secrets.GITHUB_TOKEN }}" | docker login ghcr.io -u ${{ github.actor }} --password-stdin

docker push ghcr.io/${{ github.repository }}:${{ github.sha }}

注意：上記例はあくまで雛形です。実際の運用では .env ファイル自体をリポジトリに残さず、プラットフォーム側で直接シークレットとして設定することが安全です。

トラブルシューティング・FAQ

質問	回答
Bot が起動しない	1. `.env` が正しく読み込めているか `console.log(process.env.BOT_TOKEN)` で確認 2. Node のバージョンが v20 以上か、Python が 3.11 かチェック
メッセージが送信されない（429 エラー）	Discord のレートリミットは 1 秒あたり最大 5 件程度です。`setTimeout` や先述の `safeReply` ラッパーで間隔を調整してください
OpenAI から「Invalid request」エラーが返る	- モデル名に誤字がないか - `max_tokens` がモデル上限（例：GPT‑4o は 8k）を超えていないか確認
環境変数が本番で反映されない	デプロイ先の「Secrets」設定が正しいか、Dockerfile の `ENV` 行と実行時コマンドで上書きしていないか点検
会話履歴が増えすぎてトークン制限に達する	履歴を 2k トークン以内に切り詰め、古いメッセージは削除するロジック（例：`history = history.slice(-10)`）を実装
.env が外部に漏れたかも	直ちにトークンを再生成し、GitHub の Security > Secret scanning で検出された場合はリポジトリから機密情報を削除し、履歴を書き換えて Force‑push

最後に

本ガイドは 2026 年 4 月時点の情報 に基づいていますが、Discord・OpenAI の仕様は頻繁に更新されます。公式ドキュメント（Discord Developer Docs、OpenAI API Reference）を必ず定期的に確認してください。
セキュリティは 「機密情報の管理」＋「レートリミットとコスト意識」 が鍵です。安全な運用を心がけて楽しい Discord Bot 開発を！ 🚀

スポンサードリンク

お得なお知らせ

スポンサードリンク

SNSマーケ本が読み放題

SNS運用の最新ノウハウを月額0円で

Kindle Unlimitedなら「Instagram集客」「X(Twitter)運用」「TikTok攻略」系の書籍が30日無料で読み放題。初月で元が取れます。

Kindle Unlimited 30日無料で試す▶

※無料期間中の解約で料金発生なし

▶ 通勤中に耳で学びたい方は Audible 30日無料体験もおすすめ。SNSマーケ系のオーディオブックが対象作品に多数。

-Discord

comment コメントをキャンセル

: Discord

Discordのサーバーブーストができない？使い方や機能を解説！

Discordでサーバーのレベルを上げたくてもサーバーブーストのやり方がわからず、困っていませんか？サーバーブーストのやり方をマスターできたらDIscordを機能拡張してより楽しめるようになりますよ ...

: Discord

DiscordのYAGPDBの使い方とコマンドを解説！

Discordで汎用的に使えるBotを探していますか？ YAGPDBなら一通りの汎用的な機能が揃っているのに加え、ソースコードが公開されているので自分で拡張することも可能です。この記事ではDisco ...

: Discord

Discordのステージチャンネルとは？作り方と使い方を解説！

Discordのステージチャンネルについて詳しく知りたいですか？ステージチャンネルをうまく使うことで、TwitterのスペースやClubhouseのようなAMA(Ask me anything)を開 ...

: Discord

2026年版 Discordサーバー収益化の5ステップガイド

本記事では、Discord公式の収益化ポリシーと日本向けサブスクリプション設定、PatreonやBuy Me a Coffeeとの連携方法を具体的に紹介し、税務対策まで網羅します。初心者でもすぐに実践できる3つのステップで安定した副収入を目指しましょう。

: Discord

【入門】DiscordのMEE6の使い方を解説！

みなさんはDiscordの万能botであるMEE6についてご存知でしょうか？ MEE6はこれ一つをDiscordに追加しておくだけで音楽の再生やコミュニティのマネタイズなど幅広い機能を提供してくれます ...

LINE Pay とクレジットカードの手数料比較 2026年最新データ

2024年6月26日 Facebook プライバシーポリシー改定と設定ガイド

Discord Bot と OpenAI API の作り方 – 開発・デプロイ完全ガイド

Discord アプリと Bot の作成手順

インテントの有効化

OpenAI API キー取得とモデル選択のポイント

取得手順

2026 年時点で注目されるモデル（※予測情報）

実装上のヒント

ローカル環境構築とサンプルコード

1. Node.js (v20 以上) 環境

必要パッケージ

2. Python (3.11) 環境

サンプルコード（Node.js）

サンプルコード（Python）

共通 .env 例

会話履歴の管理例

1. インメモリキャッシュ（Node.js）

2. 永続化（SQLite、Python）

Bot の招待・テスト手順

Docker 化とホスティング比較

Dockerfile（Node.js）

Dockerfile（Python）

主要ホスティングサービス比較

選び方サマリー

.env ファイルとシークレット管理のベストプラクティス

GitHub Actions の例（Docker ビルド＋シークレット注入）

トラブルシューティング・FAQ

最後に

共通 `.env` 例