DEV Community

Cover image for How to Install OpenClaw: A Guide to Your Open-Source AI Assistant
Auden
Auden

Posted on

How to Install OpenClaw: A Guide to Your Open-Source AI Assistant

OpenClaw (formerly ClawdBot / Moltbot) is an open-source personal AI agent that runs entirely on your own machine.

Unlike cloud-based AI assistants, OpenClaw is fully local. You control your data, your workflows, and how the agent behaves.

It's not just a chatbot — it's an action-oriented agent.

How to Install and Run OpenClaw

What Makes OpenClaw Different?

OpenClaw can:

  • Maintain persistent memory

  • Access your local file system

  • Call external services and APIs

  • Execute real tasks instead of just replying with text

You can interact with it through tools like Telegram or WhatsApp, or directly via a web UI or terminal.

This makes it suitable for developers who want a real AI assistant, not just a demo.

How to Install and Run OpenClaw

System Requirements

Before getting started, make sure you have:

  • Node.js ≥ 22

  • macOS, Linux, or Windows (via WSL2)

  • npm (comes with Node.js)

Check your Node version:

node -v
Enter fullscreen mode Exit fullscreen mode

How to Install and Run OpenClaw

Quick Installation (Recommended)

The easiest way to install OpenClaw is the official one-line installer.

On macOS or Linux:

curl -fsSL https://openclaw.sh/install | bash
Enter fullscreen mode Exit fullscreen mode

How to Install and Run OpenClaw

On Windows (PowerShell):

irm https://openclaw.sh/install.ps1 | iex
Enter fullscreen mode Exit fullscreen mode

After installation, OpenClaw automatically launches an interactive onboarding wizard.

You can rerun it anytime with:

openclaw onboard --install-daemon
Enter fullscreen mode Exit fullscreen mode

How to Install and Run OpenClaw

How to Install and Run OpenClaw

Initial Configuration

During onboarding, you'll configure:

  1. AI Model Provide an API key for a supported LLM (OpenAI, Claude, Gemini, etc.). In this guide, I use the Google Gemini CLI service.

How to Install and Run OpenClaw

How to Install and Run OpenClaw

  1. Communication Channels Choose how you want to talk to the agent (Telegram, WhatsApp, or skip for now).

How to Install and Run OpenClaw

  1. Skills & Hooks Recommended: enable them. They unlock most of OpenClaw's power.

How to Install and Run OpenClaw

Once finished, a local web UI will start automatically.

How to Install and Run OpenClaw

How to Install and Run OpenClaw

Gateway: The Core Service

At the heart of OpenClaw is the Gateway.

The Gateway runs in the background and:

  • Manages LLM connections

  • Handles chat sessions

  • Dispatches commands and actions

Every message flows through the Gateway.

If it's running, your assistant is"alive".

Check system health:

openclaw doctor
Enter fullscreen mode Exit fullscreen mode

Check runtime status:

openclaw status
Enter fullscreen mode Exit fullscreen mode

Gateway Management Commands:

openclaw gateway install
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway uninstall
openclaw gateway status
Enter fullscreen mode Exit fullscreen mode

Using the Web Dashboard

To open the dashboard in your browser:

openclaw dashboard
Enter fullscreen mode Exit fullscreen mode

This command opens the dashboard at a local address similar to:

http://127.0.0.1:18789/?token=<temporary-token>
Enter fullscreen mode Exit fullscreen mode

From there, you can:

  • Chat with the agent

  • Manage skills

  • Schedule tasks

  • View logs

  • Edit configurations

This is the most intuitive way to control OpenClaw.

How to Install and Run OpenClaw

Terminal UI (TUI)

If you prefer the terminal:

openclaw tui
Enter fullscreen mode Exit fullscreen mode

You'll get a full-screen text interface with slash commands like:

  • /status

  • /model

  • /session

  • /help

Clean, focused, and developer-friendly.

How to Install and Run OpenClaw

Useful CLI Commands

Some commands you'll use often:

openclaw models status
openclaw channels list
openclaw memory search
openclaw docs
Enter fullscreen mode Exit fullscreen mode

They cover model health, integrations, memory search, and documentation lookup.

Final Thoughts

OpenClaw is more than a local chatbot.

It's a foundation for building your own AI agent — one that can grow, learn, and act on your behalf.

If you care about privacy, control, and extensibility, it's absolutely worth exploring.

Bonus: A Must-Have Tool for API Development – Apidog

Alongside OpenClaw, there's another powerful productivity tool for developers: Apidog.

Apidog is an all-in-one platform for API documentation, API debugging, API design, API testing, mocking, and automation. It streamlines your entire API workflow — making it one of the best tools to boost development efficiency.

How to Install and Run OpenClaw

If you're actively building and testing APIs, give Apidog a try. Signing up is easy — just register here.

After registering, explore the official demo projects. They're carefully crafted to help you get up to speed with Apidog's core features.

A major benefit of Apidog is its full compatibility with Postman and Swagger formats. If you've used those tools before, importing your existing data will be effortless. The intuitive interface also makes it beginner-friendly — even first-time users can get started quickly.

Top comments (0)