Skip to content

rebootix-research/viki-clow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VikiClow

VikiClow

Execution-grade clow/operator system for durable missions, visible browser work, proof, memory, and capability growth.
VikiClow turns intent into finished operator work and keeps the evidence.
It discovers, executes, verifies, remembers, and expands instead of stopping at a good answer.

CI status Native verification Release License

Docs · Operator guide · Capability Foundry · Release proof guide · Runtime proof guide

VikiClow is not another clow that stops at conversation.

OpenClaw focuses on a personal assistant across channels. NemoClaw hardens that shape inside a sandboxed reference stack. Clawith pushes toward collaborative multi-agent workspaces. CrewAI and AutoGen focus on agent orchestration frameworks. OpenHands focuses on AI-driven development. VikiClow takes a different line: durable missions, visible execution, proof, memory, and curated capability growth in one operator system.

You give it an objective, it turns that objective into a mission, routes the mission through swarms and executors, verifies the result, and records the evidence. When a mission needs a capability that is not already present, Capability Foundry can discover, classify, sandbox, test, promote, and register a compatible one instead of stalling.

One-screen explanation

VikiClow combines the parts most clow projects keep separate:

  • a durable mission runtime with explicit terminal states
  • Viki Browser for visible browser work with managed profiles and proof
  • swarm-of-swarms orchestration with verifier and recovery routing
  • a voice-native command center with built-in VibeVoice and explicit runtime readiness states
  • persistent memory that survives provider and model changes
  • Capability Foundry for curated discovery, promotion, bundling, and routing of proven capabilities
  • full PC and web execution surfaces instead of answer-only UX
  • a self-evolution engine for candidate intake, experiments, promotion, and rollback

The result is a clow that compounds capability over time instead of resetting to a blank prompt loop every session.

Category benchmark

VikiClow sits in the same operator and multi-agent category as OpenClaw, NemoClaw, Clawith, CrewAI, AutoGen, and OpenHands, but it solves a different problem shape. OpenClaw, NemoClaw, and Clawith are the closest clow/operator comparators. CrewAI, AutoGen, and OpenHands are adjacent frameworks and developer operators that matter when people evaluate how much of the execution stack is actually shipped.

VikiClow category benchmark

Dimension VikiClow OpenClaw NemoClaw Clawith
Public repo positioning Execution-grade clow/operator system Personal AI assistant across channels Hardened OpenShell reference stack for OpenClaw Multi-agent collaboration platform for teams
Durable runtime model Explicit missions, checkpoints, terminal states, verifier writeback Not explicit on the public repo surface State management and hardened blueprint are explicit, but the repo is marked alpha Persistent identity, triggers, focus items, and workspaces are explicit
Visible execution surface Viki Browser plus shell, file, voice, device, and web routes Messaging channels plus a live Canvas are explicit Container runtime and sandbox are explicit; browser surface is not Team workspace and agent UI are explicit; browser operator surface is not
Proof and evidence discipline Release proof, runtime-stack proof, execution-surface proof, mission proof CI and releases are visible; proof artifacts are not front-and-center Security policy and release notes are explicit; proof-first surfaces are not Whitepaper, docs, and product UI are visible; proof artifact discipline is not explicit
Capability growth model Capability Foundry with curated discovery, sandboxing, scoring, promotion, bundling, and runtime routing Adjacent skills ecosystem and directory are visible Runtime hardening is the emphasis, not a capability promotion pipeline Runtime tool discovery and install are explicit via Smithery and ModelScope
Persistent state and memory Mission writeback plus Neo4j-backed graph-memory proof paths Always-on assistant framing is explicit; memory strategy is not front-and-center in README Sandboxed state management is explicit Long-term memory, soul, and private workspaces are explicit
Governance and operator discipline Protected main, green CI, release-proof surfaces, explicit terminal states CI and release posture are visible Security posture is central Multi-tenant RBAC, approvals, audit logs, and quotas are explicit
Adjacent repo Public repo surface Where VikiClow differs
CrewAI Multi-agent orchestration framework for collaborative autonomous agents VikiClow ships the operator runtime itself: missions, browser, voice, proof, and memory
AutoGen Programming framework for multi-agent AI applications VikiClow ships the operator runtime itself, with bundled execution surfaces and proof lanes
OpenHands AI-driven development platform and SDK VikiClow covers browser, mission, memory, voice, and capability growth beyond dev-only execution

Comparison is grounded in the public repository surfaces linked above as of April 13, 2026. It compares what those repos clearly present, not hidden implementation details or invented benchmark numbers.

For a source-backed breakdown of the benchmark dimensions, see docs/reference/category-benchmark.md.

Why VikiClow wins

Other clow projects usually dominate one slice of the problem:

  • OpenClaw gives broad personal-assistant reach across channels.
  • NemoClaw hardens that model inside a sandboxed runtime.
  • Clawith pushes deeply into multi-agent organizational collaboration.

