Skip to content
openclawOS

Install

Install openclawOS.

Pick your platform. Run the command. Open the Control UI. Pair your first channel. The whole thing is under a minute on a decent connection.

npm install -g openclawos@latest
openclawos onboard --install-daemon

Recommended for macOS & Linux. Requires Node 22+.

What gets installed

  • openclaw CLI on your PATH
  • A background daemon (launchd / systemd) — the Gateway
  • The Control UI on http://localhost:7777
  • An empty SQLite database at ~/.openclaw/openclaw.db

First pairing

After install, the CLI prompts you to pair a channel. The easiest first pairing is Telegram: create a bot with @BotFather, copy the token, paste it into the Control UI. Done. You can now message your bot and Pi will reply.

Picking your LLM provider

openclawOS works with Anthropic, OpenAI, Google, or anything OpenAI-compatible (Ollama, vLLM, Together, Groq, etc.). Drop your API key into the Control UI's Providers tab. We recommend Claude Opus 4.6+ for the best tool-use behaviour out of the box.

Updating

npm: npm install -g openclawos@latest · Docker: pull the new image · brew: brew upgrade openclawos. State, sessions, and credentials all persist between versions.

Uninstalling

openclaw uninstall removes the daemon, the binary, and (with --purge) your ~/.openclaw directory. We're sorry to see you go. The lobster cries.

FAQ

It downloads the openclawOS binary for your OS, sets up a launchd (macOS) or systemd (Linux) service for the Gateway, creates an encrypted config directory under ~/.openclaw, and opens the web Control UI on localhost:7777 for the first pairing.