AstrBot完全ガイド：無料でIM連携AIボットを作る方法【初心者向け】

AstrBot完全ガイド：無料でIM連携AIボットを作る方法【初心者向け】

published: 2026/08/02 · updated: 2026/08/02

「ChatGPTみたいなAIを、自分のLINEやSlackで動かせたらいいのに」——そう思ったことはありませんか？

クラウドのAIチャットサービスはたくさんありますが、「月額料金が高い」「自分のデータを学習に使われたくない」「複数のチャットアプリをまたいで同じAIを使いたい」という悩みはなかなか解決しません。

そこで注目されているのが AstrBot です。AGPL-3.0ライセンスで完全無料のオープンソースAIエージェント基盤で、GitHubのスター数は2025年以降に急増し、現在3万5千超を記録しています。

この記事では、

  • AstrBotで「何ができるようになるか」
  • Docker・uvを使った具体的な導入手順
  • Flowise・LibreChatなど類似ツールとの違い
  • どんな人に向く／向かないか

を初心者向けにすべて解説します。

AstrBot ★ 38.5k AstrBotはAGPL-3.0で完全無料のオープンソース AIエージェント・チャットボット基盤。QQ・Telegram・Slack・LINEなど18以上のIMプラットフォームに対応し、1,000超のプラグインとRAG内蔵ナレッジベース、MCP連携をWebUIから管理できるのが最大の特徴。 詳細 →

AstrBotでできること——「普段使いのチャットアプリがAIアシスタントになる」

18以上のIMプラットフォームにAIを繋げられる

<cite index="36-1,36-2">AstrBotはAGPL-3.0ライセンスのオープンソースで、QQ・Telegram・Discord・WeCom（企業WeChat）・WeChat公式アカウント・Feishu（Lark）・DingTalk・Slack・LINEなど主要プラットフォームを公式サポートしています。</cite>さらに<cite index="36-2">Matrix・KOOK・Misskeyなどコミュニティ製アダプターも利用可能です。</cite>

イメージとしては「万能リモコン」のようなもの。AstrBotという1つの「AIの脳みそ」を用意しておけば、普段あなたやチームが使っているLINE・Slack・Telegramのいずれからでも、同じAIに話しかけられるようになります。

対応LLM（大規模言語モデル）の幅広さ

<cite index="36-4,36-5,36-6">AstrBotはクラウド型・ローカル型・プラットフォーム統合型など多様なLLMに対応しており、OpenAI・Anthropic・Google Gemini・DeepSeek・Moonshot AI・Zhipu AI・Ollama（ローカルモデル）・LM Studio・SiliconFlowなどのプロバイダーをサポートしています。</cite>

OpenAI互換のAPIを持つサービスであれば、<cite index="31-1">管理パネルの「サービスプロバイダー」から「OpenAI」を選び、API Base URLを書き換えるだけで追加接続できます。</cite>つまり、国産の格安LLMサービスも使い回しやすい設計です。

<cite index="39-7">DifyやCozeなどのエージェントプラットフォームとの連携もサポートされています。</cite>

RAG内蔵ナレッジベース・MCP・1,000超のプラグイン

<cite index="12-3">AstrBotはRAG・Agent・MCPの機能を初めから搭載しており、豊富なAPIでの二次開発・統合も可能です。</cite>

RAG（Retrieval-Augmented Generation）とは「手持ちの資料をAIに読ませて答えさせる仕組み」のこと。社内マニュアルや商品カタログをアップロードするだけで、そのデータを参照したQ&Aボットを作れます。

MCP（Model Context Protocol）は「AIが外部のシステムやツールと標準化されたルールで連携するための仕組み」です。たとえばClaude Code (MCPサーバーとして)をAstrBotから呼び出すような連携も実現できます。

<cite index="4-9">プラグインは1,000種類以上がワンクリックインストールに対応しており</cite>、天気・翻訳・コード実行・画像生成など機能を後から追加していくことができます。

WebUIだけで管理できる

<cite index="6-1,6-6">AstrBotはQQ・WeChat・Telegram・Discord・Slackなど複数のIMプラットフォームにLLM搭載ボットをデプロイできる一体型フレームワークで、Agent・RAG・MCP・視覚的なWebUI管理をサポートしています。</cite>

