umbrel

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

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.