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

설치¶

• 시작하기
• 설치 및 업데이트
• 선택적 흐름: Bun (실험적), Nix, Docker

Gateway(게이트웨이)¶

• Gateway(게이트웨이) 런북
• 구성

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

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

openclaw onboard --install-daemon

또는:

openclaw gateway install

또는:

openclaw configure

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

복구/마이그레이션:

openclaw doctor

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

OpenClaw 는 기본적으로 systemd 사용자 서비스를 설치합니다. 공유 또는 상시 실행 서버의 경우 시스템 서비스를 사용하십시오. 전체 유닛 예제와 가이드는 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