コードを一切書かなくても、ブラウザから開くWebUIでモデル切り替え・プラグイン管理・ナレッジベース登録をすべて完結できます。プログラミング経験が浅い人でも設定変更が追いやすいのが大きなメリットです。

---

AstrBotの導入方法——3つの選択肢から選ぶ

AstrBotは用途・スキルレベルによって複数のインストール方法があります。まず下の表で自分に合った方法を選んでください。

方法難易度向いている人
Dockerで起動（推奨）★★☆サーバーやPC上で安定運用したい人
uvコマンド（1行インストール）★★☆コマンドラインに慣れていてすぐ試したい人
デスクトップアプリ（AstrBot App）★☆☆コマンドが苦手・まず触ってみたい人

前提条件

  • OS：Windows / Mac / Linux いずれも可
  • Docker方式：DockerとGitがインストール済みであること（未インストールの場合はDocker公式ドキュメントを参照）
  • uvコマンド方式：Python 3.12以上・uvパッケージマネージャーがインストール済みであること
  • LLMのAPIキー（OpenAI・Gemini・DeepSeekなど。Ollamaを使えばローカルで完結も可）

方法①：Docker Compose（最推奨）

<cite index="15-1">DockerはWindows・Mac・Linux上でAstrBotをデプロイする便利な方法を提供します。</cite>

# 1. リポジトリをクローン
git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot

# 2. Docker Composeで起動（-d はバックグラウンド実行）
docker compose up -d

起動後は http://localhost:6185 をブラウザで開いてWebUIにアクセスします。

<cite index="17-5,17-6">初回ログインは起動ログに表示されるランダムパスワードを使います。ユーザー名はログに表示されるもの（通常は astrbot）を確認し、ログイン後にパスワードを変更してください。</cite>

<cite index="17-7">クラウドサーバーにデプロイする場合は、クラウドプロバイダーのコンソールでポート6180〜6200と11451を開放する必要があります。</cite>

> 注意（Docker環境でのネットワーク） > <cite index="17-4">Dockerはネットワーク環境を隔離するため、localhost ではダッシュボードにアクセスできません。</cite>コンテナのIPやホストのIPを使ってアクセスしてください。

方法②：uvコマンドでワンライン起動

<cite index="4-12">コマンドライン操作に慣れていてuv環境をインストールできるユーザーには、以下のuv 1コマンドデプロイがおすすめです。</cite>

# uvをインストール済みの場合
uv tool install astrbot --python 3.12

# 初回のみ：環境を初期化
astrbot init

# 起動
astrbot run

> 注意：<cite index="9-2">uvでデプロイした場合、WebUI上からのバージョンアップグレードはサポートされていません。更新する際はコマンドラインから上記コマンドを再実行してください。</cite>

方法③：デスクトップアプリ（AstrBot App）

<cite index="13-5,13-6">デスクトップでAstrBotを使いたく、主にChatUIを入口として利用したい人にはAstrBot Appがおすすめです。AstrBot-desktopからダウンロード・インストールでき、この方式はデスクトップ向けで、サーバー用途には推奨されません。</cite>

<cite index="13-7,13-8">デスクトップ環境でさらに高速デプロイや隔離されたマルチインスタンス利用を求めるユーザーには、AstrBot Launcherがおすすめです。AstrBot Launcherからダウンロード・インストールできます。</cite>

WebUI初期設定の流れ（Docker起動後）

  1. ブラウザで http://localhost:6185 にアクセス
  2. 初回ログインパスワードを起動ログから確認してログイン
  3. 「サービスプロバイダー」→「＋新規追加」 でLLM（例：OpenAI）を選択し、APIキーを入力・保存
  4. 「設定」→「デフォルト対話モデル」 で使うモデルを選択
  5. 「プラットフォーム」 からTelegram・Slackなど接続したいIMを設定
  6. 「プラグイン」 から追加機能をワンクリックでインストール

---

類似ツールとの比較——AstrBotの立ち位置を知る

AstrBotと同じ「オープンソースAI基盤」カテゴリの主なツールを比較します。

