Migration Date: TBD (Mac Studio return planned)
Current Setup: Mac Studio (M2 Ultra, macOS 15.2, ARM64)
Target Setup: Intel NUC (Linux-based, likely Ubuntu/Debian, x86_64)

• OpenClaw Gateway: Running as LaunchAgent (PID 67650)
• Active Sessions: 1712 sessions, main agent active
• Models: Default qwen3-coder-next:latest (local), Anthropic Claude available
• Channels: Slack + Signal configured and operational
• Security: 3 critical + 3 warn + 1 info (mainly Slack groupPolicy="open")
• Storage: 11GB used of 926GB available (~720GB free)
• Workspace: /Users/cb/.openclaw/workspace (~2.2GB with cerebruh.is repo)

1. OpenClaw Configuration

   • ~/.openclaw/openclaw.json (6.8KB, modified Mar 8)
   • Agent configurations in ~/.openclaw/agents/
   • Session history in ~/.openclaw/agents/main/sessions/

2. Credentials & Secrets

   • BWS access token and profile config
   • GitHub SSH key: ~/.openclaw/workspace/.ssh/github_marclar
   • All API keys stored in Bitwarden Secrets (remote, safe)

3. Workspace Data

   • Repository: cerebruh.is (cloned with git history)
   • Documentation: AGENTS.md, SOUL.md, USER.md, etc.
   • Memory files: MEMORY.md + memory/*.md
   • Project files and scripts

4. Platform-Specific Dependencies

   • Homebrew packages (node, openclaw)
   • Claude CLI (Anthropic subscription-based)
   • macOS-specific integrations (if any)

1. Install Base OS (Ubuntu LTS or Debian Stable)
2. Install Node.js (v25.7.0+ to match current)
3. Install OpenClaw

   npm install -g openclaw
   # or curl install script

4. Install Required Tools
   • git, curl, wget
   • claude CLI (if available on Linux/x86_64)
   • BWS CLI from Bitwarden
   • Any other CLI tools found in current setup

1. Export OpenClaw Configuration

   # On Mac Studio
   tar -czf openclaw-backup.tar.gz ~/.openclaw/

2. Export Workspace

   # On Mac Studio  
   tar -czf workspace-backup.tar.gz ~/.openclaw/workspace/

3. Secure Transfer

   • Use scp or encrypted transfer to move archives
   • Verify checksums after transfer

4. Import on NUC

   # On NUC
   tar -xzf openclaw-backup.tar.gz -C ~/
   tar -xzf workspace-backup.tar.gz -C ~/

1. Initialize OpenClaw Gateway

   openclaw gateway start
   openclaw status  # verify

2. Configure BWS Authentication

   bws config  # re-auth if needed
   # Test access to key credentials

3. Verify Channel Connectivity

   • Test Slack bot connection
   • Test Signal integration
   • Verify GitHub API access

4. Model Configuration

   • Set up local models (qwen3-coder-next)
   • Configure Anthropic API access
   • Test Claude CLI if available on Linux

1. Update External Service Endpoints

   • Hetzner VMs: Update any hardcoded Mac Studio IPs
   • Webhooks: Redirect to NUC endpoints if applicable
   • DNS/networking: Ensure NUC is reachable

2. Cron Jobs & Automation

   • Migrate any scheduled tasks
   • Verify GitHub agent automation works
   • Test heartbeat functionality

3. Security Hardening

   • Address security audit findings
   • Configure firewall rules
   • Set up proper systemd services (vs macOS LaunchAgents)

• Risk: Binary incompatibility, especially local models
• Mitigation: Download x86_64 versions of all binaries
• Specific Concern: Local qwen3-coder model may need re-download

• Risk: Claude CLI might not be available on Linux
• Mitigation:
  • Test availability during Phase 1
  • Alternative: Use API directly through OpenClaw
  • Fallback: Adjust github-agent workflow to use sessions_spawn

• Risk: macOS-specific integrations may break
• Mitigation:
  • Audit current skills for macOS dependencies
  • Replace with Linux equivalents where possible
  • Document any lost functionality

• Risk: Downtime during migration
• Mitigation:
  • Perform migration during low-activity period
  • Keep Mac Studio running until NUC is fully verified
  • Gradual cutover with rollback plan

1. OpenClaw Gateway

   • Dashboard accessible
   • WebSocket connections stable
   • Agent spawning works

2. Channel Integration

   • Slack bot responds to mentions
   • Signal messages route correctly
   • Message delivery and reactions work

3. GitHub Automation

   • GitHub agent can scan issues
   • Claude Code integration functional
   • PR creation and merging works
   • CI gate scripts execute

4. Model Access

   • Local models load and respond
   • Anthropic API calls succeed
   • Token usage tracking accurate

5. Workspace Operations

   • File read/write operations
   • Git operations (clone, push, pull)
   • BWS credential access
   • Memory search functionality

If migration fails or issues arise:

1. Keep Mac Studio Available

   • Don't wipe until NUC is 100% validated
   • Maintain parallel operation initially

2. Quick Revert Procedure

   # On Mac Studio
   openclaw gateway start  # if stopped
   # Update any external service endpoints back

3. Data Sync Back

   • If work happened on NUC, sync changes back to Mac Studio
   • Ensure no data loss during transition

• Monitor CPU/memory usage vs Mac Studio baseline
• Adjust concurrent agent limits if needed
• Optimize local model performance on x86_64

• Complete security audit on new platform
• Implement systemd service isolation
• Configure proper user permissions
• Set up fail2ban or similar protection

• Set up health check automation
• Configure log rotation
• Implement backup schedules for critical data

## Migration Execution Log

### Pre-Migration (Date: _______)
- [ ] Mac Studio data backed up
- [ ] NUC environment ready
- [ ] All stakeholders notified

### Migration Day (Date: _______)
- [ ] Data transferred successfully
- [ ] OpenClaw started on NUC
- [ ] Basic functionality verified
- [ ] Channels responding
- [ ] GitHub integration tested

### Post-Migration (Date: _______)
- [ ] 24-hour stability confirmed  
- [ ] Performance benchmarked
- [ ] All automation verified
- [ ] Mac Studio safely decommissioned

Estimated Migration Time: 4-6 hours
Recommended Migration Window: Weekend or low-activity period
Success Criteria: All current functionality preserved, no data loss, <1hr total downtime