system/cmd/os-server/main.go | OS Server entry point |
system/cmd/bootstrap/main.go | OTA worker entry point |
system/server/ | HTTP handlers (Gin), organised by domain |
system/ | Business services — agent, device, network, ota, harness, schedule, statusled, healthwatch, ambient, … |
system/domain/ | Shared Go types |
system/web/ | Setup + Admin React SPA |
runtimes/ | Agent runtime clients — openclaw, hermes, claudecode, codex, opencode, picoclaw |
hal/ | Python HAL — drivers, routes, board profiles |
hal/drivers/ | Hardware drivers (rgb, motors, voice, sensing, gpio_button, privacy_button, …) |
hal/routes/ | FastAPI routes (voice, led, audio, music, sensing, emotion, scene, servo, camera, …) |
robots/contract/ | Frozen HAL capability ABI (capabilities.md, ROBOT-SPEC.md) |
robots/ | Per-device declarations (intern-v2/, lamp/, reachy-mini/, so101/, unitree-go2w/, sim/) with ROBOT.md + SOUL.md + SAFETY.md |
skills/ | 29 built-in skills — agents auto-discover these, including skill-creator for authoring and evaluating new skills |
scripts/provision/ | Image build + on-device setup scripts |
scripts/release/ | OTA upload scripts (upload-os-server.sh, upload-hal.sh, upload-web.sh) |
docs/ | Source docs for this guide |