HansOS is an agent-first Android operating system.

The phone does not boot into a launcher full of icons. It boots into Hans: a personal, playful, highly autonomous agent with OS-level authority.

HansOS is not a chatbot app. It is an AOSP-based mobile OS where:

• Hans is the primary interface.
• Apps exist as tools Hans can orchestrate.
• The first target is Cuttlefish, not a generic Android emulator.
• The first hardware candidate after Cuttlefish is Minimal Phone MP01.
• The first public surface is the Hans Canvas, not Launcher3.
• OpenAI is the default BYOK intelligence provider.
• Memory, rules, and audit logs are local and inspectable.
• There is no telemetry by default.

This repository has been rebooted from the legacy OpenClaw/Clawdroid prototype. The old project is preserved under archive/legacy-openclaw-os/, and the Git branch legacy-openclaw-os-reference points to the original checked-out state.

HansOS now contains the build-oriented skeleton plus the v1 voice-first runtime path for Cuttlefish and MP01:

aosp/
  device/hansos/cuttlefish/             Custom Cuttlefish product
  frameworks/base/.../HansManagerService SystemServer service skeleton
  packages/apps/HansCanvas/             Pure-agent launcher surface
runtime/HansRuntimeService/             Privileged runtime, BYOK, voice, providers
protocol/                               AIDL contract and shared constants
fakes/                                  Cuttlefish fake daily-phone providers
docs/                                   Architecture, build path, alpha flows
archive/                                Legacy project snapshot

The current v1 target is successful when a Cuttlefish/MP01 build:

1. Boots into Hans Canvas.
2. Starts HansManagerService from SystemServer.
3. Starts HansRuntimeService as a privileged persistent service.
4. Uses MP01 push-to-talk as the primary input surface.
5. Streams the current transcript and then the agent answer into the centered HansCanvas phrase surface.
6. Runs these flows end-to-end:
   • Command to action
   • Morning Agent
   • App Control
7. Uses real MP01 system providers after deterministic fake-flow gates pass.
8. Records every autonomous action in a local audit stream.
9. Keeps sensitive operations behind manual mode.

• Product name: HansOS
• Agent name: Hans
• UI model: Pure Agent
• Recovery model: ADB only
• AOSP branch: android-latest-release
• Cuttlefish target base: aosp_cf_arm64_only_phone-userdebug
• Product target: hansos_cf_arm64-trunk_staging-userdebug
• Post-Cuttlefish hardware target: Minimal Phone MP01 via Android 14 GSI/Treble path
• LLM provider: OpenAI direct BYOK
• Voice direction: MP01 side-button push-to-talk with OpenAI BYOK transcription
• Autonomy: autonomous defaults plus local rules and memory

See:

• docs/ARCHITECTURE.md
• docs/BUILD-PATH.md
• docs/ALPHA-FLOWS.md
• docs/MP01-HARDWARE-PTT-APP-PILOT.md
• docs/SECURITY-MEMORY.md