원격 Gateway로 OpenClaw.app 실행하기

OpenClaw.app은 SSH 터널을 통해 원격 Gateway에 연결합니다. SSH LocalForward는 로컬 포트를 원격 호스트의 Gateway WebSocket 포트에 매핑합니다.

flowchart TB
    subgraph Client["클라이언트 머신"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(로컬 포트)"]
        T["SSH 터널"]

        A --> B
        B --> T
    end
    subgraph Remote["원격 머신"]
        direction TB
        C["Gateway WebSocket"]
        D["ws://127.0.0.1:18789"]

        C --> D
    end
    T --> C

설정

1. LocalForward 18789 127.0.0.1:18789가 포함된 SSH 설정 항목을 추가합니다(전체 설정 블록은 원격 액세스 참조).
2. ssh-copy-id를 사용하여 SSH 키를 원격 호스트에 복사합니다.
3. openclaw config set gateway.remote.token "<your-token>"을 사용하여 gateway.remote.token(또는 gateway.remote.password)을 설정합니다.
4. 터널을 시작합니다: ssh -N remote-gateway &.
5. OpenClaw.app을 종료한 후 다시 엽니다.

재부팅 후에도 유지되고 자동으로 다시 연결되는 터널을 사용하려면 수동 ssh -N 대신 원격 액세스 페이지의 LaunchAgent 설정을 사용하세요.

작동 방식

OpenClaw.app은 클라이언트의 ws://127.0.0.1:18789에 연결합니다. 터널은 해당 연결을 Gateway가 실행 중인 원격 호스트의 포트 18789로 전달합니다.

관련 문서

• 원격 액세스
• Tailscale