메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Gateway는 Linux에서 완전히 지원됩니다. Node가 권장 런타임입니다. Gateway에는 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/를 열고 구성된 공유 비밀로 인증합니다(기본값은 토큰, gateway.auth.mode: "password"를 설정한 경우 비밀번호)
전체 Linux 서버 가이드: Linux 서버. 단계별 VPS 예시: exe.dev

​
설치

​
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.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
KillMode=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을 유지해야 합니다. 이는 일반적인 메모리 튜닝을 대체하지 않습니다. VPS 또는 컨테이너가 자식을 반복적으로 종료한다면 메모리 제한을 늘리거나, 동시 실행 수를 줄이거나, systemd MemoryMax= 또는 컨테이너 수준 메모리 제한과 같은 더 강력한 리소스 제어를 추가하세요.

​
관련 항목