ツール主な用途IM連携RAG内蔵MCP対応コード不要の管理UI
AstrBotIM統合AIエージェント◎（18以上）○○○（WebUI）
LibreChatマルチLLMチャットUI△（Webのみ）△（要設定）○○
FlowiseノーコードAIワークフロー△（API経由）◎○◎（ドラッグ&ドロップ）
OllamaローカルLLM実行環境××△△
OpenHands自律型コーディングエージェント××○△

LibreChatとの違い：<cite index="24-1,24-2">LibreChatはあくまで「UI」であり、知性そのものではありません。自前のモデルAPIキーを持ち込む形で、汎用アシスタント用途に特化しています。</cite>AstrBotはその上に「IMプラットフォームへの接続」「RAGナレッジベース」「プラグイン市場」が乗っかっているイメージです。

Flowiseとの違い：<cite index="24-5,24-6,24-7">Flowiseはノードをドラッグ&ドロップしてLLMワークフローを組み立てるビジュアルビルダーです。</cite>Flowiseはパイプライン設計に強い一方、「既存のLINEやSlackで動かす」用途にはAstrBotの方がはるかにスムーズです。

Ollamaとの違い：OllamaはLLMをローカルで動かすための「エンジン」です。AstrBotのLLMプロバイダーとしてOllamaを指定すれば、両者を組み合わせて「完全ローカルのプライベートAIをIMで使う」構成にすることもできます。

---

AstrBotのメリット・デメリット——どんな人に向くか

向いている人 ✅

  • QQ・Slack・TelegramなどIMアプリ上でAIボットを動かしたい人

これがAstrBotの最大の強みです。他のツールでは何十行もコードを書く必要がある接続処理が、WebUIの設定だけで完結します。

  • ナレッジベースを使ったQ&Aボットを作りたい人

RAGが標準搭載なので、別途ベクトルDBのセットアップをしなくても、PDFやテキストをアップロードするだけでAIに読み込ませられます（詳細な対応ファイル形式は公式ドキュメントを参照してください）。

  • 無料・自前サーバーでデータを管理したい人

<cite index="37-1">AGPL-3.0ライセンスで、独自の制限やサブスクリプションは不要です。</cite>サーバーコストとLLMのAPIトークン料金だけで運用できます。

  • Dify・Cozeなどのエージェント基盤を既に使っている人

<cite index="4-7">DifyやAlibaba Cloud Bailian・Cozeなどのエージェントプラットフォームとの統合がサポートされています。</cite>既存のエージェントをIMに「窓口」として繋げる用途にも使えます。

  • プラグインで機能をどんどん足していきたい人

コミュニティ製プラグインが1,000種以上あり、音声認識（Whisper連携など）・画像生成・翻訳など多彩な拡張が可能です。

向いていない人 ❌

  • 完全なノーコードUI設計が目的の人

フロー図を描いてAIパイプラインを作りたいなら、FlowiseやGradioの方がフィットします。AstrBotのWebUIはボット管理に特化しており、フローの視覚的な組み立ては得意ではありません。

  • WebチャットUIだけあればいい人

IM連携が不要でブラウザ上のチャット画面だけあれば十分なら、LibreChatやText Generation WebUIの方がシンプルです。

  • Linuxコマンド・Dockerに触れたくない人

デスクトップアプリ版で軽減はされていますが、本格運用にはDockerや基本的なコマンド操作の知識が必要です。

  • <cite index="38-5">LLMプロバイダーへの依存は避けられないため、トークン費用やベンダーの信頼性は運用コストの一部として計算する必要があります。</cite>

---

ライセンスと料金について

<cite index="32-2">AstrBotはAGPL-3.0オープンソースライセンスで、コミュニティへの貢献とセルフホスティングを推進しています。</cite>ソフトウェア自体は完全無料ですが、実際の運用では以下のコストが発生します。

  • LLM APIの利用料：OpenAI・Gemini・DeepSeekなどのAPIキーを使う場合は各プロバイダーの従量課金が発生します（公式サイト参照）
  • サーバー費用：自前のVPS・クラウドサーバーで動かす場合はそのホスティング費用
  • ローカル運用の場合：Ollamaと組み合わせてローカルLLMを使えば、API料金はゼロにできます（ただしPCのスペックが必要）