VikiClow wins when the requirement is not just interaction, but finished work with operator discipline:

  • Durable missions instead of session-only chat. Objectives become inspectable mission records with retries, checkpoints, explicit terminal states, and recovery paths.
  • Proof instead of vibes. Release proof, runtime-stack proof, execution-surface proof, browser proof, voice proof, and mission backbone proof ship with the product.
  • Run-level truthfulness instead of scattered receipts. Each durable mission can now emit one operator receipt that links runtime checkpoints, provider auth health, browser readiness, memory writeback, capability routing, approvals, and policy posture.
  • Visible browser work, not invisible browsing. Viki Browser gives the operator a branded browser surface with profiles, manifests, evidence paths, and native packaging flows.
  • Capability growth as a supply chain, not an afterthought. Capability Foundry treats skills, plugins, MCP servers, repo integrations, and runtime assets as curated candidates that must be tested and promoted before use.
  • Persistent writeback instead of disposable context. Mission outcomes, graph-memory proof paths, and capability routing history survive restart and provider changes.
  • Release discipline built into the repo. Protected main, green CI, and release-proof workflows are part of the shipped operating model, not internal hygiene hidden from users.

If OpenClaw is a personal assistant, NemoClaw is a hardened reference stack, and Clawith is a multi-agent workplace, VikiClow is the execution-grade clow that turns intent into durable finished work.

Product pillars

Universal task execution

Intent becomes a mission record with plan, state, checkpoints, evidence, retries, and a terminal result.

Viki Browser

VikiClow ships a branded browser lane with managed profiles, relay takeover, launcher packaging, Windows native executable generation, browserd manifests, session vaults, evidence capture, and Playwright-compatible automation.

Durable missions

Terminal states are explicit and inspectable:

  • completed
  • failed
  • blocked
  • needs_approval

Swarm-of-swarms orchestration

A sovereign orchestrator routes domain swarms for browser work, coding, research, documents, local computer control, ops, and communication.

Voice-native command center

Voice is not a plugin afterthought. VikiClow ships a built-in VibeVoice realtime engine path, managed bootstrap, proof surfaces, and readiness gates as part of the product.

Core operator commands:

  • vikiclow voice status
  • vikiclow voice speakers
  • vikiclow voice bootstrap --install-source --install-runtime
  • vikiclow voice say "VikiClow voice check" --provider vibevoice --json

Persistent memory

Mission writeback, Graphiti-style proof paths, and Neo4j-backed graph memory keep memory outside model context alone.

Capability Foundry

Capability Foundry is VikiClow's controlled supply chain for new capability:

  • discover curated source families and candidate integrations
  • classify them as skills, plugins, MCP servers, repo integrations, or asset dependencies
  • fetch or install them from approved sources
  • sandbox and test them before promotion
  • promote or reject them with recorded reasons
  • bundle proven winners into the shipped system
  • register them into runtime routing so VikiClow can choose the right capability for the task
  • persist inventory, provenance, receipts, and usage knowledge so future missions learn from successful runs

It is intentionally curated rather than crawler-driven. The shipped catalog favors bundled VikiClow skills and plugins, approved MCP servers, selected upstream repo integrations, and runtime assets that have a clear place in the mission stack.

Capability Foundry is exposed through the CLI, proof artifacts, the bundled capability inventory, and the runtime routing layer.

Key commands:

  • vikiclow capabilities foundry discover
  • vikiclow capabilities foundry ingest <candidate-id>
  • vikiclow capabilities foundry test <candidate-id>
  • vikiclow capabilities foundry promote <candidate-id> --bundle
  • vikiclow capabilities foundry routes "<objective>"
  • corepack pnpm capabilities:proof

The shipped inventory is explicit and inspectable:

  • source catalog: ~/.vikiclow/capabilities/source-catalog.json
  • bundle receipts: ~/.vikiclow/capabilities/bundle-receipts.json
  • ready capability inventory: ~/.vikiclow/capabilities/bundle-inventory.json
  • proof bundle: .artifacts/capability-bundle/

Full PC and web execution

VikiClow can use Viki Browser, raw HTTP and web-fetch routes, local commands, file surfaces, device-linked actions, and channel-connected control.

Self-evolution engine

Candidates can be ingested, benchmarked, promoted, and rolled back with provenance.

Architecture

User intent
  -> mission object
  -> sovereign orchestrator
  -> domain swarms
  -> browser / repo / research / local-computer executors
  -> verifier / recovery
  -> terminal state + evidence
  -> persistent memory writeback
Capability Foundry
  -> discover curated sources
  -> classify and fetch candidates
  -> sandbox / test / score
  -> promote or reject
  -> bundle and register
  -> route at runtime
  -> remember success

Install

Recommended

macOS/Linux:

curl -fsSL https://vikiclow.ai/install.sh | bash
vikiclow onboard

Windows PowerShell:

iwr -useb https://vikiclow.ai/install.ps1 | iex
vikiclow onboard

The installer lays down the full Vikiclow footprint first: core runtime, workspace, bundled capabilities, Viki Browser lane, VibeVoice lane, and product-truth surfaces. Activation happens after install.

npm / direct CLI install

npm install -g vikiclow@latest
vikiclow setup
vikiclow onboard

From source

