Migration Guide

# Migrate everything
librefang migrate --from openclaw

# Migrate from specific path
librefang migrate --from openclaw --path ~/.openclaw

# Preview mode (no execution)
librefang migrate --from openclaw --dry-run

# Export OpenClaw data
cd ~/.openclaw
tar -czf openclaw-data.tar.gz agents/ skills/ config/

# Copy to LibreFang
cp openclaw-data.tar.gz ~/.librefang/

# Import
librefang migrate --from openclaw --import

# LangChain configuration
agent_config = {
    "agent_type": "conversational",
    "llm": {"provider": "openai", "model": "gpt-4"},
    "tools": ["serpapi", "python_repl"],
    "memory": {"type": "buffer", "k": 10}
}

# Convert to LibreFang TOML
"""
[model]
provider = "openai"
model = "gpt-4"

[capabilities]
tools = ["web_search", "python_repl"]
memory_read = ["*"]
memory_write = ["self.*"]
"""

# LangChain-style API
from librefang import LibreFang

lf = LibreFang(api_key="your-key")

# Create agent
agent = lf.create_agent(
    agent_type="conversational",
    llm="gpt-4",
    tools=["web_search", "python"]
)

# Run
result = agent.run("What is the capital of France?")

// AutoGPT configuration
{
  "ai_name": "MyAgent",
  "ai_goals": ["goal1", "goal2"],
  "llm_model_name": "gpt-4",
  "api_usage": []
}

# LibreFang agent.toml
name = "my-agent"
version = "0.1.0"
description = "Migrated from AutoGPT"
module = "builtin:chat"

[model]
provider = "openai"
model = "gpt-4"

[system_prompt]
prompt = "You are MyAgent. Your goals are: goal1, goal2."

# AutoGPT workflow
tasks:
  - goal: "Research topic"
    result: "Research completed"
  - goal: "Summarize findings"
    result: "Summary ready"

{
  "name": "migrated-workflow",
  "steps": [
    {
      "id": "research",
      "agent": "researcher",
      "input": "Research topic"
    },
    {
      "id": "summarize",
      "agent": "writer",
      "input": "Summarize: {{research.results}}"
    }
  ]
}

# Export SQLite
sqlite3 openclaw.db ".dump" > data.sql

# Import to LibreFang
librefang migrate --import-sql data.sql

# Export memory
librefang memory export --format json > memory.json

# Import memory
librefang memory import --format json memory.json

# Copy skill directory
cp -r ~/.openclaw/skills/* ~/.librefang/skills/

# Verify
librefang skill verify

# List all migrated agents
librefang agent list

# Test agent
librefang agent chat <agent-id>

# Check skills
librefang skill list

# Verify configuration
librefang doctor

# Backup current configuration
cp -r ~/.librefang ~/.librefang.backup

# Backup database
cp ~/.librefang/data/librefang.db ~/.librefang.backup.db

# Restore configuration
rm -rf ~/.librefang
cp -r ~/.librefang.backup ~/.librefang

# Restore database
cp ~/.librefang.backup.db ~/.librefang/data/librefang.db

# View detailed errors
librefang migrate --from openclaw --verbose

# Skip problematic files
librefang migrate --from openclaw --skip-errors

# Use --force to override
librefang migrate --from openclaw --force

# Re-import
librefang memory import --backup <path>