{
  "title": "Linux App",
  "content": "The Gateway is fully supported on Linux. **Node is the recommended runtime**.\nBun is not recommended for the Gateway (WhatsApp/Telegram bugs).\n\nNative Linux companion apps are planned. Contributions are welcome if you want to help build one.\n\n## Beginner quick path (VPS)\n\n1. Install Node 22+\n2. `npm i -g openclaw@latest`\n3. `openclaw onboard --install-daemon`\n4. From your laptop: `ssh -N -L 18789:127.0.0.1:18789 <user>@<host>`\n5. Open `http://127.0.0.1:18789/` and paste your token\n\nStep-by-step VPS guide: [exe.dev](/platforms/exe-dev)\n\n* [Getting Started](/start/getting-started)\n* [Install & updates](/install/updating)\n* Optional flows: [Bun (experimental)](/install/bun), [Nix](/install/nix), [Docker](/install/docker)\n\n* [Gateway runbook](/gateway)\n* [Configuration](/gateway/configuration)\n\n## Gateway service install (CLI)\n\nSelect **Gateway service** when prompted.\n\n## System control (systemd user unit)\n\nOpenClaw installs a systemd **user** service by default. Use a **system**\nservice for shared or always-on servers. The full unit example and guidance\nlive in the [Gateway runbook](/gateway).\n\nCreate `~/.config/systemd/user/openclaw-gateway[-<profile>].service`:",
  "code_samples": [
    {
      "code": "openclaw onboard --install-daemon",
      "language": "unknown"
    },
    {
      "code": "openclaw gateway install",
      "language": "unknown"
    },
    {
      "code": "openclaw configure",
      "language": "unknown"
    },
    {
      "code": "openclaw doctor",
      "language": "unknown"
    },
    {
      "code": "[Unit]\nDescription=OpenClaw Gateway (profile: <profile>, v<version>)\nAfter=network-online.target\nWants=network-online.target\n\n[Service]\nExecStart=/usr/local/bin/openclaw gateway --port 18789\nRestart=always\nRestartSec=5\n\n[Install]\nWantedBy=default.target",
      "language": "unknown"
    },
    {
      "code": "systemctl --user enable --now openclaw-gateway[-<profile>].service",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h2",
      "text": "Beginner quick path (VPS)",
      "id": "beginner-quick-path-(vps)"
    },
    {
      "level": "h2",
      "text": "Install",
      "id": "install"
    },
    {
      "level": "h2",
      "text": "Gateway",
      "id": "gateway"
    },
    {
      "level": "h2",
      "text": "Gateway service install (CLI)",
      "id": "gateway-service-install-(cli)"
    },
    {
      "level": "h2",
      "text": "System control (systemd user unit)",
      "id": "system-control-(systemd-user-unit)"
    }
  ],
  "url": "llms-txt#linux-app",
  "links": []
}