Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

76,271 Commits

Repository files navigation

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

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

CI statusnpm versionNode.js versionLicense: MITDiscord

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

See the installation guide for npm 12 lifecycle-script requirements, Docker, Nix, and other deployment paths.

Quick start

openclaw onboard --install-daemon
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, 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

GoalStart here
Configure models and authModels · Model providers
Connect a messaging serviceChannels
Add tools, skills, and pluginsTools · Skills · Plugins · ClawHub
Run apps and device nodesPlatforms · Nodes
Use the CLI and chat commandsCLI reference · Slash commands
Configure or operate the GatewayConfiguration · 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, soul.md, Peter's site, Star History, and @openclaw.

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

Sponsors

OpenAIGitHubNVIDIAVercelBlacksmithConvex

Contributors

Thanks to all clawtributors:

steipetevincentkocTakhoffmanobviyusgumadeirasMariano Belinkyvignesh07joshavantscoootscooobjacobtomlinsonshakkernerdsebslighttyler6204ngutmanthewilloftheshadowSid-QinmcaxtreleqtrizitBunsDevcpojerGlucksbergosolmazbmendonca3jalehmanhuntharoneeravmakwanaopenperfjoshp123pgondhi987altaywtfquotentirolerliuxiaopai-airodrigourozfrankekndrobison00zerone0xonutcademczukImLukeFhydro13hxy91819coygeekdutifulbobsliverpElonitorobbyczgw-clajoelnishanthechoVicsallyomyinghaosangBradGrouxchristianklotzodysseus0hclsysbyungskerpashpashpashstakeswkygithub-actions[bot]xinhuaguMonkeyLeeT100yenadminmcinteerjsamzongchilu18darkamenosawidingmarcus-cybercgdusekLukavyidavidrudduckVACIncMoerAIvelvet-sharkHenryLoenwindomarshahinebohdanpodvirnyiVerite IgiranezaakramcodezKaneki-xaether-ai-agentjoaohlisboaMaudeBotdavidguttmanjustinhuangcodelml2468wirjoiHildymudriiadvaitpaliwalczekajdlauerSolvely-Colinfeiskyerbrandonwiseconroywhitneymneves75jaydenfyidavemorinjoeykrugkevinWangShengpejmanjohnLanfeiliuylc0rpteconomixomair445dorukardahanmmapsTobias BischoffadhitShetpandegobradleypriestbjesuitergrp06shadril238keskuYuriNachosvrknethasmartprogrammer93nachx639jnMetaCodePhineas1500dingn42geekhuashanNanako0129AytuncYildizliBruceMacDjjjojojmvanhornbugkill3rrahthakorGodsBoySARAMALI15792Radek PacltElarwei001ingyukohSnowSky1lewiswigmoreHiroshi TanakaaldoeliacimJakub RuszTony Dehnkeroshanasingh4zssggle-rgbadam91holtgraysurfxadenryansfo2001Jamieson O'Reillyhsrvctomsun28BillChiricocarrotRakkoranausmanaiarkyu2077hoyyevaluoyanglangsibblgregmousseausahilsatralkarakosczrrenamedYuzuruSHongwei Mamitchmcalisterjuanpablodlcshtse8thebenignhackernimbleenigmaLinux2010shichangsefe-arvHsiao Anabbilkhanayanesakuralupuleticpoloooooxaeon2026shrey150taw0002dinakars777giulio-leonenyanjoumeaningfoolkunalk16ide-reaJonathan Jingyelogmarkmussonkiranvk-2011Sathvik Veerapanenirogerdigitalartwalkerazade-cchinar-amrutkarmaxsumrallMinidoracatunisonely85206559Sam PadillaAnonO6afurm황재원Leszek SzpunarMrseenzYida-Devkesormazhe-nerdHarald BuerbaumermagimetalHiren PatelBinHPdevRyanLee-Devcathrynlaveryal3martJustYanniccabhisekbasu1dbhurleyKris WutmimmanuelJustasMSimantak DabhadeNicholasSpisaknatefikrudunamismaxSimone MacarioENCHIGOxingsy97emontyjadilson12Yi-Cheng WangMathias NaglerSean McLellangumclawRichardCaoMKV21petter-bCodeForgeNetJohnson ShidurenzidudougvkWhoaa512zimegTseka LukRyan HainesufhyDaan van der PlasbittobyXuHaoLucenx9HeMulingAaronLuo00YUJIE2002DhruvBhatia0Divanoli Mydeen PitchaiBronkorubyrunsstuffrabsef-bicrymIVY-AI-gifpvtclawnstephenschoettlerDale BabiyLeftXDavid GelbergEngr. Arif Ahmed JoyMasataka Shinohara2233adminameno-battman21bchernybobashopcashierdguidodruide67guirguispierrejzakirovloganpritmartinfrancoisneo1027144-creatorRealKai42schumilinshuofengzhangsolsteadhengm3467chziyueJames L. Cowan Jr.scifantasticryan-crabbealexfilatovLuckymingxuanHollyChoubadlogicDaniel Hnykdan bachelderheavenlostshad0wca7JaredkiranjdMarsKimseheepeaktsavoMcRolly NWANGWUdashedShuai-DaiDaiSubash NatarajanemanuelstmagendaryLI SHANXINj2h4ubsormagecmjamivLalit SinghJessy LANGEbuddyhAaron ZhuF_oolBen SteinLylePingpopomoreDithillifal3mkbehrmteam88gupsammyShaileshGarnet LiuThorfinnProtocol-zero-0Paul van OorschotPatrick Yingxi PanPtah.ai정우용artuskgAnandesh-Sharmazidongdesigninnocent-childrenEl-Fitzarthurbr11jackheubergerSergiuszXu Guhyojinjeann2013jogelinrmorsescz2011AndyliubenithorsxiwuqiAlvinAARON AGENTDerek YUMarvinAndrew Jeonstain luOpenCilsStefan GalescuSPMichael FlanaganGracie Gouldcash-echo-botvisionikWalterSumbonhuangcjkrizpoonrodbland2021Thomas Msar618fagemxdaymadeTyson CungIgor MarkelovEng. Juan CombettoconnorsheabonaldKeenannachoiacovinozhumengzhuAmine Harch el koranezhoulc777Alex NavarroTanwa ArpornthipTIHUAftabbsAlex-Alanizjarvis-medmaticTom Ronday253JaaneekJustin Songziomancershayan919293EdwardRoger ChienMichael LeeTomáš DinhIan DerringtonLuckypescheeHarry Cui KeplerjulianengelmarkfietjeDakshay MehtaTheRipperDominicdanielwanwxSeungwoo hongYouyou972boris721damoahdominicdan-drdoodlewindkkarimibrokemac79ozbillwangRavish GuptaJason HargroveBrianWang1990Joshua McKiddyFologanAnonymous Amitv1p0rAjay ElikaIranbYonatancodexGWShaun TsaiTideFinderChase Dorseytda0xJonHoldsCryptoakyourowngamesclawdinator[bot]koala73sircrumpetthesomewhatyouzatsAccunzaJoly0HannaJeremiah Lowinpeetzweg/Skyler MiaotumfHiago SilvaNatelidamao633CkleeCornBrother0xDukeDeSouthSahanCashWilliamsFelix LuAdeboyeDNRohan Santhosh KumarSrinivas Pavanh0tpNeoTianworldneverlandasklee-klawdYuting Linconstansinoghsmcibrahimq21irtiq7kelvinCBmitsuhikonohatsantiagomedsuminhthanhsvkozak张哲芳Ho LimTovenR. Desmond游乐场ReedAditya ChaudharySamAndyRajat Joshicyb1278588254Zoher GhadyaliManik VahsithtaroucaMrBrainDaniel ZouLiloJasonSUMUKHBakhtier SizhaevGanghyun KimAkashKobalBrianwu-tian807Vasanth Rao Naik SabavatKinfeyArtemiiVibhorGautamJohn Roodvelamints2Benji PengJINNYEONG KIMRahul kumar PalRockcentLimitless24601awkoydawondyifrawgoogle-labs-jules[bot]henrino3Kansodatakaonashp6l-richardpi0skainguyen1412StarhappyshxdangerPenchanscaldSerhiiaDoğu Abarisysqanderandranik-sahakyanWangnovAustinlisitanRishi VhavleFrank HarrisKenny LeeAlice LosassoedincamparaFelix HellströmVarun Choprawangai-studiosleontenkoYassine AmjadAnton EicherDrake ThomsenHinata Kaga (samon)andreabadessochenxin-yancordx56dvrshilMarvinCuiYeom-JinHoJeremy MumfordCharlie NiñoSharoon SharifOrenMattQParker Todd BrooksYufeng HeMilofaxSteve (OpenClaw)zhoulf1006JonatanSebastian B OtaeguiMatthewABFS TechalexstylEthan PalmQkalcygaarUmut CANJakobantonsaustinm911mahmoudashraf93philipp-spiesspkrmfjoshrad-devfactnest365-opsyingchunbaiAJ (@techfren)Marchel FahrezifuthgarZhangRémiDan BallanceEric SuKimitaka WatanabeJustin LingRaymond Bergerlutr0claudeAngryBirdFabian Williams0x4C338BlTatalovesyouerikpr1994jonasjancariklongmabamitschabaude-botthesashMaxeasternblocchrisrodzgabriel-trigomanmalneistwes-davismanuelhettichsktbrdlarlyssapcty-nextgen-service-accountSyhidstmchowMarc GratchxtaoJackyWayJosh PhillipsT5-AndyMLhuohua-devimfingRandy TorresMarco Di DionisioiamadighumanwrittenRob AxelsenPratham Dubey0oAstroaaronnArturoAsleep123dantelexfcatuhegtsifrikashrdwdmrblhugobaraunajayhickeyjiulingyunJonathan D. Rhyne (DJ-D)jverdikitzeloukotalminghinmatthewlamMSchodrobnikoswalpalashratulsarnareeltimeappssnopokesreekaransrinathtimkrase

License

MIT © OpenClaw Foundation. See THIRD_PARTY_NOTICES.md for incorporated or adapted code.

About

Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages