DuDuClaw OS ハードウェア要件と互換性ガイド
DuDuClaw OS は x86-64 の Agent-Native OS です。一般的な市販PC、自作PC、ミニPCで動作し、特別なハードウェアも単体GPUも必要ありません。2015年以降の主流なx86マシンであれば、ほぼ動作します。
本ドキュメントではハードウェアを2つの層に分けて説明します。これは全体を理解するうえで最も重要な枠組みなので、混同しないでください。
- DuDuClaw OS本体を動かせるハードウェア——x86-64 + AVX2(x86-64-v3)+ UEFI + SSD。市販ミニPC、自作PC、さらにはほとんどのx86ノートPCも、この条件を満たせば対応します。
- OSは動かせないが、DuDuClawのエコシステムで明確な役割を持つハードウェア——Raspberry PiのようなARM SBCや、ESP32/Arduinoのようなマイクロコントローラー(MCU)です。これらの役割はセンサーエンドポイントです。DuDuClawのresident sensing(
[[tick.sources]])を通じて、x86ハードウェア上で動くagentにデータを送る側であり、OS本体を動かす側ではありません。
まず「必須要件」(満たさなければ起動しません)を確認し、そのあと用途に応じてスペック早見表や互換性チェックリストを見てください。
- 必須要件
- スペック早見表
- 自作PC互換性チェックリスト
- x86ノートPCの評価
- おすすめの市販ハードウェア
- 既知のドライバー不足
- 非x86ハードウェアとIoTエンドポイント(Raspberry Pi/Arduino/ESP32)
- 二層構成の全体マトリクス
- Mac/ARMエミュレーションで検証できない理由
- 起動メディアの正しい書き込み方
必須要件(3項目、どれか1つでも欠けると起動しません)
Section titled “必須要件(3項目、どれか1つでも欠けると起動しません)”- AVX2に対応したx86-64 CPU(= x86-64-v3ベースライン:AVX、AVX2、BMI1、BMI2、F16C、FMA、LZCNT、MOVBE、OSXSAVE)
- Intel:Haswell(2013年、第4世代Core)以降。Atom系のCeleron/Pentium NシリーズはGracemont(Alder Lake-N、N100/N200/N305など、2023年以降)にならないと対応せず、それより前のGoldmont/Goldmont Plus/Tremont世代はAVX2を持たないことがあります(詳細と確認方法は下の「自作PC互換性チェックリスト」を参照)。
- AMD:Excavator(2015年、モバイル向けAPU)以降、続くZen/Zen+/Zen 2/Zen 3/Zen 4/Zen 5(2017年以降)はすべて対応しています。それより前のBulldozer/Piledriver/Steamroller世代(FXシリーズのデスクトップ機、一部のAPU、2011〜2014年)は「x86-64」を名乗っていてもAVX2/BMI2に対応していません。
- ❌ arm64は非対応です:Apple Silicon Mac、Raspberry Pi、ARMミニPCなどが含まれます。OS imageはx86-64向けにビルドされているため、ARMマシン(またはARM MacでのUTM/QEMUエミュレーション)では起動しないか、動いても極端に遅く、サポート対象の経路ではありません。
- UEFI起動(2012年以降のマザーボードにはほぼ搭載されています)
- A/Bアトミック更新とsystemd-bootはUEFIに依存しています。従来のBIOS-onlyマシンは非対応です。
- Secure Bootは現時点ではオフでも構いません(自己署名チェーンはまだ必須化されていません)。
- SSD(A/B更新とgpuiデスクトップはどちらもI/Oに敏感です。HDDだと動作がもたつきます)
スペック早見表
Section titled “スペック早見表”| 項目 | 最低 | 推奨 | 快適(ゲーム/ローカルLLM) |
|---|---|---|---|
| CPU | x86-64-v3(AVX2必須):Intel Haswell以降 / AMD Excavator以降 | Intel N100 / N305、AMD Ryzen 5 | AMD Ryzen 7 8845HS |
| メモリ | 4 GB | 8 GB | 16 GB以上 |
| ストレージ | 64 GB SSD | 128 GB SSD | 256 GB以上のSSD |
| ディスプレイ/GPU | 単体GPU不要(内蔵GPUで十分) | 内蔵GPU | 内蔵GPU/単体GPU |
| ファームウェア | UEFI | UEFI | UEFI |
| ネットワーク | 有線またはWi-Fi(iwd) | — | — |
なぜ単体GPUが不要なのか。 DuDuClaw OSは現時点でllvmpipeによるソフトウェアレンダリング(CPUがデスクトップを描画します)を採用しています。これが市販ハードウェアに特にやさしい理由です——単体GPUを持たない最安のミニPCでも、フルのグラフィカルデスクトップが動きます。内蔵GPU/単体GPUがあるのは将来のハードウェアアクセラレーションのための余地であり、必須ではありません。
自作PC互換性チェックリスト
Section titled “自作PC互換性チェックリスト”自作PC(DIYで組み立てたマシン)は、上記の必須要件を満たせば対応します。「認証リスト」のようなものは存在しません——ただし実際の組み立てではいくつかよくある落とし穴があるので、1つずつ確認してください。
| チェック項目 | 通過条件 | よくある落とし穴 |
|---|---|---|
| マザーボード/チップセット | Intel 8シリーズチップセット(LGA1150、Haswell対応)以降、またはAMD AM4/AM5(2017年以降)。マザーボード自体にUEFIが搭載されている必要があります | 古すぎるBIOS-onlyの旧型ボード(2012年以前)は完全に非対応です |
| CPU | 上記「必須要件」のIntel/AMD世代表を参照 | 中古の古いAMD FX(Bulldozer/Piledriverシリーズ)、古いNASでよく使われる低価格帯のAtom/Celeron Jシリーズ(Bay Trail/Cherry Trail/Goldmont世代)はAVX2を持たないことがあり、「x86-64」であっても起動しません。購入前に必ずlscpuかCPU-Zでflagsにavx2が含まれるか確認してください——CPUのブランドや発売年だけで判断しないこと |
| GPU | 単体GPU不要(llvmpipeソフトウェアレンダリング) | 単体GPU(NVIDIA/AMD/Intel Arc)があっても問題は起きませんが、現時点では自動的にアクセラレーションには使われません——将来のための余地があるだけです |
| 有線NIC | Intel(I219/I225/I226など)、Realtekの主流チップ(RTL8111/8168シリーズ)はLinuxのサポートが成熟しています | RTL8125(2.5GbE):カーネル内蔵のr8169ドライバーに基本的なサポートはマージされていますが、コミュニティからはRealtek公式のout-of-tree r8125 DKMSに比べて安定性が劣るという報告が繰り返し寄せられています(Arch Linuxフォーラム)。選定時は避けるか、DKMSモジュールを事前に用意しておいてください |
| Wi-Fi NIC | Intel AXシリーズ、MediaTekのmt7921/mt7925シリーズはメインラインのサポートが良好です |
MT7927(Wi-Fi 7チップ):確認時点でもメインラインドライバーが存在せず、mt7925eはそのPCI IDへのバインドを明確に拒否します。コミュニティはmediatek-mt7927-dkmsのようなout-of-treeパッケージで補うしかありません(jetmブログ)。購入前にlspci -nnでM.2カードの実際のチップを確認してください。マザーボードのスペック表だけを信じないこと |
| ストレージ | NVMeまたはSATA SSDのどちらでも可 | HDDは動作がもたつきます(A/B更新とデスクトップの両方がI/Oに敏感なため)。推奨しません |
| 起動モード | マザーボードのBIOS/UEFI設定内で「Boot Mode」をUEFIに設定する必要があります(CSM/Legacyではなく) | 多くのマザーボードは出荷時にCSM互換モードがオンになっているため、手動で純粋なUEFIに切り替える必要があります。「Fast Boot」/「Ultra Fast Boot」オプションはUSB起動メニューをスキップすることがあるため、USB起動メディアを焼く前にオフにしておくことを推奨します |
| Secure Boot | オン/オフどちらでも可 | 自己署名チェーンはまだ必須化されていませんが、一部のマザーボードは出荷時にオンになっています。起動に失敗する場合は、まずBIOSでオフにして切り分けてください |
x86ノートPCの評価
Section titled “x86ノートPCの評価”技術的には、必須要件(x86-64 + AVX2 + UEFI + SSD)を満たすノートPCであればDuDuClaw OSは動作します——ただしDuDuClaw OSは現時点でノートPCに特化した互換性検証を行っていません(applianceプロジェクトが対象とするハードウェアはデスクトップのミニPCです。下記のおすすめハードウェアを参照)。以下はLinuxノートPCサポートに関する一般的な既知のリスクであり、DuDuClawによる実機検証の結果ではありません。
- 電源管理/ACPI:バッテリー持続時間、ファンカーブ、蓋を閉じたときのサスペンドなどの挙動は、メーカー独自のACPIパッチが必要になることが多いです。コミュニティのサポートが手厚いブランド(ThinkPad、Tuxedoなど)はリスクが低く、ゲーミング機や超薄型モデルはリスクが高くなります。
- Wi-Fi/Bluetooth:ノートPCはデスクトップのM.2カードとは異なる型番のMediaTek/Qualcomm/Realtek専用モジュールを内蔵していることが多く、MT7927のようなメインラインドライバーの欠落に当たる可能性が同様にあります。起動後は必ず
lspci -nnで確認してください。 - タッチパッド:近年のPrecision Touchpad(I2C HID)は最近のカーネルでサポートが成熟しています。古いPS/2エミュレーション方式のタッチパッドはジェスチャーやマルチタッチが不完全な場合があります。
- Secure Boot:ほとんどのOEMノートPCは出荷時にオンになっているため、USB起動でインストールするにはBIOS/UEFIに入って自分でオフにする必要があります。
- タッチスクリーン、指紋認証、HDRパネルなどの高度な機能はDuDuClaw OSの設計対象外であり、動作は保証されません。
結論:ノートPCでDuDuClaw OSを動かすことは技術的には可能ですが、「自己責任で検証する」レベルのものです——唯一のシステムドライブを直接上書きせず、まずUSB起動で試してみることを推奨します。
おすすめの市販ハードウェア(そのまま買えるもの)
Section titled “おすすめの市販ハードウェア(そのまま買えるもの)”| クラス | 機種例 | 説明 |
|---|---|---|
| 💰 予算重視 | Intel N100ミニPC(Beelink/GMKtec、約NT$4,000〜6,000) | ファンレスで省電力。デスクトップ用途+オフィスワーク+ネット閲覧には十分 |
| ⚖️ バランス型 | Beelink SERシリーズ(Ryzen)、Intel NUC | 性能と価格のバランスが良い |
| 🎯 ターゲット機種 | Intel N305/AMD Ryzen 8845HSミニPC | プロジェクトが対象とするハードウェア。ゲーム/ローカルLLMもより余裕を持って動きます |
既知のドライバー不足(選定時に避けるもの)
Section titled “既知のドライバー不足(選定時に避けるもの)”以下のハードウェアは現時点でドライバーサポートが不十分です。選定時に避けるか、互換性のあるNICをもう1枚予備で用意してください。
- MT7927 Wi-Fi 7チップ——確認時点でもメインラインドライバーは存在しません。
mt7925eはそのPCI IDへのバインドを拒否しており、唯一の解決策はコミュニティ製のDKMSパッケージを事前に用意しておくことです(jetmブログ、GitHub)。これは「自分でカーネルをメンテナンスするかどうか」とは無関係です——ディストリビューションの標準パッケージを使っても同様に認識されません。上流にまだドライバー自体が書かれていないためです。 - RTL8125 2.5G有線NIC——カーネル内蔵の
r8169には基本的なサポートがすでにマージされています(LKML)が、複数のコミュニティ報告でRealtek公式のout-of-treer8125DKMSより安定性が劣るとされています(Archフォーラム)。マージされた正確なバージョン番号と現在の安定性の差については信頼できる一次情報源が見つかりませんでした。未検証として明記します。実機でのテストが必要です。
購入前にマザーボード/ミニPCが使用しているネットワークチップの型番を確認し(lspci -nn)、上記2つのチップを避けるか、少なくとも追加でDKMSモジュールが必要になる可能性を頭に入れておくことをおすすめします。
非x86ハードウェアとIoTエンドポイント(Raspberry Pi/Arduino/ESP32)
Section titled “非x86ハードウェアとIoTエンドポイント(Raspberry Pi/Arduino/ESP32)”このセクションで扱うハードウェアはすべてDuDuClaw OS本体を動かせません。しかしそれは役に立たないという意味ではありません——DuDuClawのエコシステムにおいて明確な第二層の役割、すなわちセンサーエンドポイントを担っています。
Raspberry Pi
Section titled “Raspberry Pi”なぜDuDuClaw OSを動かせないのか:Raspberry Pi 4はCortex-A72、Raspberry Pi 5はCortex-A76を採用しており、どちらも64bitのARMv8-A(aarch64/arm64)アーキテクチャであり、x86-64ではありません(Raspberry Pi 5のスペック、Wikipediaでクロスチェック済み:4コアのCortex-A76 @ 2.4GHz、RAMは1/2/4/8/16GBから選択可)。DuDuClaw OS imageは純粋にx86-64向けにビルドされています。これは命令セットの非互換性であり、ドライバーの欠落ではありません——「Apple Silicon Macで起動できない」(下記セクション参照)のとまったく同じ理由です。ソフトウェアの更新では解決できず、ARM64向けのimageを別途ビルドするしかありません。
Raspberry Piの起動の仕組みもx86 PCとは異なります。デフォルトではBroadcom独自のクローズドソースGPUファームウェア+device-treeによる起動フローを使っており、標準的なPCのような内蔵UEFIを持ちません(Pi 4/5にはオプションのRaspberry Pi UEFIファームウェアを導入できますが、それは別プロジェクトであり、標準搭載ではありません)。これは「将来ARM64ビルドを出すかどうか」を検討する際に重要なポイントです。
将来ARM64ビルドを出す場合のコスト評価(誠実に作業項目を列挙します。架空の工数は出しません):
- この道はゼロからのスタートではありません——DuDuClawの旧版(現在は凍結済み)のDebian/mkosi appliance構築パイプラインには、もともと
APPLIANCE_ARCH=arm64という「smoke-build」経路が存在していました(appliance/mkosi.conf.d/10-arch-arm64.conf)。しかしその経路の用途は「Apple Silicon上でのローカルビルド+QEMUによるスモークテスト」と明記されており、そのファイル自体にも「x86-64 remains the shipping target」と注記されています——つまり使っているのは汎用のarm64 Debianカーネルであり、実機のARMハードウェア(ましてやRaspberry Pi)で起動検証されたことは一度もありません。「Raspberry Piをサポートする」こととは別の話です。 - 現在の主力ビルドパイプライン(Yocto/
meta-duduclaw)は完全にx86-64向けのmachine設定(duduclaw-genericx86-64.conf/duduclaw-qemux86-64.conf)しか持っておらず、arm64やRaspberry Pi専用のmachine定義はまだ存在しません。 - 実際にRaspberry Piをサポートするとなると、作業量はおおよそ次のブロックに分かれます。①まったく新しいYocto machine BSP(Yoctoエコシステムには
meta-raspberrypiのような上流BSPレイヤーがすでにあり出発点にはなりますが、本プロジェクトのimage/更新パイプラインへの統合はこれから必要です)②Raspberry Pi専用の起動チェーン——標準的なUEFIがないため、別途Pi UEFIファームウェアを使うかU-Bootに切り替える必要があり、既存のUEFI+systemd-bootによるA/Bデュアルスロット更新設計がこの経路に適用できるか再検証が必要です③グラフィックススタック(現状x86-64ではllvmpipeソフトウェアレンダリング)をaarch64上で一連のチェーンごと再検証する必要があります④x86-64-v3向けのCPUチューニングはARMにはまったく適用できないため、独立したtune/sstateキャッシュを新設する必要があり、ビルドマトリクスがそのまま倍増します⑤「快適」ティアの目玉であるSteam/ゲーミング用途はARM Linuxでは公式サポートがなく、この機能自体を丸ごと外すことになります⑥Raspberry Pi専用のBroadcomディスプレイ/Wi-Fiファームウェアとドライバーは別途調査・統合が必要です。 - 全体として「新しいプラットフォームターゲットを1つ丸ごと追加する」規模の工数であり、「ビルドオプションを1つ追加する」規模ではありません。正確な工数を出せる信頼できる根拠がないため、ここではあえて作業項目だけを列挙し、架空の数字は出していません。
DuDuClawのエコシステムにおけるRaspberry Piの正しい位置づけ:標準的なLinux(Raspberry Pi OS、Debian arm64など)を動かし、エッジagentノードまたはIoTゲートウェイとして使います——Raspberry Pi上に小さなサービスを書いてセンサー/GPIO/カメラの状態を読み取り、HTTPで公開し、x86ホスト上で動くDuDuClaw gatewayが[[tick.sources]]経由でそのデータを取り込みます(実際の接続方法は下記「センサーエンドポイントをDuDuClawのresident sensingにつなぐ方法」と同じで、LANのプライベートIPに関する制限も含みます)。複数のArduino/ESP32(BLE/LoRa/Zigbeeなどの近距離プロトコル経由)を集約するノードとしても適しており、外部に提供するエンドポイントを1つにまとめることで、DuDuClaw側が管理するソース数を減らせます。
Arduino/ESP32
Section titled “Arduino/ESP32”なぜマイクロコントローラー(MCU)であり、OSを動かせるコンピューターではないのか:
- Arduino Uno:中核チップはATmega328Pで、8bitのMCUです。2 KBのSRAM、32 KBのフラッシュ、16 MHz(Arduino公式ドキュメント)。これは純粋なマイクロコントローラーであり、「軽量なLinuxを1つ動かすことすら不可能」です——これはアーキテクチャの非互換性の問題ではなく、リソースレベルの問題です。仮にx86命令セットに置き換えたとしても、2KBのメモリでは現代的なOSはどれも動きません。
- ESP32:Xtensa LX6(一部の新しいモデルはLX7またはRISC-V)、多くはデュアルコアで240MHz、内蔵SRAMは型番によって約256〜768 KiB(オリジナルのESP32は520 KiB)、MMUなし(Wikipedia、ESP32)。ネイティブではFreeRTOSかベアメタル(ESP-IDF SDK)しか動かず、Linuxには対応していません——新しいモデルでPSRAMを追加して数MBまで拡張しても、現代的なLinuxデスクトップ環境が必要とするメモリ量とMMUによる仮想メモリ管理には遠く及びません。
両者に共通する正しい位置づけはセンサーエンドポイントです——Wi-Fi(ESP32はネイティブ対応)または追加のネットワークモジュール(Arduinoはよく ESP8266/ESP32拡張ボードと組み合わせます)でセンサー値を送信し、上位のデバイス(Raspberry Piやx86ホスト)がそれを取得・受信します。
センサーエンドポイントをDuDuClawのresident sensingにつなぐ方法
Section titled “センサーエンドポイントをDuDuClawのresident sensingにつなぐ方法”誤解されやすいがコードから直接読み取れる(crates/duduclaw-gateway/src/tick_config.rs/tick_source.rs/tick_source_poll.rs/tick_source_ws.rs)アーキテクチャ上の制約を、印象ではなくまず明確にしておきます。
http_pollとwebsocket(loopback以外)はどちらもweb_fetch::validate_urlというSSRFゲートを通過します。プライベートアドレス帯のIP(192.168.x.x/10.x.x.x/169.254.x.xなど)はその場で拒否されます——tick_config.rsのテストssrf_urls_disable_the_sourceは、http://192.168.1.10/xのようなアドレスが必ず拒否されることを明示的に検証しています。つまりDuDuClaw gatewayは、家庭やオフィスのLAN内に置かれたESP32を直接http_pollすることができません——これは意図的なセキュリティ境界であり、バグや欠陥ではありません。websocketというtick kindの本質はWSクライアントであり、自分から能動的に接続しに行くものです。WSサーバーではありません(tick_source_ws.rsのconnect_sourceを参照)。したがって「ESP32が能動的にDuDuClawへプッシュする」という直感的な説明は正確ではありません——正しくは「DuDuClawがESP32(または何らかのrelay)が開いているWSサーバーへ接続しに行き、接続後はいつフレームをプッシュするかを相手側が決める」という形です。しかもloopback以外のwss://も同様に上記のSSRFゲートを通過するため、LANのプライベートIPは同じように遮断されます。
したがって、LAN内のIoTデバイスを実務的に接続する合法な方法は3通りあります:
command(config.tomlで[tick] allow_command_sources = trueを先に有効化する必要があり、デフォルトはオフでfail-closedです):operatorが自分で書いたargv(例えばcurlやセンサーAPIを呼び出すスクリプト)にLANデバイスへアクセスさせます——このサブプロセスのネットワーク呼び出しは、tick_source自身のSSRFゲート(このゲートはhttp_pollブランチにしか適用されません)を経由しないため、プライベートIPに合法的にアクセスできます。現時点で最も直接的なLANセンサー接続方法です。file_tail:DuDuClaw gatewayを動かしているホスト上に別途cron/systemdタイマーのスクリプトを組み、定期的にLANデバイスのAPIを呼び出し、結果を1行ずつのJSONとしてローカルのログファイルにappendします。file_tailはファイルを読むだけでネットワークにはいっさい触れないため、当然SSRFゲートの制限を受けません。websocket+ローカルrelay(loopback):gatewayと同じホスト上に小さなrelayサービスを別途立てます(ESP32のMQTT publishを受け取る、または逆にポーリングする)。relay自身がws://127.0.0.1:PORTでWSサーバーを開き、DuDuClawのwebsockettick sourceがそのloopbackアドレスへ接続します——これはコードのコメントに明記されている「documented local-relay path」という設計意図そのものです。
実例:ESP32温湿度センサー → tick → autopilotによる自動反応
-
ESP32にDHT22を接続し、ファームウェアに極小のHTTPサーバーを実装します。
GET /sensorは{"temp":32.1,"humidity":58}を返します。 -
gatewayホスト上にcronスクリプトを組み(1分ごとに実行)、
command/file_tailのいずれかの経路でこのAPIにアクセスします。file_tailを使う場合:ターミナルウィンドウ # cron:1分ごとに読み取った値をログにappendするcurl -s http://192.168.1.50/sensor >> /var/log/duduclaw/esp32-temp.jsonlecho >> /var/log/duduclaw/esp32-temp.jsonl -
config.tomlの設定:[tick]enabled = true[[tick.sources]]id = "esp32-temp"kind = "file_tail"path = "/var/log/duduclaw/esp32-temp.jsonl"json_fields = { temp = "/temp", humidity = "/humidity" }(外部cronを省いてDuDuClaw自身に取得させたい場合は、代わりに
commandを使います:kind = "command"、command = ["curl", "-s", "http://192.168.1.50/sensor"]、interval_secs = 60とし、[tick]にallow_command_sources = trueを追加します。) -
新しい行が入るたびに、DuDuClawは
{temp, humidity}にprev_temp/delta_temp/pct_tempを自動的に付加し、AutopilotEvent::Tick{source:"esp32-temp", fields:{...}}としてbroadcastします(純粋にRust側での処理で、LLMコストはゼロです)。 -
autopilotのルールはそのまま次のように書けます:
{"trigger_event": "tick","conditions": {"all": [{ "field": "source", "op": "eq", "value": "esp32-temp" },{ "field": "temp", "op": "gt", "value": 30 }]},"action": {"type": "notify","channel": "telegram","chat_id": "...","text": "機房溫度 {temp}°C 超過 30 度,請檢查空調"}}
温度が閾値を超えるとagentが自動でメッセージを送信します——これこそがresident sensingの設計思想です:System 1(安価で常駐し、決定論的なRustのルール)がフィルタリングを担当し、System 2(クラウドagent)はルールがヒットしたときだけ起こされます。本当に判断が必要になるまでLLMは呼び出されません。
二層構成の全体マトリクス
Section titled “二層構成の全体マトリクス”第1層:DuDuClaw OS本体を動かせるハードウェア(x86-64ハードウェア)
Section titled “第1層:DuDuClaw OS本体を動かせるハードウェア(x86-64ハードウェア)”| ハードウェアクラス | サポート状況 | エコシステムでの役割 |
|---|---|---|
| 自作x86 PC(Intel Haswell以降/AMD Excavator以降、UEFI、SSD) | ✅ 完全対応 | ホスト/OS本体 |
| x86市販ミニPC(N100/N305/8845HSなど) | ✅ 完全対応、推奨ティア | ホスト/OS本体 |
| x86ノートPC(必須要件を満たすもの) | ⚠️ 理論上は動作するが専用の検証はしていない | ホスト/OS本体(自己責任) |
| 古いAMD FX/Bulldozerシリーズ、古いAtom(Bay Trail/Cherry Trail/Goldmont世代) | ❌ 非対応(AVX2非搭載) | 該当なし |
| Apple Silicon Mac(ネイティブ) | ❌ 非対応(ARMアーキテクチャ) | 該当なし。開発機としてgatewayを動かすことのみ可能(OS本体ではない) |
| Apple Silicon Mac+QEMU/UTMによるx86エミュレーション | ⚠️ 技術的には起動するが極端に遅い | 実用は推奨しない。起動画面をざっと確認する程度の用途 |
第2層:周辺機器/センサーエンドポイント(OS本体は動かせない)
Section titled “第2層:周辺機器/センサーエンドポイント(OS本体は動かせない)”| ハードウェアクラス | サポート状況 | エコシステムでの役割 |
|---|---|---|
| Raspberry Pi 4/5(ARM64 SBC) | ❌ DuDuClaw OSを動かせない(ARMアーキテクチャが非互換) | ✅ エッジagentノード/IoTゲートウェイとして利用可。http_poll/command/file_tail経由でデータを送信 |
| その他のARM Linux SBC(原理は同じ、型番ごとの個別検証はしていない) | ❌ 同上 | ✅ 同上 |
| ESP32シリーズ(Wi-Fi/BLE MCU) | ❌ Linuxを一切動かせない(MMUなし、SRAMはKB単位) | ✅ センサーエンドポイント。command/file_tail/loopbackのwebsocket relay経由で接続 |
| Arduino Uno/Nanoなどの8bit MCU | ❌ 同上(リソースレベルはさらに低い) | ✅ 同上。通常はネットワークモジュール(ESP8266拡張ボードなど)と組み合わせないとネットに接続できない |
Mac/ARMエミュレーションで検証できない理由
Section titled “Mac/ARMエミュレーションで検証できない理由”DuDuClaw OSはx86-64です。Apple Silicon Mac上でUTM/QEMUを使ってx86-64をエミュレーションするのは**ソフトウェアエミュレーション(TCG)**であり、動作は遅く、表示や入力もスムーズとは限りません。「起動画面をざっと確認する」程度の用途には向いていますが、実用には向きません。実際の体験を得るには、USBに書き込んでx86 UEFIの実機で起動する必要があります。それがネイティブ速度です。
起動メディアの正しい書き込み方
Section titled “起動メディアの正しい書き込み方”リリースごと、machineごとに2種類の成果物があり、書き込み方が異なります(成果物の一覧、検証用の公開鍵とコマンドはDuDuClaw-OSリポジトリのREADME「Quick start」を参照してください。書き込む前に必ず.minisigと.sha256を検証してください):
- インストーラー
.iso(推奨):balenaEtcherまたはddでUSBに書き込むか、ディスクに焼きます。UEFIで起動するとグラフィカルなインストールウィザードに入り、対象のSSDを選んでインストールしたあと再起動します。「ディスク/Boot from ISO」による起動に対応している唯一の成果物です。 - ディスク全体イメージ
.wic.zst:zstd -dで展開してから、そのまま対象ディスクに書き込みます(またはUSBに書き込んでディスクとして起動することもできます):
sudo dd if=duduclaw-os-*.wic of=/dev/rdiskN bs=4m status=progress# rdiskNは対象デバイスの実際の番号に置き換えてください。まずdiskutil list(macOS)またはlsblk(Linux)で確認し、ディスクを間違えないよう注意してください⚠️ .wicはディスクに焼くことも、「Boot from ISO」/QEMUのcdromで起動することもできません:GPTディスクimageがディスク(/dev/sr0)経由の経路をたどる場合、kernelのsrドライバーのGENHD_FL_NO_PART制限により、ディスク上にGPTパーティションノードが作られず、起動チェーンがパーティションを見つけられません。ディスクやISOから起動したい場合は、インストーラー.isoを使ってください——それはISO9660のlive環境であり、起動メディア上のパーティションテーブルに依存しません。
関連ドキュメント
Section titled “関連ドキュメント”- appliance-build.md —— DuDuClaw OS imageの入手とビルド(OS側の系統はDuDuClaw-OSリポジトリへ移動済み)
- deployment-guide.md —— デプロイ(サーバー側)
- features/41-resident-sensing.md —— resident sensingの完全な機能説明(
http_poll/command/file_tail/websocketの4種類のソース、SSRF防御、rate cap、delta導出)