Migrating from OpenClaw

Upgrade from OpenClaw to ArgentOS while keeping your data.

Overview

ArgentOS is a fork of OpenClaw with full backwards compatibility. Your existing configuration, sessions, and channels will continue to work.

Migration Steps

1. Install ArgentOS

npx argentos init

This creates the ~/.argentos/ state directory with symlinks to your existing ~/.openclaw/ data.

2. Update the CLI

Replace openclaw with argent in your scripts and aliases:

# Before
openclaw gateway start

# After
argent gateway start

Both argent and argentos commands work identically.

3. Plugin Manifests

If you have custom plugins, rename openclaw.plugin.json to argent.plugin.json in each plugin directory. ArgentOS reads both formats during the transition period.

4. Verify

argent doctor

This runs a diagnostic check to ensure everything is working correctly.

What's New in ArgentOS

Features you gain by migrating:

MemU — Persistent memory with semantic search (replaces the openclaw-mem plugin)
Model Router — Automatic model tier selection based on task complexity
Dashboard — React web UI with Live2D avatar and TTS
Task System — Priority queue with accountability tracking
Marketplace — Browse and install skills, plugins, and more