tashfeenahmed/scallopbot

これは何？

主な機能

• 01時間とともに減衰・融合・アーカイブされる記憶。想起にはBM25と埋め込みを組み合わせます。
• 02コストを考慮して7つのLLMプロバイダー間でリクエストを振り分け、フェイルオーバーと日次・月次の予算上限にも対応します。
• 03双方向のMCP対応。MCPサーバーを利用できるほか、記憶ツールを他のクライアントに公開できます。
• 04バックグラウンドで夜間に記憶を統合し、自己省察と先回りの不足事項スキャンを実行します。
• 05OpenClawおよびagentskills.io形式のスキルと互換性があり、34個のスキルが付属します。
• 06ローカルでの音声文字起こし・音声合成オプションに加え、アプリとしてインストールできるWebダッシュボードを備えています。

ユースケース

• 自宅のサーバーやRaspberry Piでプライベートな常時稼働アシスタントを動かし、Telegramから利用する。
• MCP経由でチャットアシスタントとClaude Codeなどのコーディングツールの間で、同じ永続的な記憶を共有する。
• 予算上限を設定し、より安価なモデルと高性能なモデルにリクエストを振り分けて、LLMの利用料金を予測可能にする。
• 単なるメモの保存にとどまらないエージェントの記憶設計を試す。

クイックスタート

1. 1

   リポジトリをクローンします

   git clone https://github.com/tashfeenahmed/scallopbot.git
2. 2

   フォルダーに移動して依存関係をインストールします

   cd scallopbot && npm install
3. 3

   .env.example を .env にコピーし、LLM プロバイダーの API キーを1つ以上追加してからビルドします

   npm run build
4. 4

   ボットを起動します。ダッシュボードは http://localhost:3000 で利用できます

   node dist/cli.js start

使う前に知っておきたいこと

• !Node.js 24 以降が必要です。
• !実行には、有料 LLM プロバイダーの API キーが1つ以上必要です。
• !まだ npm レジストリに公開されていないため、クローンからビルドする必要があります。

トピック

よくある質問

scallopbot とは？

生物に着想を得た、記憶を融合・連結し時間とともに忘却するセルフホスト型パーソナルAIアシスタント。MCP経由で利用でき、OpenClawのスキルと互換性があります。 ScallopBotは、自分のサーバー上で動作するパーソナルAIエージェントです。Telegram、Webダッシュボード、CLIのほか、Discord、Slack、WhatsApp、Signal、Matrixなどのチャネルから利用できます。記憶は単一のSQLiteファイルに保存され、BM25によるキーワード検索と埋め込みを組み合わせ、オプションでLLMによる再ランキングも行います。記憶はカテゴリごとに減衰し、要約へと融合されます。実用性の低い項目は、削除前にソフトアーカイブされます。

scallopbot は無料で使えますか？ライセンスは？

scallopbot は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

scallopbot は今もメンテナンスされていますか？

活発にメンテナンス中。scallopbot の最終コミットは 2026年10月16日 です。

scallopbot は何に使えますか？

自宅のサーバーやRaspberry Piでプライベートな常時稼働アシスタントを動かし、Telegramから利用する。 MCP経由でチャットアシスタントとClaude Codeなどのコーディングツールの間で、同じ永続的な記憶を共有する。 予算上限を設定し、より安価なモデルと高性能なモデルにリクエストを振り分けて、LLMの利用料金を予測可能にする。 単なるメモの保存にとどまらないエージェントの記憶設計を試す。

scallopbot のインストール方法は？

リポジトリをクローンします: git clone https://github.com/tashfeenahmed/scallopbot.git フォルダーに移動して依存関係をインストールします: cd scallopbot && npm install .env.example を .env にコピーし、LLM プロバイダーの API キーを1つ以上追加してからビルドします: npm run build ボットを起動します。ダッシュボードは http://localhost:3000 で利用できます: node dist/cli.js start

scallopbot はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/tashfeenahmed/scallopbot