無料でDiscordBotを運用できる「Discord Hono」を使ってみた【初学者向け】

#サーバーレスでDiscord Botを常時稼働させるメリット

Discord Botを個人で運用する場合、VPSやクラウドサーバーの常時起動コストが最初の障壁になります。無料枠を利用する方法もありますが、スリープ対策の定期アクセスなどトリッキーな設定が必要になり、維持管理も容易ではありません。

そこで活躍するのが、Cloudflare Workers上で動作する軽量Botライブラリ Discord Hono です。

Discord Hono

Discord Hono へようこそ。Hono にインスパイアされた、軽量で型安全、直感的な Discord ボットフレームワークです。実行時依存関係ゼロでサーバーレス環境に最適化されています。

discord-hono.luis.fun

#従来のサーバー型BotとWebSocketの仕組み

まず、一般的なDiscord Botがどのように動作しているかを簡単に説明します。

従来のBotはWebSocket¹と呼ばれる仕組みを使って、Discordのサーバーと常時接続しています。ユーザーがメッセージを送ったり、コマンドを使ったりすると、その情報がリアルタイムでBotに届き、Botが反応します。

この方式だと、Botは24時間常にプログラムを起動し続けるサーバー²が必要です。これがコストや管理の手間がかかる原因です。

#サーバーレスとCloudflare Workers

#サーバーレスとは

サーバーレス³とは、「サーバーを自分で管理しない」仕組みのことです。サーバーが存在しないわけではなく、クラウドサービス側がサーバーを管理してくれます。プログラムは「リクエストが来たときだけ起動」し、処理が終わると停止します。そのため待機中のコストがかからず、スケーリングも自動で行われます。

#Cloudflare Workersとは

Cloudflare Workers⁴は、Cloudflareが提供するサーバーレス実行環境です。世界中に分散したエッジサーバー⁵上でコードが実行されるため、ユーザーの近くで高速に動作します。無料プランでは1日10万リクエストまで使用できます。

Discord HonoはこのCloudflare Workersで動作するDiscord Botライブラリです。WebSocketによる常時接続の代わりに、HTTP⁶を使ってDiscordからのイベントを受け取ります。

#できること・できないこと

サーバーレス型BotであるDiscord Honoと、従来のサーバー型Botではできることに違いがあります。

	サーバー型Bot	Discord Hono（サーバーレス）
スラッシュコマンドへの返答	✅	✅
ボタン・モーダル等のインタラクション	✅	✅
REST API⁷の利用	✅	✅
Cron⁸による定期実行	✅	✅
VCへの接続（音楽Botなど）	✅	❌
メッセージ監視・自動返答	✅	❌
無料でダウンタイムなし	❌（対策が必要）	✅
大規模スケーリング	コストがかかりやすい	✅

最大のデメリットは、WebSocketを使った常時接続が必要な機能が使えないことです。具体的には以下ができません。

ボイスチャンネルへの接続（音楽Bot、会話Botなど）
メッセージの監視・自動返答（特定ワードへの反応など）
Botのステータス表示のリアルタイム更新

逆に、スラッシュコマンドへの応答・ボタンやモーダルなどのインタラクション・定期実行が中心のBotであれば、Discord Honoで十分実用的に運用できます。

💡 どんなBotに向いている？
「ユーザーがコマンドを打ったら何かしてくれる」という用途がメインのBotに最適です。情報検索・翻訳・ランダム抽選・ゲームサポートなどが挙げられます。

上記のことがしたい場合は素直にサーバーを借りるのが正解です。

#前提

本記事を進めるに当たって、以下のことが必要です。

Discordのアカウントがあること
Cloudflareのアカウントがあること
bun⁹がインストールされていること - bunでなくても、node(npm/pnpm) や deno等でも問題ありません。
VSCodeがインストールされていること - エディタであれば何でも良いです。

#事前準備：Developer Portalでの設定

Discord Botを作るには、まずDiscord Developer Portalでアプリケーションを作成し、トークン¹⁰などを取得する必要があります。

#1. アプリケーションの作成

Discord Developer Portal にアクセスする
右上の「New Application」をクリックする
Botの名前を入力して「Create」をクリックする

新しいアプリケーションの作成

#2. 各種キーの取得

アプリケーション作成後、左メニューの「General Information」を開き、以下の2つを控えておきます。

APPLICATION ID：BotのアプリケーションID
PUBLIC KEY：リクエストの署名検証¹¹に使用するキー

#3. Botトークンの発行

