Skip to main content

​
Overview

This page is a historical reference for users transitioning from legacy OpenClaw installations. ArgentOS was inspired by OpenClaw’s original vision but is an independently developed AI operating system with 90,000+ lines of original code. The two projects have diverged significantly and are no longer compatible.
The migration tool preserves data from legacy installations:
  • Agent identity files (SOUL.md, AGENTS.md)
  • User profile (USER.md)
  • Tool configurations (TOOLS.md)
  • Memory and daily logs (MEMORY.md, memory/*.md)
  • Channel configurations
  • Cron jobs and schedules
+-----------------------------------------------------------------------------+
|                    LEGACY DATA -> ARGENTOS MIGRATION                         |
|                                                                             |
|   Legacy Installation                ArgentOS Workspace                     |
|   ~/.openclaw/                       ~/.argentos/                           |
|                                                                             |
|   +-- workspace/          --->    +-- workspace/                           |
|   |   +-- SOUL.md         --->    |   +-- SOUL.md         (preserved)     |
|   |   +-- AGENTS.md       --->    |   +-- AGENTS.md       (upgraded)      |
|   |   +-- USER.md         --->    |   +-- USER.md         (preserved)     |
|   |   +-- TOOLS.md        --->    |   +-- TOOLS.md        (preserved)     |
|   |   +-- MEMORY.md       --->    |   +-- MEMORY.md       (preserved)     |
|   |   +-- HEARTBEAT.md    --->    |   +-- HEARTBEAT.md    (upgraded)      |
|   |   +-- memory/         --->    |   +-- memory/         (preserved)     |
|   |                                                                         |
|   +-- config.json         --->    +-- config.json         (converted)     |
|   +-- sessions/           --->    +-- sessions/           (preserved)     |
|   +-- credentials/        --->    +-- credentials/        (preserved)     |
|                                                                             |
|   Legacy memory database  --->    Built-in MemU system                     |
|   ~/.openclaw-mem/        --->    ~/.argentos/data/memory.db               |
|                                                                             |
+-----------------------------------------------------------------------------+

​
Migration Commands

These commands are for users transitioning from legacy installations only. New users should follow the Getting Started guide instead.
argent migrate from-openclaw

​
What Gets Migrated

​
1. Identity Files

FileDescriptionMigration
SOUL.mdPersonality, values, behaviorCopied as-is
AGENTS.mdWorkspace conventionsUpgraded with ArgentOS features
USER.mdOwner profileCopied as-is
TOOLS.mdTool notes, API keysCopied as-is
IDENTITY.mdAdditional identityCopied if exists

​
2. Memory

SourceDestinationNotes
MEMORY.mdMEMORY.mdPreserved exactly
memory/*.mdmemory/*.mdAll daily logs preserved
~/.openclaw-mem/memory.db~/.argentos/data/memory.dbLegacy SQLite migrated to MemU
~/.openclaw-mem/chroma/~/.argentos/data/vectors/Vectors migrated if exists

​
3. Configuration

# Legacy config.json -> ArgentOS config.json

# Channel credentials preserved:
telegram:
  token: "..." -> telegram.token

discord:
  token: "..." -> discord.token

# Model settings converted:
model: "anthropic/claude-sonnet-4" -> models.default: "balanced"

# ArgentOS systems enabled:
+ sis.enabled: true
+ tasks.enabled: true
+ models.routing.enabled: true
+ models.local.endpoint: "http://localhost:11434"

​
4. Channel Credentials

All channel credentials are migrated:
  • Telegram bot tokens
  • Discord bot tokens
  • Slack app credentials
  • Signal sessions
  • WhatsApp sessions (Baileys auth)

​
5. Sessions & History

  • Active sessions preserved
  • Conversation history maintained
  • Session keys unchanged (no disruption)

​
Migration Process

1

Install ArgentOS

# Install ArgentOS globally
npm install -g argentos

# Or with Bun
bun install -g argentos
2

Run Migration

# Interactive migration wizard
argent migrate from-openclaw

# Wizard prompts:
# Found legacy workspace at ~/.openclaw/workspace
# Found identity files: SOUL.md, AGENTS.md, USER.md, TOOLS.md
# Found memory: MEMORY.md + 47 daily logs
# Found legacy memory database: 1,234 observations
# Found channels: telegram, discord, whatsapp
#
# Ready to migrate. This will:
# - Create ArgentOS workspace at ~/.argentos/
# - Copy all identity and memory files
# - Convert configuration
# - Migrate memory database to MemU
#
# Continue? [Y/n]
3

Verify Migration

# Check migration status
argent doctor

# Output:
# Identity files: OK
# Memory system: OK (1,234 observations imported)
# Channels: telegram (OK), discord (OK), whatsapp (OK)
# Configuration: OK
#
# ArgentOS is ready!
4

Start ArgentOS

# Start all services
argent start

# Or start gateway only
argent gateway start

​
Manual Migration

If you prefer manual migration: 
# 1. Create ArgentOS workspace
mkdir -p ~/.argentos/workspace

# 2. Copy identity files
cp ~/.openclaw/workspace/SOUL.md ~/.argentos/workspace/
cp ~/.openclaw/workspace/AGENTS.md ~/.argentos/workspace/
cp ~/.openclaw/workspace/USER.md ~/.argentos/workspace/
cp ~/.openclaw/workspace/TOOLS.md ~/.argentos/workspace/
cp ~/.openclaw/workspace/MEMORY.md ~/.argentos/workspace/
cp -r ~/.openclaw/workspace/memory ~/.argentos/workspace/

# 3. Copy credentials
cp -r ~/.openclaw/credentials ~/.argentos/

# 4. Migrate memory database
mkdir -p ~/.argentos/data
cp ~/.openclaw-mem/memory.db ~/.argentos/data/

# 5. Convert config (use migration tool)
argent migrate convert-config ~/.openclaw/config.json

​
FAQ

No. Your SOUL.md and identity files are copied exactly as-is.
No. All memory files and the legacy database are migrated to MemU.
All credentials are migrated. Your Telegram, Discord, Slack, Signal, and WhatsApp connections will work immediately.

​
Support

Need help with migration?