Linux 앱

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

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

초보자 빠른 경로 (VPS)

1. Node 24 설치 (권장; Node 22 LTS, 현재 22.16+도 호환성을 위해 동작)
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

게이트웨이

• 게이트웨이 운영 가이드
• 설정

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

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

openclaw onboard --install-daemon

또는:

openclaw gateway install

또는:

openclaw configure

프롬프트에서 Gateway service를 선택하세요.

복구/마이그레이션:

openclaw doctor

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

OpenClaw은 기본적으로 systemd 사용자 서비스를 설치합니다. 공유 또는 상시 가동 서버의 경우 시스템 서비스를 사용하세요. 전체 유닛 예제와 안내는 게이트웨이 운영 가이드에 있습니다.

기본 설정:

~/.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