mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-06 10:40:43 +00:00
docs(install): batch convert callouts and sentence-case headings
- macos-vm: download-time Note component - hetzner: community-maintained Note component - exe-dev: stateful-VM Tip component - development-channels: parallel clones Tip component - migrating: sentence-case top heading and section headings, replace bullet -- separators with em-dashes, drop 'this guide' filler
This commit is contained in:
@@ -46,8 +46,9 @@ install method:
|
||||
`OPENCLAW_GIT_DIR`), switches to `main`, rebases on upstream, builds, and
|
||||
installs the global CLI from that checkout.
|
||||
|
||||
Tip: if you want stable + dev in parallel, keep two clones and point your
|
||||
gateway at the stable one.
|
||||
<Tip>
|
||||
If you want stable and dev in parallel, keep two clones and point your gateway at the stable one.
|
||||
</Tip>
|
||||
|
||||
## One-off version or tag targeting
|
||||
|
||||
|
||||
@@ -48,9 +48,9 @@ Then connect:
|
||||
ssh <vm-name>.exe.xyz
|
||||
```
|
||||
|
||||
Tip: keep this VM **stateful**. OpenClaw stores `openclaw.json`, per-agent
|
||||
`auth-profiles.json`, sessions, and channel/provider state under
|
||||
`~/.openclaw/`, plus the workspace under `~/.openclaw/workspace/`.
|
||||
<Tip>
|
||||
Keep this VM **stateful**. OpenClaw stores `openclaw.json`, per-agent `auth-profiles.json`, sessions, and channel/provider state under `~/.openclaw/`, plus the workspace under `~/.openclaw/workspace/`.
|
||||
</Tip>
|
||||
|
||||
## 2) Install prerequisites (on the VM)
|
||||
|
||||
|
||||
@@ -253,7 +253,9 @@ For teams preferring infrastructure-as-code workflows, a community-maintained Te
|
||||
|
||||
This approach complements the Docker setup above with reproducible deployments, version-controlled infrastructure, and automated disaster recovery.
|
||||
|
||||
> **Note:** Community-maintained. For issues or contributions, see the repository links above.
|
||||
<Note>
|
||||
Community-maintained. For issues or contributions, see the repository links above.
|
||||
</Note>
|
||||
|
||||
## Next steps
|
||||
|
||||
|
||||
@@ -92,7 +92,9 @@ lume create openclaw --os macos --ipsw latest
|
||||
|
||||
This downloads macOS and creates the VM. A VNC window opens automatically.
|
||||
|
||||
Note: The download can take a while depending on your connection.
|
||||
<Note>
|
||||
The download can take a while depending on your connection.
|
||||
</Note>
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -6,26 +6,26 @@ read_when:
|
||||
title: "Migration guide"
|
||||
---
|
||||
|
||||
# Migrating OpenClaw to a New Machine
|
||||
# Migrating OpenClaw to a new machine
|
||||
|
||||
This guide moves an OpenClaw gateway to a new machine without redoing onboarding.
|
||||
Move an OpenClaw gateway to a new machine without redoing onboarding.
|
||||
|
||||
## What Gets Migrated
|
||||
## What gets migrated
|
||||
|
||||
When you copy the **state directory** (`~/.openclaw/` by default) and your **workspace**, you preserve:
|
||||
|
||||
- **Config** -- `openclaw.json` and all gateway settings
|
||||
- **Auth** -- per-agent `auth-profiles.json` (API keys + OAuth), plus any channel/provider state under `credentials/`
|
||||
- **Sessions** -- conversation history and agent state
|
||||
- **Channel state** -- WhatsApp login, Telegram session, etc.
|
||||
- **Workspace files** -- `MEMORY.md`, `USER.md`, skills, and prompts
|
||||
- **Config** — `openclaw.json` and all gateway settings.
|
||||
- **Auth** — per-agent `auth-profiles.json` (API keys plus OAuth), plus any channel or provider state under `credentials/`.
|
||||
- **Sessions** — conversation history and agent state.
|
||||
- **Channel state** — WhatsApp login, Telegram session, and similar.
|
||||
- **Workspace files** — `MEMORY.md`, `USER.md`, skills, and prompts.
|
||||
|
||||
<Tip>
|
||||
Run `openclaw status` on the old machine to confirm your state directory path.
|
||||
Custom profiles use `~/.openclaw-<profile>/` or a path set via `OPENCLAW_STATE_DIR`.
|
||||
</Tip>
|
||||
|
||||
## Migration Steps
|
||||
## Migration steps
|
||||
|
||||
<Steps>
|
||||
<Step title="Stop the gateway and back up">
|
||||
@@ -70,7 +70,7 @@ Custom profiles use `~/.openclaw-<profile>/` or a path set via `OPENCLAW_STATE_D
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## Common Pitfalls
|
||||
## Common pitfalls
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Profile or state-dir mismatch">
|
||||
@@ -102,7 +102,7 @@ Custom profiles use `~/.openclaw-<profile>/` or a path set via `OPENCLAW_STATE_D
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Verification Checklist
|
||||
## Verification checklist
|
||||
|
||||
On the new machine, confirm:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user