docs: JA docs
This commit is contained in:
crispyberry
4
.gitignore
vendored
4
.gitignore
vendored
@@ -38,6 +38,10 @@ main/mimi_secrets.h
|
|||||||
# Reference repos
|
# Reference repos
|
||||||
nanobot/
|
nanobot/
|
||||||
|
|
||||||
|
# MCP / Memov
|
||||||
|
.mcp.json
|
||||||
|
.mem/
|
||||||
|
.memignore
|
||||||
# OS
|
# OS
|
||||||
.DS_Store
|
.DS_Store
|
||||||
Thumbs.db
|
Thumbs.db
|
||||||
|
|||||||
@@ -5,7 +5,7 @@
|
|||||||
[](https://discord.gg/r8ZxSvB8Yr)
|
[](https://discord.gg/r8ZxSvB8Yr)
|
||||||
[](https://x.com/ssslvky)
|
[](https://x.com/ssslvky)
|
||||||
|
|
||||||
**[English](README.md) | [中文](README_CN.md)**
|
**[English](README.md) | [中文](README_CN.md) | [日本語](README_JA.md)**
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="assets/banner.png" alt="MimiClaw" width="480" />
|
<img src="assets/banner.png" alt="MimiClaw" width="480" />
|
||||||
|
|||||||
@@ -5,7 +5,7 @@
|
|||||||
[](https://discord.gg/r8ZxSvB8Yr)
|
[](https://discord.gg/r8ZxSvB8Yr)
|
||||||
[](https://x.com/ssslvky)
|
[](https://x.com/ssslvky)
|
||||||
|
|
||||||
**[English](README.md) | [中文](README_CN.md)**
|
**[English](README.md) | [中文](README_CN.md) | [日本語](README_JA.md)**
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="assets/banner.png" alt="MimiClaw" width="480" />
|
<img src="assets/banner.png" alt="MimiClaw" width="480" />
|
||||||
|
|||||||
175
README_JA.md
Normal file
175
README_JA.md
Normal file
@@ -0,0 +1,175 @@
|
|||||||
|
# MimiClaw: $5チップで動くポケットAIアシスタント
|
||||||
|
|
||||||
|
[](LICENSE)
|
||||||
|
[](https://deepwiki.com/memovai/mimiclaw)
|
||||||
|
[](https://discord.gg/r8ZxSvB8Yr)
|
||||||
|
[](https://x.com/ssslvky)
|
||||||
|
|
||||||
|
**[English](README.md) | [中文](README_CN.md) | [日本語](README_JA.md)**
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="assets/banner.png" alt="MimiClaw" width="480" />
|
||||||
|
</p>
|
||||||
|
|
||||||
|
**$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](https://t.me/BotFather)に話しかけて作成
|
||||||
|
- **Anthropic APIキー** — [console.anthropic.com](https://console.anthropic.com)から取得
|
||||||
|
|
||||||
|
### インストール
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# まず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に保存され、ビルド時の値より優先されます。
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp main/mimi_secrets.h.example main/mimi_secrets.h
|
||||||
|
```
|
||||||
|
|
||||||
|
`main/mimi_secrets.h`を編集：
|
||||||
|
|
||||||
|
```c
|
||||||
|
#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"
|
||||||
|
```
|
||||||
|
|
||||||
|
ビルドとフラッシュ：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# フルビルド（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ブリッジ）と書かれたポートは使わないでください。間違ったポートに接続するとフラッシュ/モニターが失敗します。
|
||||||
|
>
|
||||||
|
> <details>
|
||||||
|
> <summary>参考画像を表示</summary>
|
||||||
|
>
|
||||||
|
> <img src="assets/esp32s3-usb-port.jpg" alt="USBポートに接続、COMポートではありません" width="480" />
|
||||||
|
>
|
||||||
|
> </details>
|
||||||
|
|
||||||
|
### 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キー](https://brave.com/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](docs/ARCHITECTURE.md)** — システム設計、モジュール構成、タスクレイアウト、メモリバジェット、プロトコル、Flashパーティション
|
||||||
|
- **[docs/TODO.md](docs/TODO.md)** — 機能ギャップとロードマップ
|
||||||
|
|
||||||
|
## ライセンス
|
||||||
|
|
||||||
|
MIT
|
||||||
|
|
||||||
|
## 謝辞
|
||||||
|
|
||||||
|
[OpenClaw](https://github.com/openclaw/openclaw)と[Nanobot](https://github.com/HKUDS/nanobot)にインスパイアされました。MimiClawはコアAIエージェントアーキテクチャを組み込みハードウェア向けに再実装しました — Linuxなし、サーバーなし、$5のチップだけ。
|
||||||
|
|
||||||
|
## Star History
|
||||||
|
|
||||||
|
[](https://star-history.com/#memovai/mimiclaw&Date)
|
||||||
Reference in New Issue
Block a user