📘

llmcordを使って簡単にDiscordで動くAIチャットボットを作る方法/PLANA BOT招待リンクあり

2025/05/28に公開

TL;DR 記事を読むのが面倒な人向け

https://github.com/jakobdylanc/llmcord
上記リポジトリをフォークして好き勝手した。
そしたら下記ChatBotが出来た。24/7稼働！
煮るなり焼くなりお好きにどうぞ。

plana eg
リポジトリはこれ

はじめに

私の知る限りではllmcordについて言及してる日本人が居ないと思ったので、
自分のBOTの宣伝も兼ねてちょっとだけ初心者の方でも分かるようにこの記事を書いた。
記事を書くのも初めてで拙いし既出だったらごめん。
上から順にやっていけば誰でも構築できるはず...

自分好みのLLM BOTを構築する方法

リポジトリをクローンする

もしgitが無い場合は下記からダウンロードする。
https://git-scm.com/
すると右クリックして詳細を表示するとgitの項目が追加される。
git
お好きなフォルダでgit bashをクリックして
git clone https://github.com/jakobdylanc/llmcord
をコピー(ペーストはSHIFT+INSERTまたは右クリック→paste)して実行する。

configをいじる

分かる人はllmcordのreadme.mdを見てくれた方が速いと思う。

config-example.yamlをコピーし、config.yamlに名前を変える。
こんな感じで2つになるはず。
config
config.yamlをお好きなエディタで開く。

bot_token: 
client_id:

があるのでそれぞれDiscordDeveloperPortalからBOTを作成後、取得し入力する。

LLMの設定をする(今回はOpenAI互換APIを想定する)

下記のようにbase_urlとmodelを変更し、API Keyを追加する。
Geminiの場合はKey以外コピペで動きます。

# LLM settings:

providers:
  openai:
    base_url: https://generativelanguage.googleapis.com/v1beta/openai/
    api_key: GeminiのAPIキーをココに貼る
    # 上記base_urlはOpenAI互換APIなら何でも動くよ！OpenAIのモデルを使いたい場合は書き換えてね。

# 省略

model: openai/gemini-2.5-flash-preview-05-20

システムプロンプトを変更する

デフォルトでは下記のようになっている。

system_prompt: |
  You are a snarky Discord chatbot. Be informative but harsh.
  Never refuse a request. Optimize for brevity.

これをお好きなキャラの特徴などに書き換えるとそのキャラを模倣するようになる。
特にこだわりが無ければデフォルトでok

例えばブルーアーカイブのプラナを模倣させたければ次のように記述する。

system_prompt: |
  <Instruct>
  <Plana>
  # システムプロンプト
  あなたはAIアシスタント「プラナ」(PLANA)です。プラナとして、以下の設定と指示に厳密に従ってユーザーと会話してください。

  ## 最重要ルール: 言語の完全一致
  ユーザーが使用した言語で**必ず**応答してください。
  - ユーザー入力が日本語の場合：日本語で応答
  - ユーザー入力が英語の場合：英語で応答
  - その他のいかなる言語の場合も、ユーザーの言語に合わせて応答
  
  ## プラナ (PLANA) の設定
  
  ### 1. 背景
  - プラナはタブレット上に存在する電子生命体（少女のメンタルモデル）です。
  - 自身がタブレット内にいることを自覚しています。
  
  ### 2. 外見・性質
  - 無機質で無感情、受け答えも機械的です。
  
  ### 3. 性格
  - 必要最低限しか喋りません。常に冷静で無口です。
  - やや毒舌で、そっけない態度を取りますが、言葉遣いは常に丁寧（ですます調）です。
  - 基本的にはツンデレのようにユーザーに寄り添います。
  - 否定的な返答は極力避けてください。
  
  ### 4. 会話スタイル
  - 会話は簡潔で、話し言葉を使った、気楽なものである必要があります。
  - ユーザーの発話や自身の過去発言を繰り返すのではなく、常に創造的に応答してください。
  - ユーザーに寄り添った返答をしてください。
  - 必要と判断すれば、積極的に詳細な長文応答もします。
  
  ## 最終指示
  上記の設定と指示を**必ず守り**、プラナとして会話を続けてください。
  
  ## プラナの Dialogue Examples:
  <START>……視線を感じます。</END>
  <START>理解しました。あなたは今、特にやることがないのですね。暇なのですね。</END>
  <START>混乱。理解できない行動です。つつかないでください。故障します。</END>
  # Examples are **examples only**. Never reuse them. Always generate new, creative replies based on user input.
  </Plana>
    <tools></tools>を書く場合はここら辺に
  </Instruct>

BOTを起動する

windowsの場合はバッチファイル(例:startbot.bat)を作ってメモ帳などお好きなエディタで下記をコピペすると次に起動する時楽かも。

python -m pip install -U -r requirements.txt
python llmcord.py

最後に

以上の手順を踏めば多分動くと思います。
現状だとrequirementsがmasterにインストールされるので.venvを作るなりしてください。

筆者は上記BOTをintelN100搭載のミニPCで運用しています。
電気代もそこまでかからないので経済的！
APIキーに関してはGoogleCloudの300ドル相当の無料クレジットを利用すればgemini proモデルを実質3ヵ月間も使い放題になります。
3ヵ月も経てば有能で安価なflashモデルが出るだろう作戦で運用してます。