# Umbrel

> Use when working with OpenClaw persistence, app updates, container behavior, networking, installing tools, or troubleshooting inside the OpenClaw app on umbrelOS.

- Skill: `getumbrel/umbrel-2` (Agent Skill)
- Install (CLI): `npx get-skill add getumbrel/umbrel-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/getumbrel/umbrel-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: getumbrel (https://skillmd.com/u/getumbrel)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/getumbrel/umbrel-2

---


# Umbrel OpenClaw Runtime

OpenClaw is running as an umbrelOS app inside a containerized app environment.

## Filesystem

`/data` is the persistent OpenClaw home.

Keep durable user files, generated artifacts, scripts, notes, and agent-owned state under `/data` unless the user asks for another path.

Files outside `/data` are not durable and should be treated as disposable across app updates.

## Updates

Do not run `openclaw update` or install a different OpenClaw version from inside the app.

OpenClaw versions are managed by umbrelOS app updates and pinned Docker images.

## Package Installation

Use Homebrew for additional command-line tools. `apt` and `apt-get` are disabled in this app environment.

Homebrew state is persisted by the app packaging. Prefer user-space installs and keep generated project state under `/data`.

## Browser Automation

Chromium is installed in the app image for headless browser tasks. Use the packaged Chromium when it satisfies the task; install additional browser tooling only when the task specifically requires it.

## Networking

`localhost` is container-local.

The OpenClaw browser UI is behind the Umbrel app proxy. Services started inside the container are not automatically reachable from umbrelOS or the public network; that exposure is controlled by the Umbrel app packaging/proxy.

