OpenClaw 🦞 — Your assistant, on your devices, in your chats

OpenClaw — EXFOLIATE! EXFOLIATE! Your personal AI assistant, running on your own devices.

CI status npm version Node.js version License: MIT Discord

OpenClaw is a personal AI assistant that runs on your devices and meets you in the channels you already use. It is designed for a single operator and

connects models, tools, messaging channels, and optional companion apps through one Gateway.

Website · Docs · Getting started ·

Showcase · FAQ · Vision ·

DeepWiki

Install

The installer supports macOS, Linux, and Windows. It provisions a supported Node.js runtime when needed.

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

Already manage Node.js? Install the published package instead (Node 22.22.3+, 24.15+, or 25.9+):

npm install -g openclaw@latest --allow-scripts=openclaw

That command is for npm 12 or npm 11.16+. On npm 11.15 and earlier, omit --allow-scripts=openclaw. See the [installation

guide](https://docs.openclaw.ai/install) for the lifecycle script contract, Docker, Nix, and other deployment paths.

Quick start

On a fresh install, the installer scripts start onboarding automatically. Complete the wizard they open. If you installed the package directly with npm, pnpm, or Bun, run:

openclaw onboard --install-daemon

After onboarding:

openclaw gateway status
openclaw dashboard

Onboarding verifies model access, creates the workspace, and configures the Gateway. The last command opens the Control UI; send a message there to

confirm the assistant is working. See the getting started guide for channel setup and

troubleshooting.

How it fits together

  • The Gateway is the local control plane for sessions, tools, events, and channel connections. - The [Control

UI](https://docs.openclaw.ai/web/control-ui), CLI, and TUI connect to the Gateway. -

Channels bring the assistant to WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, and other

messaging services. - Companion apps and nodes add voice, Canvas, camera, screen, and device-local actions on

supported platforms.

OpenClaw works with hosted and local model providers. Its

tools, skills, and plugins extend what

an assistant can do.

Security

Treat inbound messages as untrusted input. DM-capable channels pair unknown senders by default; approve a pairing request with openclaw pairing approve <channel> <code>.

Tools run on the host for the main session unless you configure sandboxing. Read the security guide,

exposure runbook, and sandboxing guide

before connecting other users or exposing the Gateway remotely.

Documentation

| Goal | Start here | | -------------------------------- |

| | Configure models and auth | Models · [Model

providers](https://docs.openclaw.ai/concepts/model-providers) | | Connect a messaging service | Channels | | Add

tools, skills, and plugins | Tools · Skills ·

Plugins · ClawHub | | Run apps and device nodes |

Platforms · Nodes | | Use the CLI and chat commands | [CLI

reference](https://docs.openclaw.ai/cli) · Slash commands | | Configure or operate the Gateway |

Configuration · Architecture ·

Updating · Release channels |

Development

The repository is a pnpm workspace. Plain npm install at the repository root is not supported.

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build

See CONTRIBUTING.md for the contribution workflow and the source setup guide for the development loop.

Community

OpenClaw is developed in the open by the OpenClaw Foundation, a non-profit. See CONTRIBUTING.md for

maintainers and contribution guidelines; AI-assisted PRs are welcome.

Use the issue chooser for bugs and feature requests, ask setup questions in

Discord, and report vulnerabilities through SECURITY.md. New capabilities usually belong in plugins built

on the plugin SDK and shared through ClawHub.

OpenClaw was built for Molty, a space lobster AI assistant, by Peter Steinberger and the community. Explore the [project

lore](https://docs.openclaw.ai/start/lore), soul.md, Peter's site, [Star

History](https://www.star-history.com/#openclaw/openclaw&type=date&legend=top-left), and @openclaw.

Special thanks to Mario Zechner for his support and for pi, and to Adam Doppelt for the lobster.bot domain.

Sponsors

OpenAI GitHub NVIDIA Vercel Blacksmith Convex

Contributors

Thanks to all clawtributors:

steipete <a

href="https://github.com/vincentkoc">vincentkoc <a

href="https://github.com/Takhoffman">Takhoffman

obviyus <a

href="https://github.com/gumadeiras">gumadeiras

<img src="https://avatars.githubusercontent.com/u/132747814?v=4&s=48" width="48" height="48" alt="Mariano

Belinky"> <img src="https://avatars.githubusercontent.com/u/1436853?v=4&s=48" width="48" height="48"

alt="vignesh07"> <img src="https://avatars.githubusercontent.com/u/830519?v=4&s=48" width="48" height="48"

alt="joshavant"> <img src="https://avatars.githubusercontent.com/u/167050519?v=4&s=48" width="48"

height="48" alt="scoootscooob"> <img src="https://avatars.githubusercontent.com/u/1610850?v=4&s=48"

width="48" height="48" alt="jacobtomlinson"> <img

src="https://avatars.githubusercontent.com/u/165377636?v=4&s=48" width="48" height="48" alt="shakkernerd"> <a

href="https://github.com/sebslight">sebslight

<img src="https://avatars.githubusercontent.com/u/64381258?v=4&s=48" width="48" height="48"

alt="tyler6204"> <img src="https://avatars.githubusercontent.com/u/1540134?v=4&s=48" width="48" height="48"

alt="ngutman"> <img src="https://avatars.githubusercontent.com/u/35580099?v=4&s=48" width="48"

height="48" alt="thewilloftheshadow"> <img src="https://avatars.githubusercontent.com/u/201593046?v=4&s=48"

width="48" height="48" alt="Sid-Qin"> <img src="https://avatars.githubusercontent.com/u/7562095?v=4&s=48"

width="48" height="48" alt="mcaxtr"> <img src="https://avatars.githubusercontent.com/u/31522568?v=4&s=48"

width="48" height="48" alt="eleqtrizit"> <img src="https://avatars.githubusercontent.com/u/68980965?v=4&s=48"

width="48" height="48" alt="BunsDev"> <img src="https://avatars.githubusercontent.com/u/13352?v=4&s=48"

width="48" height="48" alt="cpojer"> <img src="https://avatars.githubusercontent.com/u/80581902?v=4&s=48"

width="48" height="48" alt="Glucksberg"> <img src="https://avatars.githubusercontent.com/u/2453968?v=4&s=48"

width="48" height="48" alt="osolmaz"> <img

src="https://avatars.githubusercontent.com/u/208517100?v=4&s=48" width="48" height="48" alt="bmendonca3"> <a

href="https://github.com/jalehman">jalehman <a

href="https://github.com/huntharo">huntharo <a

href="https://github.com/neeravmakwana"><img src="https://avatars.githubusercontent.com/u/261249544?v=4&s=48" width="48" height="48"

alt="neeravmakwana"> <img src="https://avatars.githubusercontent.com/u/80630709?v=4&s=48" width="48"

height="48" alt="openperf"> <img src="https://avatars.githubusercontent.com/u/1497361?v=4&s=48" width="48"

height="48" alt="joshp123"> <img src="https://avatars.githubusercontent.com/u/270720687?v=4&s=48"

width="48" height="48" alt="pgondhi987"> <img src="https://avatars.githubusercontent.com/u/9790196?v=4&s=48"

width="48" height="48" alt="altaywtf"> <img

src="https://avatars.githubusercontent.com/u/40643627?v=4&s=48" width="48" height="48" alt="quotentiroler"> <a

href="https://github.com/liuxiaopai-ai"><img src="https://avatars.githubusercontent.com/u/73659136?v=4&s=48" width="48" height="48"

alt="liuxiaopai-ai"> <img src="https://avatars.githubusercontent.com/u/384037?v=4&s=48" width="48"

height="48" alt="rodrigouroz"> <img src="https://avatars.githubusercontent.com/u/4488090?v=4&s=48"

width="48" height="48" alt="frankekn"> <img src="https://avatars.githubusercontent.com/u/5256797?v=4&s=48"

width="48" height="48" alt="drobison00"> <img

src="https://avatars.githubusercontent.com/u/39543393?v=4&s=48" width="48" height="48" alt="zerone0x"> <img

src="https://avatars.githubusercontent.com/u/152018508?v=4&s=48" width="48" height="48" alt="onutc"> <img

src="https://avatars.githubusercontent.com/u/5212682?v=4&s=48" width="48" height="48" alt="ademczuk"> <img

src="https://avatars.githubusercontent.com/u/92253590?v=4&s=48" width="48" height="48" alt="ImLukeF"> <img

src="https://avatars.githubusercontent.com/u/6640526?v=4&s=48" width="48" height="48" alt="hydro13"> <img

src="https://avatars.githubusercontent.com/u/8814856?v=4&s=48" width="48" height="48" alt="hxy91819"> <img

src="https://avatars.githubusercontent.com/u/65363919?v=4&s=48" width="48" height="48" alt="coygeek"> <img

src="https://avatars.githubusercontent.com/u/261991368?v=4&s=48" width="48" height="48" alt="dutifulbob"> <a

href="https://github.com/sliverp">sliverp <a

href="https://github.com/0xRaini">Elonito <a

href="https://github.com/robbyczgw-cla"><img src="https://avatars.githubusercontent.com/u/239660374?v=4&s=48" width="48" height="48"

alt="robbyczgw-cla"> <img src="https://avatars.githubusercontent.com/u/140015627?v=4&s=48" width="48"

height="48" alt="joelnishanth"> <img src="https://avatars.githubusercontent.com/u/16428813?v=4&s=48"

width="48" height="48" alt="echoVic"> <img src="https://avatars.githubusercontent.com/u/11166065?v=4&s=48"

width="48" height="48" alt="sallyom"> <img

src="https://avatars.githubusercontent.com/u/261132136?v=4&s=48" width="48" height="48" alt="yinghaosang"> <a

href="https://github.com/BradGroux">BradGroux <a

href="https://github.com/christianklotz"><img src="https://avatars.githubusercontent.com/u/69443?v=4&s=48" width="48" height="48"

alt="christianklotz"> <img src="https://avatars.githubusercontent.com/u/8635094?v=4&s=48" width="48"

height="48" alt="odysseus0"> <img src="https://avatars.githubusercontent.com/u/7755017?v=4&s=48" width="48"

height="48" alt="hclsys"> <img src="https://avatars.githubusercontent.com/u/72309817?v=4&s=48" width="48"

height="48" alt="byungsker"> <img src="https://avatars.githubusercontent.com/u/20898225?v=4&s=48"

width="48" height="48" alt="pashpashpash"> <img

src="https://avatars.githubusercontent.com/u/64798754?v=4&s=48" width="48" height="48" alt="stakeswky"> <a

href="https://github.com/apps/github-actions"><img src="https://avatars.githubusercontent.com/in/15368?v=4&s=48" width="48" height="48"

alt="github-actions[bot]"> <img src="https://avatars.githubusercontent.com/u/562450?v=4&s=48" width="48"

height="48" alt="xinhuagu"> <img src="https://avatars.githubusercontent.com/u/6754057?v=4&s=48" width="48"

height="48" alt="MonkeyLeeT"> <img src="https://avatars.githubusercontent.com/u/239388517?v=4&s=48"

width="48" height="48" alt="100yenadmin"> <img

src="https://avatars.githubusercontent.com/u/3613653?v=4&s=48" width="48" height="48" alt="mcinteerj"> <img

src="https://avatars.githubusercontent.com/u/13782141?v=4&s=48" width="48" height="48" alt="samzong"> <img

src="https://avatars.githubusercontent.com/u/7957943?v=4&s=48" width="48" height="48" alt="chilu18"> <img

src="https://avatars.githubusercontent.com/u/6668014?v=4&s=48" width="48" height="48" alt="darkamenosa"> <a

href="https://github.com/widingmarcus-cyber"><img src="https://avatars.githubusercontent.com/u/245375637?v=4&s=48" width="48" height="48"

alt="widingmarcus-cyber"> <img src="https://avatars.githubusercontent.com/u/38732970?v=4&s=48" width="48"

height="48" alt="cgdusek"> <img src="https://avatars.githubusercontent.com/u/1013690?v=4&s=48" width="48"

height="48" alt="Lukavyi"> <img src="https://avatars.githubusercontent.com/u/47308254?v=4&s=48"

width="48" height="48" alt="davidrudduck"> <img src="https://avatars.githubusercontent.com/u/3279061?v=4&s=48"

width="48" height="48" alt="VACInc"> <img src="https://avatars.githubusercontent.com/u/26067127?v=4&s=48"

width="48" height="48" alt="MoerAI"> <img src="https://avatars.githubusercontent.com/u/126378?v=4&s=48"

width="48" height="48" alt="velvet-shark"> <img

src="https://avatars.githubusercontent.com/u/1485873?v=4&s=48" width="48" height="48" alt="HenryLoenwind"> <a

href="https://github.com/omarshahine"><img src="https://avatars.githubusercontent.com/u/10343873?v=4&s=48" width="48" height="48"

alt="omarshahine"> <img src="https://avatars.githubusercontent.com/u/31819391?v=4&s=48" width="48"

height="48" alt="bohdanpodvirnyi"> <img

src="https://avatars.githubusercontent.com/u/69280208?v=4&s=48" width="48" height="48" alt="Verite Igiraneza"> <a

href="https://github.com/akramcodez"><img src="https://avatars.githubusercontent.com/u/179671552?v=4&s=48" width="48" height="48"

alt="akramcodez"> <img src="https://avatars.githubusercontent.com/u/6857108?v=4&s=48" width="48" height="48"

alt="Kaneki-x"> <img src="https://avatars.githubusercontent.com/u/261339948?v=4&s=48" width="48"

height="48" alt="aether-ai-agent"> <img src="https://avatars.githubusercontent.com/u/8200873?v=4&s=48"

width="48" height="48" alt="joaohlisboa"> <img

src="https://avatars.githubusercontent.com/u/255777700?v=4&s=48" width="48" height="48" alt="MaudeBot"> <a

href="https://github.com/davidguttman"><img src="https://avatars.githubusercontent.com/u/431696?v=4&s=48" width="48" height="48"

alt="davidguttman"> <img src="https://avatars.githubusercontent.com/u/252443740?v=4&s=48" width="48"

height="48" alt="justinhuangcode"> <img src="https://avatars.githubusercontent.com/u/39320777?v=4&s=48"

width="48" height="48" alt="lml2468"> <img src="https://avatars.githubusercontent.com/u/165846?v=4&s=48"

width="48" height="48" alt="wirjo"> <img src="https://avatars.githubusercontent.com/u/25069719?v=4&s=48"

width="48" height="48" alt="iHildy"> <img src="https://avatars.githubusercontent.com/u/220262?v=4&s=48"

width="48" height="48" alt="mudrii"> <img

src="https://avatars.githubusercontent.com/u/66044327?v=4&s=48" width="48" height="48" alt="advaitpaliwal"> <a

href="https://github.com/czekaj">czekaj <a

href="https://github.com/dlauer">dlauer <a

href="https://github.com/Solvely-Colin"><img src="https://avatars.githubusercontent.com/u/211764741?v=4&s=48" width="48" height="48"

alt="Solvely-Colin"> <img src="https://avatars.githubusercontent.com/u/676637?v=4&s=48" width="48"

height="48" alt="feiskyer"> <img src="https://avatars.githubusercontent.com/u/21148772?v=4&s=48"

width="48" height="48" alt="brandonwise"> <img

src="https://avatars.githubusercontent.com/u/249891?v=4&s=48" width="48" height="48" alt="conroywhitney"> <a

href="https://github.com/mneves75">mneves75 <a

href="https://github.com/jaydenfyi">jaydenfyi

davemorin

joeykrug

<img src="https://avatars.githubusercontent.com/u/118158941?v=4&s=48" width="48" height="48"

alt="kevinWangSheng"> <img src="https://avatars.githubusercontent.com/u/481729?v=4&s=48" width="48"

height="48" alt="pejmanjohn"> <img src="https://avatars.githubusercontent.com/u/2156642?v=4&s=48" width="48"

height="48" alt="Lanfei"> <img src="https://avatars.githubusercontent.com/u/1192888?v=4&s=48" width="48"

height="48" alt="liuy"> <img src="https://avatars.githubusercontent.com/u/2609441?v=4&s=48" width="48"

height="48" alt="lc0rp"> <img src="https://avatars.githubusercontent.com/u/6959299?v=4&s=48" width="48"

height="48" alt="teconomix"> <img src="https://avatars.githubusercontent.com/u/32237905?v=4&s=48" width="48"

height="48" alt="omair445"> <img src="https://avatars.githubusercontent.com/u/35905596?v=4&s=48"

width="48" height="48" alt="dorukardahan"> <img src="https://avatars.githubusercontent.com/u/3399869?v=4&s=48"

width="48" height="48" alt="mmaps"> <img src="https://avatars.githubusercontent.com/u/711564?v=4&s=48"

width="48" height="48" alt="Tobias Bischoff"> <img

src="https://avatars.githubusercontent.com/u/131381638?v=4&s=48" width="48" height="48" alt="adhitShet"> <img

src="https://avatars.githubusercontent.com/u/7780875?v=4&s=48" width="48" height="48" alt="pandego"> <a

href="https://github.com/bradleypriest"><img src="https://avatars.githubusercontent.com/u/167215?v=4&s=48" width="48" height="48"

alt="bradleypriest"> <img src="https://avatars.githubusercontent.com/u/2365676?v=4&s=48" width="48"

height="48" alt="bjesuiter"> <img src="https://avatars.githubusercontent.com/u/1573959?v=4&s=48" width="48"

height="48" alt="grp06"> <img src="https://avatars.githubusercontent.com/u/63901551?v=4&s=48" width="48"

height="48" alt="shadril238"> <img src="https://avatars.githubusercontent.com/u/62210496?v=4&s=48" width="48"

height="48" alt="kesku"> <img src="https://avatars.githubusercontent.com/u/19365375?v=4&s=48" width="48"

height="48" alt="YuriNachos"> <img src="https://avatars.githubusercontent.com/u/20596261?v=4&s=48"

width="48" height="48" alt="vrknetha"> <img

src="https://avatars.githubusercontent.com/u/33181301?v=4&s=48" width="48" height="48" alt="smartprogrammer93"> <a

href="https://github.com/Nachx639">nachx639 <a

href="https://github.com/jnMetaCode">jnMetaCode

<img src="https://avatars.githubusercontent.com/u/41450967?v=4&s=48" width="48" height="48"

alt="Phineas1500"> <img src="https://avatars.githubusercontent.com/u/17723822?v=4&s=48" width="48"

height="48" alt="dingn42"> <img src="https://avatars.githubusercontent.com/u/47098938?v=4&s=48"

width="48" height="48" alt="geekhuashan"> <img

src="https://avatars.githubusercontent.com/u/44753291?v=4&s=48" width="48" height="48" alt="Nanako0129"> <a

href="https://github.com/AytuncYildizli"><img src="https://avatars.githubusercontent.com/u/47717026?v=4&s=48" width="48" height="48"

alt="AytuncYildizli"> <i