Repolode
memovai

memovai/mimiclaw

$5のESP32-S3チップ上で動作し、Telegram経由で会話できる、純粋なC製のパーソナルAIアシスタントファームウェア。

スター
5,802
フォーク
894
未解決の Issue
111
最終コミット
18 日前

これは何?

MimiClawは、小型のESP32-S3開発ボードをパーソナルAIアシスタントに変えるファームウェアです。デバイスはWi-Fiに接続し、Telegram botを通じてメッセージを受信します。各メッセージはエージェントのループに渡され、LLMはツールを呼び出したり、保存されたメモリを読み込んだりして、返信を送信できます。モデルプロバイダーとしてAnthropic(Claude)とOpenAI(GPT)に対応し、シリアルコンソールから実行中に切り替えられます。

Linux、Node.js、サーバーなしで動作します。メモリ、チャット履歴、設定はSOUL.md、USER.md、MEMORY.mdなどのプレーンテキストファイルとしてボードのフラッシュに保存され、読み取りや編集が可能です。ファームウェアには、AIが定期タスクや単発タスクを作成できるcronスケジューラーと、HEARTBEAT.mdを定期的に確認して未完了の項目に対応するheartbeatサービスが含まれています。

そのほか、ローカルネットワーク上のWebSocketゲートウェイ、Wi-Fi経由のOTAファームウェア更新、HTTP CONNECTプロキシのオプション、TavilyまたはBraveのAPIキーを使ったWeb検索機能も組み込まれています。ビルドにはESP-IDF v5.5以降を使用し、UbuntuとmacOS向けのセットアップスクリプトも用意されています。

主な機能

  • 01LinuxやNode.jsなしでESP32-S3ボード上で動作
  • 02Telegram botを通じてアシスタントとチャット
  • 03AnthropicとOpenAIのモデルに対応し、実行中に切り替え可能
  • 04メモリ、人格、チャット履歴を編集可能なテキストファイルとしてフラッシュに保存
  • 05cronとheartbeatファイルによるスケジュールタスクと定期タスク
  • 06TavilyまたはBraveのAPIキーを使ったWeb検索

ユースケース

  • 余っているマイコンボードで、低消費電力かつ常時稼働するパーソナルアシスタントを動かす
  • 組み込みハードウェア上でLLMエージェントを試す
  • Telegramで配信されるスケジュール通知や日次サマリーを受け取る
  • Cで最小限のReAct形式エージェントループを構築する方法を学ぶ

クイックスタート

  1. 1

    まず ESP-IDF v5.5 以降をインストールします(公式の ESP-IDF ガイドを参照)

  2. 2

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

    git clone https://github.com/memovai/mimiclaw.git
  3. 3

    プロジェクトフォルダーに移動し、ターゲットを ESP32-S3 に設定します

    cd mimiclaw && idf.py set-target esp32s3
  4. 4

    シークレットのテンプレートをコピーし、WiFi、Telegram トークン、API キーを入力してから、USB(JTAG)ポート経由でビルドして書き込みます

    idf.py fullclean && idf.py build

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

  • 16 MB のフラッシュと 8 MB の PSRAM を搭載した ESP32-S3 ボードと、有料の LLM API キー(Anthropic または OpenAI)が必要です。
  • セットアップには ESP-IDF v5.5 以降が必要で、ファームウェアのビルドと書き込みも必要なため、簡単にインストールできるものではありません。
  • チャットには Telegram を使用するため、Telegram ボットと WiFi 接続が必要です。

トピック

よくある質問

mimiclaw とは?
$5のESP32-S3チップ上で動作し、Telegram経由で会話できる、純粋なC製のパーソナルAIアシスタントファームウェア。 MimiClawは、小型のESP32-S3開発ボードをパーソナルAIアシスタントに変えるファームウェアです。デバイスはWi-Fiに接続し、Telegram botを通じてメッセージを受信します。各メッセージはエージェントのループに渡され、LLMはツールを呼び出したり、保存されたメモリを読み込んだりして、返信を送信できます。モデルプロバイダーとしてAnthropic(Claude)とOpenAI(GPT)に対応し、シリアルコンソールから実行中に切り替えられます。
mimiclaw は無料で使えますか?ライセンスは?
mimiclaw は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
mimiclaw は今もメンテナンスされていますか?
活発にメンテナンス中。mimiclaw の最終コミットは 2026年10月4日 です。
mimiclaw は何に使えますか?
余っているマイコンボードで、低消費電力かつ常時稼働するパーソナルアシスタントを動かす 組み込みハードウェア上でLLMエージェントを試す Telegramで配信されるスケジュール通知や日次サマリーを受け取る Cで最小限のReAct形式エージェントループを構築する方法を学ぶ
mimiclaw のインストール方法は?
まず ESP-IDF v5.5 以降をインストールします(公式の ESP-IDF ガイドを参照) リポジトリをクローンします: git clone https://github.com/memovai/mimiclaw.git プロジェクトフォルダーに移動し、ターゲットを ESP32-S3 に設定します: cd mimiclaw && idf.py set-target esp32s3 シークレットのテンプレートをコピーし、WiFi、Telegram トークン、API キーを入力してから、USB(JTAG)ポート経由でビルドして書き込みます: idf.py fullclean && idf.py build
mimiclaw はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/memovai/mimiclaw

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト