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-daemonRecommended for macOS & Linux. Requires Node 22+.
What gets installed
openclawCLI 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.