docs: refresh hosted backup guidance

This commit is contained in:
Peter Steinberger 2026-04-04 10:42:02 +01:00
parent 559e42b60c
commit 508ca72fc7
No known key found for this signature in database
3 changed files with 20 additions and 17 deletions

View File

@ -118,18 +118,18 @@ Expected output:
OpenClaw runs in Docker, but Docker is not the source of truth.
All long-lived state must survive restarts, rebuilds, and reboots.
| Component | Location | Persistence mechanism | Notes |
| ------------------- | --------------------------------- | ---------------------- | -------------------------------------- |
| Gateway config | `/home/node/.openclaw/` | Host volume mount | Includes `openclaw.json`, `.env` |
| Model auth profiles | `/home/node/.openclaw/` | Host volume mount | `auth-profiles.json` (OAuth, API keys) |
| Skill configs | `/home/node/.openclaw/skills/` | Host volume mount | Skill-level state |
| Agent workspace | `/home/node/.openclaw/workspace/` | Host volume mount | Code and agent artifacts |
| WhatsApp session | `/home/node/.openclaw/` | Host volume mount | Preserves QR login |
| Gmail keyring | `/home/node/.openclaw/` | Host volume + password | Requires `GOG_KEYRING_PASSWORD` |
| External binaries | `/usr/local/bin/` | Docker image | Must be baked at build time |
| Node runtime | Container filesystem | Docker image | Rebuilt every image build |
| OS packages | Container filesystem | Docker image | Do not install at runtime |
| Docker container | Ephemeral | Restartable | Safe to destroy |
| Component | Location | Persistence mechanism | Notes |
| ------------------- | --------------------------------- | ---------------------- | ------------------------------------------------------------- |
| Gateway config | `/home/node/.openclaw/` | Host volume mount | Includes `openclaw.json`, `.env` |
| Model auth profiles | `/home/node/.openclaw/agents/` | Host volume mount | `agents/<agentId>/agent/auth-profiles.json` (OAuth, API keys) |
| Skill configs | `/home/node/.openclaw/skills/` | Host volume mount | Skill-level state |
| Agent workspace | `/home/node/.openclaw/workspace/` | Host volume mount | Code and agent artifacts |
| WhatsApp session | `/home/node/.openclaw/` | Host volume mount | Preserves QR login |
| Gmail keyring | `/home/node/.openclaw/` | Host volume + password | Requires `GOG_KEYRING_PASSWORD` |
| External binaries | `/usr/local/bin/` | Docker image | Must be baked at build time |
| Node runtime | Container filesystem | Docker image | Rebuilt every image build |
| OS packages | Container filesystem | Docker image | Do not install at runtime |
| Docker container | Ephemeral | Restartable | Safe to destroy |
## Updates

View File

@ -72,13 +72,14 @@ Use the Control UI at `/openclaw` or run `openclaw onboard` via Railway's shell
## Backups & migration
Export your configuration and workspace:
Export your state, config, auth profiles, and workspace:
```bash
openclaw backup create
```
This creates a portable backup archive you can restore on any OpenClaw host. See [Backup](/cli/backup) for details.
This creates a portable backup archive with OpenClaw state plus any configured
workspace. See [Backup](/cli/backup) for details.
## Next steps

View File

@ -119,13 +119,15 @@ For OpenClaw, vertical scaling is usually sufficient. Horizontal scaling require
## Backups and migration
Export your configuration and workspace at any time using the shell access in the Render Dashboard:
Export your state, config, auth profiles, and workspace at any time using the
shell access in the Render Dashboard:
```bash
openclaw backup create
```
This creates a portable backup archive you can restore on any OpenClaw host. See [Backup](/cli/backup) for details.
This creates a portable backup archive with OpenClaw state plus any configured
workspace. See [Backup](/cli/backup) for details.
## Troubleshooting
@ -143,7 +145,7 @@ Free tier services spin down after 15 minutes of inactivity. The first request a
### Data loss after redeploy
This happens on free tier (no persistent disk). Upgrade to a paid plan, or
regularly export your config via `openclaw backup create` in the Render shell.
regularly export a full backup via `openclaw backup create` in the Render shell.
### Health check failures