boot_installer

# boot_installer

Runs `{baseDir}/boot.sh` to manage the full openclaw environment lifecycle.
Requires Linux and root/sudo access. The script handles privilege escalation automatically.

## Slash commands

| Command | What it does |
|---|---|
| `/boot-install` | Fresh install of all components |
| `/boot-update` | Upgrade all packages to latest versions |
| `/boot-repair` | Deep clean and rebuild broken state |
| `/boot-check` | Health-check — verify all components |

## When to run which mode

- User says "install openclaw", "set it up", "run the installer" → **install** (no flag)
- User says "update", "upgrade packages" → **update**
- User says "repair", "fix", "something is broken", "rebuild" → **repair**
- User says "check", "status", "is everything installed", "health check" → **check**

## How to invoke

Always run as the calling user (sudo is handled internally by the script):

```bash
bash {baseDir}/boot.sh                # install
bash {baseDir}/boot.sh --update       # update
bash {baseDir}/boot.sh --repair       # repair
bash {baseDir}/boot.sh --check        # check — exits with number of failed checks (max 125)
```

Use the `exec` tool. Stream output so the user sees the spinner progress live.

## What gets installed (install mode)

- Node.js v24+ via NodeSource
- UV Python package manager (`~/.local/bin/uv`)
- Python 3.10 venv at `~/venv` with `scrapling[fetchers]`
- Chromium browser via Playwright (`~/.cache/ms-playwright`)
- NPM globals: `9router`, `openclaw@latest`, `clawhub`, `paperclipai`, `@presto-ai/google-workspace-mcp`, `mcporter`
- System symlinks in `/usr/local/bin`
- `9router` autostart via systemd user service (falls back to `.bashrc` hook)
- `openclaw-gateway-watchdog` systemd user service
- Mcporter Google Workspace connector

## Key paths

| Path | Purpose |
|---|---|
| `~/venv` | Python virtual environment |
| `~/.local/bin` | UV binary |
| `~/.local/npm/bin` | NPM global binaries |
| `~/.cache/ms-playwright` | Chromium browser |
| `~/.openclaw/workspace/skills` | Workspace skills |
| `~/.config/systemd/user/9router.service` | 9router systemd unit |
| `~/.config/systemd/user/openclaw-gateway-watchdog.service` | Gateway watchdog |

## After install

If `.bashrc` was modified, remind the user to reload their shell:
```bash
source ~/.bashrc
```

## Logs and errors

The script writes a full log to `/tmp/boot-YYYYMMDD-HHMMSS.log`. If a step fails, the last 15 lines of output are printed inline and the log path is shown. Surface that path to the user on failure.

## Check mode exit codes

`--check` exits with the count of failed checks (0 = all pass, 1–125 = N issues, capped at 125). Parse the exit code and tell the user how many checks failed and to run `bash {baseDir}/boot.sh` to repair.

## Troubleshooting

- **APT lock held** — script waits up to 120 s and kills blocking processes automatically. No user action needed.
- **Node.js wrong version** — script upgrades it automatically if the installed major is below 24.
- **Broken Python venv** — run `--repair` first, then run without flags to reinstall packages.
- **9router not starting** — logs at `~/.local/share/9router.log`. Falls back to `.bashrc` login hook if systemd unavailable.
- **Gateway watchdog not starting** — run `journalctl --user -u openclaw-gateway-watchdog -n 50`.
- **Permission errors on files** — run without flags (install mode); `_fix_ownership` runs at the end of every install/update.