Skip to content

agentkernel/openclaw-desktop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenClaw Desktop

OpenClaw Desktop – Windows Installer & Native Desktop App for OpenClaw AI Agents

Official-style desktop installer & Windows distribution for OpenClaw. Part of the OpenClaw ecosystem.
OpenClaw 小龙虾官方桌面版一键安装部署 EXE 程序。

This project provides a one-click desktop installer for OpenClaw on Windows, packaging the official OpenClaw runtime with a native desktop experience.

If this project helps you, please give it a star!
如果这个项目对你有帮助,请点一个 Star 让更多人看到!

Run OpenClaw on Windows with a native GUI, bundled runtime, guided setup wizard, built‑in updater, and a downloadable .exe installer.
在 Windows 上通过原生桌面 GUI、内置运行时、引导式安装向导和可下载的 .exe 安装程序,一键运行 OpenClaw。

OpenClaw Desktop Demo running an AI agent on Windows

OpenClaw Desktop Windows installer user scope options

OpenClaw Desktop first-run setup wizard on Windows

OpenClaw Control gateway dashboard running on Windows

Latest release CI Release workflow Downloads License

简体中文 / ChineseDownloadWhy it existsFeaturesQuick startDevelopmentFAQ

OpenClaw Desktop is a Windows distribution that packages the upstream OpenClaw runtime into an easier desktop experience. Part of the broader OpenClaw ecosystem.

Download

Primary download: GitHub Releases
主要下载渠道: GitHub Releases

  • Installer filename / 安装包文件名: OpenClaw-Setup-0.1.0.exe
  • Target platform / 适用系统: Windows 10/11 x64
  • Includes / 包含内容: Electron shell, bundled Node.js runtime, bundled OpenClaw package
  • Also published / 同时发布: checksum file and latest.yml for in-app updates

How to install OpenClaw on Windows?

OpenClaw is a powerful open-source AI agent project, but many users wonder how to install OpenClaw on Windows, how to run OpenClaw locally, or how to get an OpenClaw Windows installer without a terminal‑only setup flow.

OpenClaw Desktop turns that into a normal desktop install experience:

  • Download one installer instead of wiring everything manually
  • Launch from Start Menu or Desktop shortcut
  • Configure providers, channels, and gateway from a visual setup wizard
  • Update from GitHub Releases without reinstalling from scratch each time

This project is the ideal OpenClaw Windows installer, OpenClaw desktop app, and OpenClaw GUI for your AI agents.

Features

  • Native Windows installer with Start Menu and Desktop shortcuts
  • Guided setup wizard for model, channel, gateway, and API key configuration
  • Bundled Node.js runtime so system-wide Node.js is not required
  • Bundled OpenClaw runtime for fast first launch
  • Built-in update flow based on GitHub Releases and electron-updater
  • Update center with health checks, bundle verification, rollback guidance, and diagnostics
  • System tray integration and auto-start at login
  • Multi-language UI: English, 简体中文, 繁體中文, 日本語, 한국어, Español, Français
  • Support for 50+ AI providers and multiple channels including Telegram, Discord, Slack, WhatsApp, and Feishu

Quick Start

  1. Download the latest installer from Releases.
  2. Run OpenClaw-Setup-0.1.0.exe.
  3. Finish the installation wizard and launch OpenClaw Desktop.
  4. Complete the first-run setup for your model provider and gateway.
  5. Start using OpenClaw from a native Windows desktop shell.

System requirements:

  • Windows 10/11 x64
  • Around 350 MB free disk space
  • Internet connection for model API calls and update checks

OpenClaw Ecosystem

            OpenClaw
                |
    ----------------------------
    |            |            |
 Desktop        GUI        Plugins
    |
Installer

Related Projects:

Release Assets

Every release is intended to expose the Windows installer in the most obvious place for end users:

  • OpenClaw-Setup-<version>.exe: the installer most users should download
  • OpenClaw-Setup-<version>.exe.sha256: checksum for manual verification
  • latest.yml or latest-beta.yml: metadata consumed by the in-app updater

Architecture

OpenClaw Desktop
├─ Electron main process
├─ React renderer UI
├─ Preload bridge and IPC layer
├─ Gateway process manager
├─ Update service
└─ Bundled resources
   ├─ portable Node.js runtime
   └─ bundled OpenClaw package

More detail:

Development

Prerequisites:

  • Node.js >= 22.12.0
  • pnpm
  • Windows 10/11 for packaging and end-to-end validation
git clone https://github.com/agentkernel/openclaw-desktop.git
cd openclaw-desktop
pnpm install
pnpm dev

Useful commands:

pnpm lint
pnpm type-check
pnpm build
pnpm run download-node
pnpm run download-openclaw
pnpm run prepare-bundle
pnpm run package:win

Build output:

  • dist/OpenClaw-Setup-<version>.exe

Project Structure

openclaw-desktop/
├─ src/
│  ├─ main/
│  ├─ preload/
│  ├─ renderer/
│  └─ shared/
├─ scripts/
├─ resources/
├─ build/
└─ .github/workflows/

FAQ

Is this part of the OpenClaw ecosystem?

Yes, this is an official-style desktop distribution that packages upstream OpenClaw into a Windows desktop shell for an easier local setup.

Do I need Node.js installed globally?

No. The installer bundles a portable Node.js runtime that is shipped with the application.

Where do I download the EXE?

Use the latest release page: github.com/agentkernel/openclaw-desktop/releases/latest. The main asset is OpenClaw-Setup-<version>.exe.

Where is my data stored?
  • OpenClaw config: %USERPROFILE%\.openclaw\openclaw.json
  • Desktop shell config: %APPDATA%\OpenClaw Desktop\config.json
  • Logs: %USERPROFILE%\.openclaw\
  • Backups: %USERPROFILE%\.openclaw\backups\

Uninstalling the app does not delete user configuration by default.

How do updates work?

The app checks GitHub Releases and can download updates through the built-in updater. Release assets also remain available for manual download and rollback.

Community & Support

Star History

If this project helps you run OpenClaw, please consider giving us a star!

Contributors

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

Community

Join our Discussions to ask questions, showcase what you've built, or request new features.

Keywords / 搜索关键词

OpenClaw Desktop · OpenClaw Windows · OpenClaw installer · OpenClaw Windows installer · OpenClaw desktop app · OpenClaw GUI · how to install OpenClaw on Windows · run OpenClaw locally · OpenClaw 桌面版 · OpenClaw Windows 安装器 · OpenClaw 安装教程

License

GPL-3.0

About

OpenClaw Desktop – One-click .exe Windows installer & native desktop distribution for the OpenClaw autonomous AI agent framework. Run, update, and manage OpenClaw locally with ease. OpenClaw小龙虾官方桌面版一键安装部署EXE程序

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors