### Changes

- Runtime/install: raise the supported Node 22 floor to `22.16+` so native SQLite query handling can rely on the `node:sqlite` statement metadata API while continuing to recommend Node 24. (#78921)

- Discord/voice: stream ElevenLabs TTS directly into Discord playback and send ElevenLabs latency optimization as the documented query parameter so spoken replies can start sooner.

- Discord/voice: keep TTS playback running when another user starts speaking, ignore new capture during playback to avoid feedback loops, and downgrade expected receive-stream aborts to verbose diagnostics.

- Telegram: treat successful same-chat `message` tool outbound sends during an inbound telegram turn as delivered when deciding whether to emit the rewritten silent reply fallback (#78685). Thanks @neeravmakwana.

## Install (recommended)

Runtime: **Node 24 (recommended) or Node 22.14+**.

Runtime: **Node 24 (recommended) or Node 22.16+**.

```bash

npm install -g openclaw@latest

## Quick start (TL;DR)

Runtime: **Node 24 (recommended) or Node 22.14+**.

Runtime: **Node 24 (recommended) or Node 22.16+**.

Full beginner guide (auth, pairing, channels): [Getting started](https://docs.openclaw.ai/start/getting-started)

### Node.js Version

OpenClaw requires **Node.js 22.14.0 or later** (LTS). This version includes important security patches:

OpenClaw requires **Node.js 22.16.0 or later** (LTS). This version includes important security patches:

- CVE-2025-59466: async_hooks DoS vulnerability

- CVE-2026-21636: Permission model bypass vulnerability

Verify your Node.js version:

```bash

node --version # Should be v22.14.0 or later

node --version # Should be v22.16.0 or later

```

### Docker Security

"src/index.ts!",

"src/entry.ts!",

"src/cli/daemon-cli.ts!",

"src/infra/kysely-node-sqlite.ts!",

"src/infra/warning-filter.ts!",

"src/infra/command-explainer/index.ts!",

bundledPluginFile("telegram", "src/audit.ts", "!"),

- **Agent-native**: built for coding agents with tool use, sessions, memory, and multi-agent routing

- **Open source**: MIT licensed, community-driven

**What do you need?** Node 24 (recommended), or Node 22 LTS (`22.14+`) for compatibility, an API key from your chosen provider, and 5 minutes. For best quality and security, use the strongest latest-generation model available.

**What do you need?** Node 24 (recommended), or Node 22 LTS (`22.16+`) for compatibility, an API key from your chosen provider, and 5 minutes. For best quality and security, use the strongest latest-generation model available.

## How it works

1. **Tailscale** -- mesh VPN for secure remote access

2. **UFW firewall** -- SSH + Tailscale ports only

3. **Docker CE + Compose V2** -- for the default agent sandbox backend

4. **Node.js 24 + pnpm** -- runtime dependencies (Node 22 LTS, currently `22.14+`, remains supported)

4. **Node.js 24 + pnpm** -- runtime dependencies (Node 22 LTS, currently `22.16+`, remains supported)

5. **OpenClaw** -- host-based, not containerized

6. **Systemd service** -- auto-start with security hardening

Bun blocks dependency lifecycle scripts unless explicitly trusted. For this repo, the commonly blocked scripts are not required:

- `@whiskeysockets/baileys` `preinstall` -- checks Node major >= 20 (OpenClaw defaults to Node 24 and still supports Node 22 LTS, currently `22.14+`)

- `@whiskeysockets/baileys` `preinstall` -- checks Node major >= 20 (OpenClaw defaults to Node 24 and still supports Node 22 LTS, currently `22.16+`)

- `protobufjs` `postinstall` -- emits warnings about incompatible version schemes (no build artifacts)

If you hit a runtime issue that requires these scripts, trust them explicitly:

## System requirements

- **Node 24** (recommended) or Node 22.14+ - the installer script handles this automatically

- **Node 24** (recommended) or Node 22.16+ - the installer script handles this automatically

- **macOS, Linux, or Windows** - both native Windows and WSL2 are supported; WSL2 is more stable. See [Windows](/platforms/windows).

- `pnpm` is only needed if you build from source

Supports macOS and Linux (including WSL). If macOS is detected, installs Homebrew if missing.

</Step>

<Step title="Ensure Node.js 24 by default">

Checks Node version and installs Node 24 if needed (Homebrew on macOS, NodeSource setup scripts on Linux apt/dnf/yum). OpenClaw still supports Node 22 LTS, currently `22.14+`, for compatibility.

Checks Node version and installs Node 24 if needed (Homebrew on macOS, NodeSource setup scripts on Linux apt/dnf/yum). OpenClaw still supports Node 22 LTS, currently `22.16+`, for compatibility.

</Step>

<Step title="Ensure Git">

Installs Git if missing.

Requires PowerShell 5+.

</Step>

<Step title="Ensure Node.js 24 by default">

If missing, attempts install via winget, then Chocolatey, then Scoop. Node 22 LTS, currently `22.14+`, remains supported for compatibility.

If missing, attempts install via winget, then Chocolatey, then Scoop. Node 22 LTS, currently `22.16+`, remains supported for compatibility.

</Step>

<Step title="Install OpenClaw">

- `npm` method (default): global npm install using selected `-Tag`, launched from a writable installer temp directory so shells opened in protected folders such as `C:\` still work

- "npm install -g fails with permissions or PATH issues"

---

OpenClaw requires **Node 22.14 or newer**. **Node 24 is the default and recommended runtime** for installs, CI, and release workflows. Node 22 remains supported via the active LTS line. The [installer script](/install#alternative-install-methods) will detect and install Node automatically - this page is for when you want to set up Node yourself and make sure everything is wired up correctly (versions, PATH, global installs).

OpenClaw requires **Node 22.16 or newer**. **Node 24 is the default and recommended runtime** for installs, CI, and release workflows. Node 22 remains supported via the active LTS line. The [installer script](/install#alternative-install-methods) will detect and install Node automatically - this page is for when you want to set up Node yourself and make sure everything is wired up correctly (versions, PATH, global installs).

## Check your version

```bash

node -v

```

If this prints `v24.x.x` or higher, you're on the recommended default. If it prints `v22.14.x` or higher, you're on the supported Node 22 LTS path, but we still recommend upgrading to Node 24 when convenient. If Node isn't installed or the version is too old, pick an install method below.

If this prints `v24.x.x` or higher, you're on the recommended default. If it prints `v22.16.x` or higher, you're on the supported Node 22 LTS path, but we still recommend upgrading to Node 24 when convenient. If Node isn't installed or the version is too old, pick an install method below.

## Install Node