左メニューの「Bot」タブを開く
「Reset Token」をクリックしてトークンを発行する
表示されたトークンをコピーして控えておく

⚠️ 注意
トークンは一度しか表示されません。ページを閉じた後は再確認できないので、必ずコピーして安全な場所に保存してください。

#テスト用Discordサーバーの準備

事前にBotをテストするサーバーを用意してください。そして、そのサーバーのIDをコピーします。

サーバーIDは、ブラウザであればdiscord.com/channels/[server-id]/[channel-id] の形式なので、server-idの部分をコピーしてください。

デスクトップアプリであれば、設定画面から、開発者モードをONにしたうえで、サーバー設定などを確認する場所の一番下にサーバーIDをコピーがあります。

サーバーIDのコピー方法

#プロジェクトのセットアップ

#Cloudflare Workersプロジェクトの作成

bunx create-cloudflare@latest discord-hono-bot
cd discord-hono-bot

いくつか質問されます。以下のように選択してください。

What would you like to start with? → Hello World example
Which template would you like to use? → Worker only
Which language do you want to use? → TypeScript
Do you want to use git for version control? → Yes（任意）
Do you want to deploy your application? → No（後で手動でデプロイします）

続いて、discord-hono と、DiscordのAPIの型を提供してくれるライブラリをインストールします。

bun add discord-hono
bun add -D discord-api-types

#環境変数の設定

プロジェクトルートに .env ファイルを作成し、Developer Portalで控えた値を設定します。このファイルはローカルでのコマンド登録スクリプト実行時に使用します。

DISCORD_APPLICATION_ID=your_application_id
DISCORD_PUBLIC_KEY=your_public_key
DISCORD_TOKEN=your_bot_token
DISCORD_TEST_GUILD_ID=your_test_server_id

.gitignore に .env が含まれているか確認し、含まれていない場合は追記してください。

#wrangler.jsonc確認・編集

wrangler.jsonc¹²を開き、以下のようになっているか確認します。

{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "discord-hono-bot",
  "main": "src/index.ts",
  "compatibility_date": "2026-04-15", // 今日の日付でおｋ!
  "observability": {
    "enabled": true
  },
  "upload_source_maps": true,
  "compatibility_flags": [
    "nodejs_compat"
  ]
}

#package.jsonにスクリプトを追加する

package.json の scripts セクションを以下のように編集します。

{
  "scripts": {
    "dev": "wrangler dev",
    "deploy": "wrangler deploy",
    "register": "bun --env-file=.env src/register.ts"
  }
}

#Botを実装する

#src/index.ts を作成する

src/index.ts がBotのメインハンドラーです。Cloudflare Workersへのリクエストをここで受け取り、コマンドに応じて処理します。まずは /ping に「Pong! 🏓」と返すだけのシンプルな実装から始めます。

import { DiscordHono } from 'discord-hono'

// Cloudflare Workersの環境変数の型定義
type Env = {
  Bindings: {
    DISCORD_TOKEN: string
    DISCORD_PUBLIC_KEY: string
    DISCORD_APPLICATION_ID: string
  }
}

const app = new DiscordHono<Env>()
  .command('ping', (c) => c.res('Pong! 🏓'))

export default app

c.res() はコマンドへの返答メソッドです。文字列を渡すと、その内容がDiscordにメッセージとして送信されます。

名前の通り、かなりhonoに近い書き方なので、honoを知っていれば学習コストも低いでしょう。

Hono - Web framework built on Web Standards

Hono is a small, simple, and ultrafast web framework built on Web Standards. It works on Cloudflare Workers, Fastly Compute, Deno, Bun, Vercel, Netlify, AWS Lambda, Lambda@Edge, and Node.js. Fast, but not only fast.

hono.dev

#src/register.ts を作成する

Discordのスラッシュコマンドは、Discord APIに事前に登録しておく必要があります¹³。src/register.ts として登録用スクリプトを作成します。

import { Command, register } from 'discord-hono'

const commands = [
  new Command('ping', 'Pongと返答します'),
]

register(
  commands,
  process.env.DISCORD_APPLICATION_ID,
  process.env.DISCORD_TOKEN,
)

#コマンドの登録とデプロイ

#コマンドをDiscordに登録する

bun run register

コマンドの登録はDiscord APIへのリクエストです。登録自体はすぐ完了しますが、Discordのクライアントに反映されるまで最大1時間かかる場合があります。

#本番環境の環境変数を設定する

Cloudflare Workersに .env ファイルはそのまま使えません。本番用のシークレット¹⁴は、wrangler secret put コマンドで設定します。

