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/를 열고 token 붙여넣기

단계별 VPS 가이드: exe.dev

설치

Gateway

Gateway 서비스 설치 (CLI)

다음 중 하나를 사용하세요:

openclaw onboard --install-daemon

또는:

openclaw gateway install

또는:

openclaw configure

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

복구/마이그레이션:

openclaw doctor

시스템 제어 (systemd user unit)

OpenClaw는 기본적으로 systemd user 서비스를 설치합니다. 공유 또는 상시 가동 서버에는 system 서비스를 사용하세요. 전체 unit 예시 및 안내는 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
← 문서로 돌아가기