OpenClaw 한국어 문서

Appearance

Linux 앱 ​

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

네이티브 Linux 동반 앱은 계획 중입니다. 빌드에 도움을 주고 싶다면 기여를 환영합니다.

초보자 빠른 경로 (VPS) ​

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

설치 ​

게이트웨이 ​

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

다음 중 하나를 사용하십시오:

openclaw onboard --install-daemon

또는:

openclaw gateway install

또는:

openclaw configure

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

복구/마이그레이션:

openclaw doctor

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

OpenClaw는 기본적으로 systemd 사용자 서비스를 설치합니다. 공유 또는 항상 켜져 있는 서버에는 시스템 서비스를 사용하십시오. openclaw gateway install과 openclaw onboard --install-daemon은 이미 현재 정규 유닛을 렌더링합니다. 사용자 지정 시스템/서비스 관리자 설정이 필요한 경우에만 수동으로 작성하십시오. 전체 서비스 지침은 게이트웨이 런북에 있습니다.

최소 설정:

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