git clone https://github.com/rebootix-research/viki-clow.git
cd viki-clow
corepack enable
corepack pnpm install
corepack pnpm build
node ./vikiclow.mjs setup
node ./vikiclow.mjs onboard

Native PowerShell is a supported Vikiclow install and activation path. WSL2 remains optional when you explicitly want a Linux-first toolchain on Windows.

Quick start

1. Install the product footprint

vikiclow setup

This installs the local Vikiclow footprint: workspace, bundled capabilities, Viki Browser lane, VibeVoice lane, and the product truth surface.

2. Activate VikiClow

vikiclow onboard

Activation configures one primary model, the gateway, and the first operator surface. Optional channels stay behind the core activation path instead of blocking it.

3. Check the operator truth surface

vikiclow status
vikiclow dashboard --no-open

status shows product install state, model auth, gateway reachability, mission pressure, and the built-in browser and voice lanes in one operator view.

4. Bootstrap local voice if this machine should speak

vikiclow voice bootstrap --install-source --install-runtime

5. Verify the browser product

vikiclow browser verify-native --json
# on Windows hosts:
vikiclow browser package-native

6. Start the runtime in the foreground when you want a visible local session

vikiclow gateway --port 18789

7. Inspect and refresh capability inventory

vikiclow capabilities list
vikiclow capabilities discover "publish a browser workflow"
vikiclow capabilities fetch playwright browser_profiles
vikiclow capabilities bundle
vikiclow capabilities bootstrap
vikiclow capabilities plan "create a reusable automation skill"
corepack pnpm capabilities:proof

8. Run an end-to-end mission

vikiclow agent --message "Open the browser, collect release evidence, update the docs, and finish the work end to end."

Reliability and proof

VikiClow ships tracked proof guides and generated proof bundles because execution claims are cheap without artifacts.

Tracked proof guides:

  • release proof guide: docs/proofs/release-proof.md
  • runtime stack proof guide: docs/proofs/runtime-stack-proof.md
  • voice readiness proof guide: docs/proofs/voice-readiness-proof.md
  • capability evolution proof guide: docs/proofs/capability-evolution-proof.md

Generated local or CI outputs:

  • release proof: .artifacts/release-proof/
  • runtime stack proof: .artifacts/runtime-stack-proof/
  • execution surface proof: .artifacts/execution-surface/
  • Capability Foundry proof: .artifacts/capability-bundle/
  • voice proof: .artifacts/voice-proof/
  • browser proof: ~/.vikiclow/browserd/native-proof.json
  • mission backbone proof: ~/.vikiclow/missions/backbone/
  • mission operator receipt: ~/.vikiclow/missions/backbone/<missionId>/operator-receipt.json (runtime, model-auth, browser, memory, capability, approvals, and policy truth for one run)
  • graph memory proof: ~/.vikiclow/memory/graphiti/

Use corepack pnpm capabilities:proof to regenerate the Capability Foundry proof bundle locally.

Recovery commands are shipped too:

  • vikiclow backup create --verify
  • vikiclow backup list
  • vikiclow backup restore <archive> --dry-run
  • vikiclow mission receipt <missionId>

Runtime stack

For the strongest local runtime path supported directly by this repository:

corepack pnpm runtime:stack:up
corepack pnpm runtime:stack:proof
corepack pnpm runtime:stack:down

That flow validates the live Temporal-backed mission descriptor path and the live Neo4j-backed Graphiti proof path the repo can exercise locally.

Execution surfaces

VikiClow is intentionally broader than extension-style browsing:

  • Viki Browser for visible browser sessions
  • browserd manifests for profile, session, and evidence verification
  • raw web-fetch routes for lightweight HTTP extraction
  • local command execution surfaces for controlled system work
  • file writeback and workspace memory
  • node and device-linked surfaces for screen, camera, audio, and paired-machine execution

What ships today

Repo-side complete:

  • build, docs, proof scripts, and protected-main release lanes are real
  • browser launchers are shipped in dist/, and the repo includes a Windows native packaging and proof path
  • mission runtime and backbone proofs are real
  • backup create/list/restore is real for local continuity and new-machine recovery
  • setup installs the built-in Viki Browser and VibeVoice lanes before activation begins
  • Capability Foundry ships with inventory, provenance, routing, proof, and bundle receipts
  • the bundled catalog distinguishes curated local skills, bundled plugins, MCP server candidates, GitHub integrations, and runtime assets
  • runtime stack proof exercises Temporal, LangGraph, and Neo4j where Docker is available

Environment-dependent:

  • local VibeVoice synthesis still requires per-machine runtime bootstrap
  • the Windows native browser executable packaging path must run on a Windows host
  • native macOS and Android verification require their host toolchains
  • a separate compiled native CEF browser app is not bundled in this repo build

Why teams choose VikiClow

  • They want execution, not demo conversation.
  • They want durable state, not single-turn magic tricks.
  • They want proof, memory, and repeatability.
  • They want one system that can browse, control, verify, discover, and recover.
  • They want a clow that compounds capability instead of staying frozen at install time.

Docs

License

MIT. See LICENSE.

About

Execution-first AI runtime with durable missions, Viki Browser, voice-native control, persistent memory, and full PC plus web automation.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors