> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux 앱

# Linux 앱

Gateway(게이트웨이)는 Linux 에서 완전히 지원됩니다. **Node 는 권장 런타임입니다**.
Bun 은 Gateway(게이트웨이)에 권장되지 않습니다 (WhatsApp/Telegram 버그).

네이티브 Linux 컴패니언 앱은 계획 중입니다. 구축에 참여하고 싶다면 기여를 환영합니다.

## 초보자 빠른 경로 (VPS)

1. Node 22+ 설치
2. `npm i -g openclaw@latest`
3. `openclaw onboard --install-daemon`
4. 노트북에서: `ssh -N -L 18789:127.0.0.1:18789 <user>@<host>`
5. `http://127.0.0.1:18789/` 를 열고 토큰을 붙여넣기

단계별 VPS 가이드: [exe.dev](/install/exe-dev)

## 설치

* [시작하기](/start/getting-started)
* [설치 및 업데이트](/install/updating)
* 선택적 흐름: [Bun (실험적)](/install/bun), [Nix](/install/nix), [Docker](/install/docker)

## Gateway(게이트웨이)

* [Gateway(게이트웨이) 런북](/gateway)
* [구성](/gateway/configuration)

## Gateway(게이트웨이) 서비스 설치 (CLI)

다음 중 하나를 사용합니다:

```
openclaw onboard --install-daemon
```

또는:

```
openclaw gateway install
```

또는:

```
openclaw configure
```

프롬프트가 표시되면 **Gateway service** 를 선택합니다.

복구/마이그레이션:

```
openclaw doctor
```

## 시스템 제어 (systemd 사용자 유닛)

OpenClaw 는 기본적으로 systemd **사용자** 서비스를 설치합니다. 공유 또는 상시 실행 서버의 경우 **시스템**
서비스를 사용하십시오. 전체 유닛 예제와 가이드는
[Gateway(게이트웨이) 런북](/gateway)에 있습니다.

최소 설정:

`~/.config/systemd/user/openclaw-gateway[-<profile>].service` 생성:

```
[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
```

활성화:

```
systemctl --user enable --now openclaw-gateway[-<profile>].service
```