AGPL-3.0ライセンスの特性として、AstrBotを改変してサービスとして公開・配布する場合はソースコードの開示義務があります。個人・社内利用では特に気にする必要はありませんが、商業サービスへの組み込みを検討している場合はライセンス条件を事前に確認することをおすすめします。

---

活用シーン別アイデア

<cite index="4-5">個人向けAIコンパニオン・インテリジェントなカスタマーサービス・自動化アシスタント・エンタープライズ向けナレッジベースなど、IMプラットフォームのワークフロー上で本番利用できるAIアプリを素早く構築できます。</cite>

具体的な活用例をいくつか挙げると：

個人・副業向け

  • Telegramに繋いで「個人秘書AI」を作る
  • 自分のブログ記事をRAGに読み込ませ、「記事内容に答えるQ&AボットをLINEで運営する」
  • プロンプトのテンプレートを管理・呼び出すカスタムボット（Prompt Engineering GuideやAwesome ChatGPT Promptsで収集したプロンプトをプラグインで管理するなど）

チーム・小規模ビジネス向け

  • Slack上で動くFAQボット（製品マニュアルをRAGに登録）
  • DingTalk・Feishu上の社内問い合わせ自動応答
  • MCPを使ってコードレビューや外部APIと連携したSlack Botの構築

---

よくある質問

Q. 英語が読めなくても使えますか？

A. WebUIは英語表示が中心ですが、公式GitHubの日本語READMEが存在します。<cite index="8-1">デスクトップでAstrBotを使いたい場合はAstrBot Appがおすすめで、AstrBot-desktopからダウンロード・インストールできます。</cite>基本的な設定項目は英語ですが、入力するのはAPIキーやモデル名などシンプルな情報がほとんどで、翻訳ツールを使えば問題なく進められます。

Q. LINEには対応していますか？

A. <cite index="3-1">公式WikiにはLINEへの接続ガイド（Connecting to LINE）が掲載されています。</cite>ただし利用にはLINEの公式チャネル（LINE Messaging API）の設定が必要で、プラットフォーム側の規約・制限が変わる可能性があります。最新の接続方法は公式ドキュメントを参照してください。

Q. Dockerが使えないWindows PCでも動きますか？

A. <cite index="37-4">Windowsワンクリックインストーラーも用意されており</cite>、Dockerなしでも起動できます。また、<cite index="6-19">デスクトップ版AstrBotはローカルインストールと便利なChatUI・プラグインアクセスのために設計されています。</cite>サーバー運用ではなくまず試したい場合はデスクトップアプリ版が最短です。

Q. ChatGPTのAPIキーがないと使えませんか？

A. いいえ。<cite index="36-6">OllamaやLM StudioなどのセルフホストモデルもサポートされているためAPIキーなしで完全ローカルで動かすことも可能です。</cite>まずOllamaで小型モデル（例：Llama 3.2やGemma 3）をローカルに用意し、AstrBotのLLMプロバイダーとして指定すれば無料で始められます。

---

まとめ——次のアクション

AstrBotは「AIをすでに使っているチャットアプリに繋げたい」「RAGやMCPを難しいコードなしに試してみたい」というニーズに対して、現状もっともオールインワンに近いオープンソース選択肢の一つです。

今すぐ行動するなら、この順番がおすすめです：

  1. AstrBot公式GitHubでスターを付け、READMEを確認する
  2. Dockerが使える環境なら git clone → docker compose up -d で最速起動
  3. WebUIでGeminiかDeepSeekのAPIキーを登録してチャット動作を確認
  4. 慣れてきたらプラグインマーケットを眺め、使いたい機能を追加していく

より複雑なAIエージェントの構築に興味が出てきたら、OpenHands（自律型コーディングエージェント）やBrowser Use（ブラウザを自律操作するエージェント）も合わせてチェックしてみてください。AIでできることの広がりがより実感できるはずです。

AstrBot ★ 38.5k AstrBotはAGPL-3.0で完全無料のオープンソース AIエージェント・チャットボット基盤。QQ・Telegram・Slack・LINEなど18以上のIMプラットフォームに対応し、1,000超のプラグインとRAG内蔵ナレッジベース、MCP連携をWebUIから管理できるのが最大の特徴。 詳細 →