8.2 KiB
MimiClaw: $5チップで動くポケットAIアシスタント
$5チップ上の世界初のAIアシスタント（OpenClaw）。Linuxなし、Node.jsなし、純粋なCのみ。
MimiClawは小さなESP32-S3ボードをパーソナルAIアシスタントに変えます。USB電源に接続し、WiFiにつなげて、Telegramから話しかけるだけ — どんなタスクも処理し、ローカルメモリで時間とともに成長します — すべて親指サイズのチップ上で。
MimiClawの特徴
- 超小型 — Linux不要、Node.js不要、無駄なし — 純粋なCのみ
- 便利 — Telegramでメッセージを送るだけ、あとはお任せ
- 忠実 — メモリから学習し、再起動しても忘れない
- 省エネ — USB給電、0.5W、24時間365日稼働
- お手頃 — ESP32-S3ボード1枚、$5、それだけ
仕組み
Telegramでメッセージを送ると、ESP32-S3がWiFi経由で受信し、エージェントループに送ります — Claudeが思考し、ツールを呼び出し、メモリを読み取り — 返答を送り返します。すべてが$5のチップ上で動作し、データはすべてローカルのFlashに保存されます。
クイックスタート
必要なもの
- ESP32-S3開発ボード（16MB Flash + 8MB PSRAM搭載、例：小智AIボード、約$10）
- USB Type-Cケーブル
- Telegram Botトークン — Telegramで@BotFatherに話しかけて作成
- Anthropic APIキー — console.anthropic.comから取得
インストール
# まずESP-IDF v5.5+をインストールしてください:
# https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/
git clone https://github.com/memovai/mimiclaw.git
cd mimiclaw
idf.py set-target esp32s3
設定
MimiClawは2層設定を採用しています：mimi_secrets.hでビルド時のデフォルト値を設定し、シリアルCLIで実行時にオーバーライドできます。CLI設定値はNVS Flashに保存され、ビルド時の値より優先されます。
cp main/mimi_secrets.h.example main/mimi_secrets.h
main/mimi_secrets.hを編集：
#define MIMI_SECRET_WIFI_SSID "WiFi名"
#define MIMI_SECRET_WIFI_PASS "WiFiパスワード"
#define MIMI_SECRET_TG_TOKEN "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
#define MIMI_SECRET_API_KEY "sk-ant-api03-xxxxx"
#define MIMI_SECRET_SEARCH_KEY "" // 任意：Brave Search APIキー
#define MIMI_SECRET_PROXY_HOST "" // 任意：例 "10.0.0.1"
#define MIMI_SECRET_PROXY_PORT "" // 任意：例 "7897"
ビルドとフラッシュ：
# フルビルド（mimi_secrets.h変更後はfullclean必須）
idf.py fullclean && idf.py build
# シリアルポートを確認
ls /dev/cu.usb* # macOS
ls /dev/ttyACM* # Linux
# フラッシュとモニター（PORTをあなたのポートに置き換え）
# USBアダプタ：おそらく /dev/cu.usbmodem11401（macOS）または /dev/ttyACM0（Linux）
idf.py -p PORT flash monitor
重要：正しいUSBポートに接続してください！ ほとんどのESP32-S3ボードには2つのUSB-Cポートがあります。USB（ネイティブUSB Serial/JTAG）と書かれたポートを使用してください。COM（外部UARTブリッジ）と書かれたポートは使わないでください。間違ったポートに接続するとフラッシュ/モニターが失敗します。
参考画像を表示
CLIコマンド
シリアル接続で設定やデバッグができます。設定コマンドにより再コンパイル不要で設定変更可能 — USBケーブルを挿すだけ。
実行時設定（NVSに保存、ビルド時のデフォルト値をオーバーライド）：
mimi> wifi_set MySSID MyPassword # WiFiネットワークを変更
mimi> set_tg_token 123456:ABC... # Telegram Botトークンを変更
mimi> set_api_key sk-ant-api03-... # Anthropic APIキーを変更
mimi> set_model claude-sonnet-4-5 # LLMモデルを変更
mimi> set_proxy 127.0.0.1 7897 # HTTPプロキシを設定
mimi> clear_proxy # プロキシを削除
mimi> set_search_key BSA... # Brave Search APIキーを設定
mimi> config_show # 全設定を表示（マスク付き）
mimi> config_reset # NVSをクリア、ビルド時デフォルトに戻す
デバッグ・メンテナンス：
mimi> wifi_status # 接続されていますか？
mimi> memory_read # ボットが何を覚えているか確認
mimi> memory_write "内容" # MEMORY.mdに書き込み
mimi> heap_info # 空きRAMはどれくらい？
mimi> session_list # 全チャットセッションを一覧
mimi> session_clear 12345 # 会話を削除
mimi> restart # 再起動
メモリ
MimiClawはすべてのデータをプレーンテキストファイルとして保存します。直接読み取り・編集可能です：
| ファイル | 説明 |
|---|---|
SOUL.md |
ボットの性格 — 編集して振る舞いを変更 |
USER.md |
あなたの情報 — 名前、好み、言語 |
MEMORY.md |
長期記憶 — ボットが常に覚えておくべきこと |
2026-02-05.md |
日次メモ — 今日あったこと |
tg_12345.jsonl |
チャット履歴 — ボットとの会話 |
ツール
MimiClawはAnthropicのtool useプロトコルを使用 — Claudeは会話中にツールを呼び出し、タスクが完了するまでループします（ReActパターン）。
| ツール | 説明 |
|---|---|
web_search |
Brave Search APIでウェブ検索、最新情報を取得 |
get_current_time |
HTTP経由で現在の日時を取得し、システムクロックを設定 |
ウェブ検索を有効にするには、mimi_secrets.hでBrave Search APIキー（MIMI_SECRET_SEARCH_KEY）を設定してください。
その他の機能
- WebSocketゲートウェイ — ポート18789、LAN内から任意のWebSocketクライアントで接続
- OTAアップデート — WiFi経由でファームウェア更新、USB不要
- デュアルコア — ネットワークI/OとAI処理が別々のCPUコアで動作
- HTTPプロキシ — CONNECTトンネル対応、制限付きネットワークに対応
- ツール呼び出し — ReActエージェントループ、Anthropic tool useプロトコル
開発者向け
技術的な詳細はdocs/フォルダにあります：
- docs/ARCHITECTURE.md — システム設計、モジュール構成、タスクレイアウト、メモリバジェット、プロトコル、Flashパーティション
- docs/TODO.md — 機能ギャップとロードマップ
ライセンス
MIT
謝辞
OpenClawとNanobotにインスパイアされました。MimiClawはコアAIエージェントアーキテクチャを組み込みハードウェア向けに再実装しました — Linuxなし、サーバーなし、$5のチップだけ。