bunx wrangler secret put DISCORD_APPLICATION_ID
bunx wrangler secret put DISCORD_PUBLIC_KEY
bunx wrangler secret put DISCORD_TOKEN

それぞれのコマンドを実行すると、対話的に値の入力を求められます。.env に記載した対応する値を入力してください。

#Cloudflare Workersへデプロイする

bun run deploy

デプロイ¹⁵が完了すると、以下のようなURLが発行されます。

https://discord-hono-bot.your-subdomain.workers.dev

#INTERACTIONS ENDPOINT URLを設定する

Discordはコマンドが実行されると、事前に登録したURL（エンドポイント¹⁶）にHTTPリクエストを送信します。このURLをDeveloper Portalに設定します。

Discord Developer Portalの「General Information」タブを開く
「INTERACTIONS ENDPOINT URL」にデプロイで発行されたWorkerのURLを入力する
「Save Changes」をクリックする

Discordがエンドポイントの疎通確認を行うため、この時点でWorkerが正常に動いていることが重要です。保存に成功すれば、BotがDiscordからのインタラクションを受け取れる状態になります。

#BotをサーバーへInviteする

Discord Developer Portalの「OAuth2」タブを開く
「OAuth2 URL Generator」を選択する
SCOPES で bot と applications.commands にチェックを入れる
生成されたURLをブラウザで開き、招待するサーバーを選択する

招待後、Discordのチャットで /ping と入力すると「Pong! 🏓」と返ってくるはずです 🎉

#実践：ボタンインタラクション付きのダイスコマンド

Discord Honoはボタン等のコンポーネントインタラクション¹⁷にも対応しています。ここでは、「もう一度振る」ボタン付きのダイスロールコマンドを実装してみます。ゲームサーバーなどで実用的に活用できるコマンドです。

#register.ts にコマンドを追加する

import { Command, register } from 'discord-hono'

const commands = [
  new Command('ping', 'Pongと返答します'),
  new Command('dice', 'サイコロを振ります'),  // 追加
]

register(
  commands,
  process.env.DISCORD_APPLICATION_ID,
  process.env.DISCORD_TOKEN,
)

#index.ts を更新する

src/index.ts をボタンインタラクションに対応するよう更新します。

import { DiscordHono, Components, Button } from 'discord-hono'

type Env = {
  Bindings: {
    DISCORD_TOKEN: string
    DISCORD_PUBLIC_KEY: string
    DISCORD_APPLICATION_ID: string
  }
}

// 1〜6のランダムな整数を返す
const rollDice = () => Math.floor(Math.random() * 6) + 1

// ダイス結果のメッセージ（ボタン付き）を生成する関数
const diceResponse = (result: number) => ({
  content: `🎲 **${result}** が出ました！`,
  components: new Components().row(
    new Button('reroll', 'もう一度振る 🎲'),
  ),
})

const app = new DiscordHono<Env>()
  // /ping コマンド
  .command('ping', (c) => c.res('Pong! 🏓'))
  // /dice コマンド：初回はコマンドとして返答
  .command('dice', (c) => c.res(diceResponse(rollDice())))
  // 「もう一度振る」ボタンが押されたとき：メッセージを更新
  .component('reroll', (c) => c.resUpdate(diceResponse(rollDice())))

export default app

コードの要点は次の2点です。

.component() の第1引数（'reroll'）を new Button() の第1引数（カスタムID）と一致させ、ボタン押下時のハンドラーを紐付けています
c.resUpdate() を使うことで、ボタンを押した際に元のメッセージを新しい結果で上書きできます。c.res() では新規メッセージとして連投されてしまうため、resUpdate を活用すると結果がその場で切り替わる自然な操作感になります

#再登録してデプロイする

bun run register
bun run deploy

/dice を実行するとサイコロが振られ、「もう一度振る 🎲」ボタンを押すたびに結果が更新されます。

#まとめ：常時接続が不要ならDiscord Hono一択

Discord Honoを採用することで、インフラの常時稼働コストをかけずにDiscord Botを運用できました。WebSocketによる常時接続を必要としないBotであれば、きわめて合理的な選択肢です。

今回実装したボタンに加え、モーダルやセレクトメニュー、Cronトリガーによる定期実行にも対応しています。さらにCloudflareのD1（SQLデータベース）やKV（Key-Valueストア）と組み合わせれば、データを保持する本格的なWebアプリケーションBotへと容易に拡張できます。ぜひ公式ドキュメントを参照しながら、オリジナルの機能を実装してみてください。