OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

exe.dev

목표: exe.dev VM에서 OpenClaw Gateway를 실행하고 https://<vm-name>.exe.xyz에서 접근할 수 있도록 합니다.

이 가이드에서는 exe.dev의 기본 exeuntu 이미지를 사용한다고 가정합니다. 다른 배포판에서는 패키지를 알맞게 대응하여 설치하세요.

필요한 항목

  • exe.dev 계정
  • exe.dev VM에 대한 ssh exe.dev 접근 권한(수동 설정 시 선택 사항)

초보자를 위한 빠른 경로

  1. https://exe.new/openclaw을 엽니다.
  2. 필요에 따라 인증 키/토큰을 입력합니다.
  3. VM 옆의 "Agent"를 클릭하고 Shelley가 프로비저닝을 완료할 때까지 기다립니다.
  4. https://<vm-name>.exe.xyz/를 열고 구성된 공유 비밀 값으로 인증합니다(기본값은 토큰 인증이며, gateway.auth.mode를 전환하면 비밀번호 인증도 사용할 수 있습니다).
  5. openclaw devices approve <requestId>로 대기 중인 기기 페어링 요청을 승인합니다.

Shelley를 사용한 자동 설치

exe.dev의 에이전트인 Shelley는 프롬프트를 통해 OpenClaw를 설치할 수 있습니다.

text
이 VM에 OpenClaw(https://docs.openclaw.ai/install)를 설정하세요. OpenClaw 온보딩에는 비대화형 및 위험 승인 플래그를 사용하세요. 필요에 따라 제공된 인증 정보 또는 토큰을 추가하세요. 기본 활성화 사이트 구성에서 기본 포트 18789를 루트 위치로 전달하도록 nginx를 구성하고 WebSocket 지원을 반드시 활성화하세요. 페어링은 "openclaw devices list" 및 "openclaw devices approve <request id>"로 수행합니다. 대시보드에 OpenClaw의 상태가 정상으로 표시되는지 확인하세요. exe.dev가 포트 8000에서 포트 80/443으로의 전달과 HTTPS를 대신 처리하므로, 최종적으로 "접근 가능"한 주소는 포트 지정 없이 <vm-name>.exe.xyz여야 합니다.

수동 설치

  • VM 생성

    기기에서 다음을 실행합니다.

    bash
    ssh exe.dev new

    그런 다음 연결합니다.

    bash
    ssh <vm-name>.exe.xyz

  • 필수 구성 요소 설치(VM에서)

    bash
    sudo apt-get updatesudo apt-get install -y git curl jq ca-certificates openssl

  • OpenClaw 설치

    bash
    curl -fsSL https://openclaw.ai/install.sh | bash

  • 포트 8000으로 프록시하도록 nginx 구성

    /etc/nginx/sites-enabled/default를 편집합니다.

    nginx
    server {    listen 80 default_server;    listen [::]:80 default_server;    listen 8000;    listen [::]:8000;     server_name _;     location / {        proxy_pass http://127.0.0.1:18789;        proxy_http_version 1.1;         # WebSocket 지원        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";         # 표준 프록시 헤더        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $remote_addr;        proxy_set_header X-Forwarded-Proto $scheme;         # 장기 연결을 위한 시간 제한 설정        proxy_read_timeout 86400s;        proxy_send_timeout 86400s;    }}

    클라이언트가 제공한 체인을 보존하지 말고 전달 헤더를 덮어쓰세요. OpenClaw는 명시적으로 구성된 프록시의 전달된 IP 메타데이터만 신뢰하며, 추가 방식의 X-Forwarded-For 체인은 보안 강화 위험 요소로 간주됩니다.

  • OpenClaw에 접근하고 기기 승인

    https://<vm-name>.exe.xyz/를 엽니다(온보딩에서 출력된 Control UI 정보를 참조하세요). 인증을 요구하면 VM에 구성된 공유 비밀 값을 붙여 넣습니다.

    이 가이드에서는 기본적으로 토큰 인증을 사용하므로 openclaw config get gateway.auth.token으로 gateway.auth.token을 가져오거나, openclaw doctor --n으로 새 토큰을 생성하세요. Gateway를 비밀번호 인증으로 전환했다면 대신 gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD를 사용하세요.

    openclaw devices list 및 openclaw devices approve <requestId>로 기기를 승인합니다. 확실하지 않다면 브라우저에서 Shelley를 사용하세요.

    • 원격 채널 설정

    원격 호스트에서는 SSH를 통해 config set을 여러 번 호출하는 대신 config patch를 한 번 호출하는 방식을 권장합니다. 실제 토큰은 VM 환경이나 ~/.openclaw/.env에 보관하고, openclaw.json에는 SecretRef만 넣으세요. 전체 SecretRef 계약은 비밀 값 관리를 참조하세요.

    VM에서 서비스 환경에 필요한 비밀 값이 포함되도록 합니다.

    bash
    cat >> ~/.openclaw/.env <<'EOF'SLACK_BOT_TOKEN=xoxb-...SLACK_APP_TOKEN=xapp-...DISCORD_BOT_TOKEN=...OPENAI_API_KEY=sk-...EOF

    로컬 머신에서 패치 파일을 생성하고 VM으로 파이프합니다.

    json5
    // openclaw.remote.patch.json5{  secrets: {    providers: {      default: { source: "env" },    },  },  channels: {    slack: {      enabled: true,      mode: "socket",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      groupPolicy: "open",      requireMention: false,    },    discord: {      enabled: true,      token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },      dmPolicy: "disabled",      dm: { enabled: false },      groupPolicy: "allowlist",    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },      models: {        "openai/gpt-5.6-sol": { params: { fastMode: true } },      },    },  },}
    bash
    ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --dry-run' < ./openclaw.remote.patch.json5ssh <vm-name>.exe.xyz 'openclaw config patch --stdin' < ./openclaw.remote.patch.json5ssh <vm-name>.exe.xyz 'openclaw gateway restart && openclaw health'

    중첩된 허용 목록을 패치 값과 정확히 일치하도록 만들려면 --replace-path를 사용하세요. 예를 들어 Discord 채널 허용 목록을 교체하려면 다음과 같이 실행합니다.

    bash
    ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --replace-path "channels.discord.guilds[\"123\"].channels"' < ./discord.patch.json5

    전체 채널 구성 참조는 Discord 및 Slack을 참조하세요.

    원격 접근

    exe.dev는 원격 접근을 위한 인증을 처리합니다. 기본적으로 포트 8000의 HTTP 트래픽은 이메일 인증을 거쳐 https://<vm-name>.exe.xyz로 전달됩니다.

    업데이트

    bash
    openclaw update

    채널 전환 및 수동 복구 방법은 업데이트를 참조하세요.

    관련 문서

    Was this useful?
    On this page

    On this page