os/services/cmd/os-server/main.go | OS Server entry point |
os/services/cmd/bootstrap/main.go | OTA worker entry point |
os/services/server/ | HTTP handlers (Gin), organised by domain |
os/services/internal/ | Business services — agent, device, network, openclaw, hermes, mqtt, statusled, healthwatch, … |
os/services/domain/ | Shared Go types |
os/hal/ | Python HAL — drivers, routes, board profiles |
os/hal/drivers/ | Hardware drivers (rgb, motors, voice, sensing, gpio_button, mic_button, …) |
os/hal/routes/ | FastAPI routes (voice, led, camera, emotion, scene, music, servo, …) |
contract/ | Frozen HAL capability ABI (capabilities.md, DEVICE-SPEC.md) |
skills/ | 24 open-source skills — agents auto-discover these |
devices/ | Per-device declarations (intern-v2/, lamp/, unitree-go2w/) with DEVICE.md + SOUL.md + SAFETY.md |
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 |