Linux 앱

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

네이티브 Linux 보조 앱은 계획되어 있습니다. 빌드를 돕고 싶다면 기여를 환영합니다.

초보자 빠른 경로(VPS)

1. Node 24를 설치합니다(권장; Node 22 LTS, 현재 22.19+, 호환성을 위해 계속 작동)
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/를 열고 구성된 공유 비밀로 인증합니다(기본값은 토큰; gateway.auth.mode: "password"를 설정한 경우 비밀번호)

전체 Linux 서버 가이드: Linux 서버. 단계별 VPS 예시: exe.dev

설치

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

Gateway

• Gateway 런북
• 구성

Gateway 서비스 설치(CLI)

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

openclaw onboard --install-daemon

또는:

openclaw gateway install

또는:

openclaw configure

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

복구/마이그레이션:

openclaw doctor

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

OpenClaw는 기본적으로 systemd 사용자 서비스를 설치합니다. 공유 서버나 상시 실행 서버에는 시스템 서비스를 사용하세요. openclaw gateway install 및 openclaw onboard --install-daemon은 이미 현재 표준 유닛을 렌더링합니다. 사용자 지정 시스템/서비스 관리자 설정이 필요할 때만 직접 작성하세요. 전체 서비스 가이드는 Gateway 런북에 있습니다.

최소 설정:

~/.config/systemd/user/openclaw-gateway[-<profile>].service를 만듭니다.

[Unit]Description=OpenClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.target [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.target

활성화합니다.

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

메모리 압박 및 OOM 종료

Linux에서는 호스트, VM 또는 컨테이너 cgroup의 메모리가 부족해지면 커널이 OOM 희생 프로세스를 선택합니다. Gateway는 장기 실행 세션과 채널 연결을 소유하므로 희생 대상으로 적합하지 않을 수 있습니다. 따라서 OpenClaw는 가능한 경우 일시적인 자식 프로세스가 Gateway보다 먼저 종료되도록 가중치를 둡니다.

해당 Linux 자식 프로세스 실행의 경우, OpenClaw는 짧은 /bin/sh 래퍼를 통해 자식을 시작합니다. 이 래퍼는 자식 자체의 oom_score_adj를 1000으로 올린 다음 실제 명령을 exec합니다. 자식이 자신의 OOM 종료 가능성만 높이는 것이므로 권한이 필요 없는 작업입니다.

포함되는 자식 프로세스 범위는 다음과 같습니다.

• supervisor가 관리하는 명령 자식,
• PTY 셸 자식,
• MCP stdio 서버 자식,
• OpenClaw가 실행한 브라우저/Chrome 프로세스.

래퍼는 Linux 전용이며 /bin/sh를 사용할 수 없으면 건너뜁니다. 또한 자식 env가 OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false, no 또는 off로 설정된 경우에도 건너뜁니다.

자식 프로세스를 확인하려면:

cat /proc/<child-pid>/oom_score_adj

포함되는 자식의 예상 값은 1000입니다. Gateway 프로세스는 일반 점수, 보통 0을 유지해야 합니다.

권장 systemd 유닛은 OOMPolicy=continue도 설정합니다. 이렇게 하면 일시적인 자식 프로세스가 OOM killer에 의해 선택되어도 Gateway 유닛이 계속 살아 있습니다. 자식 명령/세션은 실패하고 오류를 보고할 수 있지만, systemd가 전체 Gateway 서비스를 실패로 표시하고 모든 채널을 재시작하지 않습니다.

이것이 일반적인 메모리 튜닝을 대체하지는 않습니다. VPS나 컨테이너가 자식을 반복적으로 종료한다면 메모리 제한을 늘리거나, 동시성을 줄이거나, systemd MemoryMax= 또는 컨테이너 수준 메모리 제한과 같은 더 강한 리소스 제어를 추가하세요.

관련 항목

• 설치 개요
• Linux 서버
• Raspberry Pi