Prerequisites

• Node.js 24.16.0+ or 26.1.0+
• pnpm
• OpenClaw installed locally and available on PATH

For a non-standard OpenClaw installation:

export OPENCLAW_BIN=/absolute/path/to/openclaw

Deploy on Railway

AgentOS includes a production-oriented Railway deployment path that runs AgentOS and the pinned OpenClaw Gateway in the public application service and runs interactive Chromium in a separate private browser-worker service. The deployment provisions one persistent /data volume for AgentOS/OpenClaw state and a second dedicated /data volume for Chromium profiles, keeps the Gateway on container loopback, initializes Instance Protection from the username and password supplied during deployment, and waits for the private worker and Gateway before passing Railway's healthcheck. The Railway external supervisor owns the Gateway process lifecycle; AgentOS configures and observes OpenClaw through its native Gateway and can request a supervised Gateway restart through the lifecycle API without opening a host terminal.

The official published Railway template provisions both required volumes, generates the internal AgentOS, OpenClaw, and browser-worker secrets automatically, and wires the private worker URL through Railway private networking. The only required operator input is the initial administrator password. See docs/deploy-on-railway.md for the complete runtime, private-networking, and template update model.

After the first deployment:

1. Open the generated Railway domain and sign in with the initial admin credentials.
2. Connect a model/provider from AgentOS Setup Center.
3. Create the first workspace. AgentOS and OpenClaw state will persist across redeploys.

The initial password only creates the account when no Instance Protection state exists. Changing that Railway variable later does not reset or replace the administrator account; use AgentOS account settings to change credentials. After the first successful sign-in, you may remove AGENTOS_INITIAL_ADMIN_PASSWORD from Railway because the protected account is already stored on the volume.

Install

macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/SapienXai/AgentOS/main/install.sh | bash

Windows PowerShell:

iwr https://raw.githubusercontent.com/SapienXai/AgentOS/main/install.ps1 | iex

Or install with a package manager:

```bash pnpm add -g @sapienx/agentos

Build digital workers

• Create and edit workers with role presets such as worker, setup, browser, monitoring, and custom.
• Configure identity, model, heartbeat, file access, install scope, network policy, and operating instructions.
• Maintain OpenClaw-native workspace context through AGENTS.md, SOUL.md, IDENTITY.md, and optional USER.md; keep command guidance in AGENTS.md under ## Tools, curated memory in MEMORY.md/memory/, and AgentOS project docs in docs/, deliverables/, and skills/. Heartbeat cadence is native OpenClaw agent configuration, not a workspace Markdown file.
• Start from presets, import existing setups, or build a worker from scratch.

Package and release

packages/agentos/package.json is the published CLI version source.

pnpm check:release
pnpm smoke:agentos-package
git tag agentos-v0.7.8
git push origin agentos-v0.7.8

The release workflow builds and smoke-tests packages for:

• macOS Apple Silicon;
• macOS Intel;
• Linux x64;
• Windows x64.