AI Agent yang Mengoperasikan Komputer Seperti Manusia

Claw10 OS adalah AI agent yang berjalan di terminal Linux, mampu melihat layar, menggerakkan mouse, mengetik keyboard, menjalankan aplikasi, mengelola jendela, dan menyelesaikan tugas apapun yang bisa dilakukan manusia di depan komputer.

Status: Core runtime, TUI, API, model router, dan control-plane sudah berfungsi. Menuju arsitektur "screen-first" dengan mouse/keyboard simulation.

Big Plan: doc/BIG_PLAN.md

claw10.dev belum aktif. Gunakan URL GitHub raw di bawah, atau host script install.sh / install.ps1 di domainmu sendiri.

Linux / macOS / WSL / VPS:

curl -fsSL https://raw.githubusercontent.com/crediblemark-official/claw10/master/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/crediblemark-official/claw10/master/install.ps1 | iex

Build dari source:

git clone https://github.com/crediblemark-official/claw10.git
cd claw10
cargo install --path crates/claw10-cli

Pengecekan Versi: Untuk memeriksa ketersediaan versi terbaru secara manual di CLI tanpa memicu proses unduhan paksa, jalankan:

claw10 check

Melakukan Pembaruan Bawaan (Native): Untuk memperbarui Claw10 OS secara langsung ke versi terbaru dari terminal, jalankan:

claw10 update

Secara alternatif, Anda juga dapat menjalankan skrip shell updater eksternal:

curl -fsSL https://raw.githubusercontent.com/crediblemark-official/claw10/master/update.sh | sh

Updater akan menimpa binary dengan versi terbaru dari GitHub release tanpa menghapus konfigurasi dan data di ~/.claw10.

Ketik perintah berikut langsung di terminal Anda untuk menghapus Claw10 OS beserta daemon service, folder database config ~/.claw10, log harian, folder temporary /tmp/claw10, dan membersihkan PATH:

claw10 uninstall

claw10 setup

Wizard akan membuat file konfigurasi di ~/.claw10/config.toml (atau ./claw10.toml) dan meminta API key provider LLM pilihanmu.

claw10 serve --tui

• API server berjalan di http://0.0.0.0:3000
• TUI terbuka di terminal yang sama

claw10 run-agent --objective "buat file hello.txt"

claw10 serve --db /tmp/claw10.sled --tui

NATS_URL=nats://localhost:4222 claw10 serve --features nats -- serve

File konfigurasi menggunakan format TOML. Contoh ~/.claw10/config.toml:

[alias.default]
slot = "openai"
model = "gpt-4o-mini"
api_key = "$OPENAI_API_KEY"

[alias.cheap]
slot = "openai"
model = "gpt-4o-mini"
api_key = "$OPENAI_API_KEY"

[alias.haiku]
slot = "anthropic"
model = "claude-3-5-haiku"
api_key = "$ANTHROPIC_API_KEY"

Set API key via environment variable:

export OPENAI_API_KEY="sk-..."

Workspace terdiri dari 29 crate:

crates/
├── claw10-cli              # Entry point binary
├── claw10-control-api      # HTTP API (axum)
├── claw10-tui              # Terminal UI (ratatui)
├── claw10-agent            # Agent runtime & executor
├── claw10-model-router     # Multi-provider LLM routing
├── claw10-tool             # Tool system
├── claw10-store            # Store abstraction (InMemory + Sled)
├── claw10-domain           # Domain types
├── claw10-spawn            # Spawn broker & validator
├── claw10-lifecycle        # Agent lifecycle
├── claw10-worker           # Worker registry
├── claw10-scheduler        # Schedule service
├── claw10-memory           # Memory service + admission pipeline
├── claw10-policy           # Policy engine
├── claw10-gateway          # Omnichannel gateway
├── claw10-event            # Event bus (InMemory + NATS)
├── claw10-prompt           # Prompt assembly & ICVS
├── claw10-toon             # Context serialization format
├── claw10-icvs             # ICVS policy/prompt compiler
├── claw10-auth             # Agent identity & credential (internal, used by spawn)
├── claw10-mission          # Mission service
├── claw10-task             # Task service
├── claw10-lineage          # Lineage tracking
├── claw10-skill            # Skill lifecycle
├── claw10-artifact         # Artifact storage
├── claw10-context          # Context pipeline
├── claw10-budget           # Budget service
└── claw10-telemetry        # Telemetry events

Untuk detail arsitektur produk dan panduan teknis yang lebih mendalam, silakan baca dokumentasi berikut:

• Product Requirements Document (PRD) — Visi produk, Use Case utama, dan terminologi dasar.
• Model Swarm & Siklus Hidup Agen — Model kehidupan agen (Persistent & Ephemeral) dan pembentukan swarm secara rekursif.
• Fitur & Sub-system — Detail Mission, Task, Scheduler, TOON, ICVS, human approval, dan memory system.
• Arsitektur Sistem & Data — High-level architecture, model organisasi, dan struktur data database (Sled).
• Spesifikasi Teknis & Keamanan — Functional/Non-functional requirements, Threat model, dan Observability pipeline.
• Shell-First Architecture — Filosofi shell-first, tool audit, common shell patterns, safety, dan best practices.

Claw10 OS saat ini tidak memiliki hardware subsystem. Dukungan untuk board seperti Arduino Uno Q, STM32 Nucleo, Raspberry Pi, Android, Aardvark, dan abstraksi Peripheral trait belum diimplementasikan. Menambahkan HAL (Hardware Abstraction Layer) merupakan pekerjaan besar tersendiri yang memerlukan crate baru dan adapter per board.

# Check
cargo check

# Check dengan NATS
cargo check --features nats

# Test
cargo test -- --test-threads=1

# Build release (LTO + strip)
cargo build --release

MIT