
2026/02/28 9:47
Zclaw ― 888 KiB アシスタント
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
概要:
zclaw は、C で書かれた軽量な ESP32 専用 AI アシスタントです。完全にオンデバイスで動作し、888 KiB のファームウェア予算内に収まります。Telegram やオプションのホスト Web リレーを介して「20 分後にリマインド」「毎日 8:15 に植物に水やり」「GPIO 5 を HIGH に設定」など、自然言語コマンドを受け付け、クラウド接続なしで自律制御が可能です。ファームウェアサイズは慎重に測定されており、フルイメージは 869 KiB(約 850 KiB にパディング済み)です。各コンポーネントのサイズは次のとおりで、複数の ESP32 バリアント(C3、S3、C6)でも制限内に収まります:アプリロジック(約 4 %)、Wi‑Fi/ネットワークスタック(約 46 %)、TLS/暗号化(約 13 %)、証明書バンドルとメタデータ(約 12 %)、その他 ESP-IDF/ランタイム/libc(約 26 %)。マニュアルは、入門、ツール表面、ランタイムアナトミー、セキュリティ&運用、カスタムツール構築、ローカル開発とハッキング、ユースケース、および変更履歴の8章に整理されています。計画されている拡張機能には、Anthropic、OpenAI、OpenRouter、Ollama などの追加 LLM バックエンドへのサポートや Telegram を超える新しいインターフェースオプションが含まれます。低コストのエッジデバイスで AI アシスタントを可能にすることで、zclaw はクラウド依存性の重い自律化を必要としないホビイスト、メーカー、および製造業者に訴求します。
本文
第0章 – 888 KiB アシスタント
zclaw は C 言語で書かれた ESP32 上に実装された AI エージェントです。
Telegram やホストリレーを通じて実用的なアシスタントとして動作し、スケジューリング、GPIO 制御、メモリ管理を行い、ファームウェアのサイズ制限内で運用されます。
zclaw と一緒に楽しむ
「20 分後に知らせて」
「毎日 8:15 に植物に水やり」
「GPIO 5 を HIGH にする」
「オフィスのセンサーは GPIO 4 に接続されていることを覚えておいて」
自然言語で指示すると、zclaw はそれをツール呼び出しへ変換し、ファームウェアがシリコン上でその呼び出しを実行します。
例
あなた: 20 分後にガレージセンサーを確認して エージェント: スケジュール #7 を作成:20 分後にガレージセンサーをチェック
テスト済みのターゲット: ESP32‑C3、ESP32‑S3、ESP32‑C6。その他の ESP32 バリアントも問題なく動作します。
「888 KiB」とは何か
888 KiB はファームウェア全体の容量上限です – アプリロジック + ESP‑IDF/FreeRTOS ランタイム、Wi‑Fi/ネットワークスタック、TLS/暗号化、証明書バンドルオーバーヘッドを含みます。
現在のデフォルト esp32s3 ビルド(
idf.py -B build size-components で合算):
| レイヤ | サイズ | 割合 |
|---|---|---|
zclaw アプリロジック () | 35 742 バイト (~34.9 KiB) | 約4.1% |
| Wi‑Fi + ネットワークスタック | 397 356 バイト (~388.0 KiB) | 約45.7% |
| TLS/暗号化スタック | 112 922 バイト (~110.3 KiB) | 約13.0% |
| 証明書バンドル + アプリメタデータ | 99 722 バイト (~97.4 KiB) | 約11.5% |
| その他 ESP‑IDF/ランタイム/ドライバ/libc | 224 096 バイト (~218.8 KiB) | 約25.8% |
合計イメージサイズ: 869 838 バイト。パディングされた
zclaw.bin は 869 952 バイト(≈849.6 KiB)で、888 KiB の上限を十分に下回ります。
手順はこの順序で読む
- 第1章 – はじめに
ブートストラップのインストール、フラッシュ、プロビジョニング、および最初の正常起動。 - 第2章 – ツアーサーフェス
現在組み込まれているツールとスケジューリング動作(ワンショットジョブを含む)。 - 第3章 – ランタイム構造
タスクモデル、キュー、LLM パス、および実際の制約。 - 第4章 – セキュリティと運用
安全なデフォルト設定、フラッシュ暗号化、および本番環境での取り扱い指針。 - 第5章 – 独自ツールの構築
デザイン、作成、検証、カスタム自然言語ツールの保守方法。 - 第6章 – ローカル開発とハッキング
実際的なローカル反復サイクル、プロビジョニングプロファイル、およびデバッグワークフロー。 - 第7章 – 活用事例
アシスタントが自デバイス上で動く場合にのみ実現可能な有益かつ遊び心のあるアイデア。 - 第8章 – 更新履歴
リリースノートと各バージョンで変更された内容のタイムライン。
プロジェクト概要
- 言語/ランタイム: C + ESP‑IDF + FreeRTOS。
- LLM バックエンド: Anthropic、OpenAI、OpenRouter、Ollama(カスタムエンドポイント)。
- インターフェース: Telegram およびオプションのホスト Web リレー。
- 哲学: 厳格なリソース制限下で有用な自動化を提供すること。