Advanced Operations

This chapter covers the Admin Panel’s advanced surface: container updates, backup and restore, personalization, and more.

Container Update Flow

Regular updates keep you current on features and security patches.

Update Check

Each tab displays the installed version and whether a new release is available:

Update Steps

1. Back up data

   • Run “Export Data” before upgrading

2. Pick a container

   • Open the container tab
   • Click “Update”

3. Confirm the update

   • The dialog shows a summary of changes
   • Confirm to proceed

4. Wait for completion

   • The container restarts briefly
   • Usually 30 to 60 seconds
   • “Update completed” appears when finished

Things to Watch

Upgrading Multiple Containers

When several containers need updates at once:

1. Update Rose first (the management core)
2. Wait until Rose is fully running
3. Then update Ada and Vi
4. Leave at least 30 seconds between each

Backup and Restore Guide

Regular backups are the best defense for your data.

What’s Included in a Backup

“Export Data” exports the following:

Manual Backup Steps

1. Open the MAIN tab
2. Click “Export Data”
3. Pick what to include
4. Click “Export”
5. Download the file
6. Store it somewhere safe

Automated Backups

Beyond manual backups, consider scheduling them:

# In Host Terminal, set up a cron job
# This runs a backup every day at 2 AM
0 2 * * * /usr/local/bin/backup-openclaw.sh

Restore

To restore from a backup:

1. Open the terminal of the matching container
2. Upload the backup file
3. Run the restore command
4. Restart related services

Backup File Management

Suggested filename:

openclaw-backup-YYYYMMDD-HHMMSS.tar.gz

Retention strategy:

• Daily: keep the last 7 days
• Weekly: keep the last 4 weeks
• Monthly: keep the last 12 months

Nicknames and Tags

Nicknames and tags make container management more intuitive.

Setting a Nickname

Default names (oc-1, oc-2, hm-3) are not always obvious. Set a nickname:

1. Open the container tab
2. Click the settings icon ()
3. Enter a name in the “Nickname” field
4. Save

Nickname Suggestions

Using Tags

Tags help classify what each container is for:

Example tags:
- 🏷️ production
- 🏷️ staging
- 🏷️ development
- 🏷️ backup
- 🏷️ client-a

Setting Tags

1. In container settings, find “Tags”
2. Type a tag and press Enter
3. Click the next to a tag to remove it
4. Save

Dark / Light Theme

The Admin Panel supports both dark and light themes to protect your eyes.

How to Switch

Option 1 — Quick toggle

1. Click the / icon in the top-right
2. The theme flips immediately

Option 2 — Settings page

1. Open “Settings”
2. Find the “Appearance” section
3. Pick “Dark”, “Light”, or “System”

Theme Options

When to Use Which

• Dark mode: late-night work, long sessions, reducing eye strain
• Light mode: daytime, presentations, printing

Other Advanced Settings

Timezone

Make sure timestamps render correctly:

1. Open “Settings”
2. Find “Timezone”
3. Pick your timezone (for example, America/New_York)
4. Save

Language

Switch the interface language:

1. Click the language selector at the top
2. Pick “English” or “繁體中文”
3. The page reloads automatically

Notifications

Configure system notifications:

Access Logs

See Admin Panel activity:

1. Open the “Logs” page
2. Select a time range
3. Filter by record type
4. Export as CSV if needed

Troubleshooting

Common Issues

Q: Container did not start after update. A: Try:

1. Check the error log on the MAIN tab
2. Check disk space
3. Restart the container manually
4. Contact support

Q: Backup file is too big. A: Options:

• Selective backup (only what you need)
• Clean up old conversation history
• Compress large attachments

Q: Theme toggle does nothing. A: Try:

1. Clear your browser cache
2. Hard refresh
3. Confirm your browser is supported

Page Navigation

• ← Vi Dashboard
• Admin Panel Overview →