exe.dev

목표: exe.dev VM에서 OpenClaw Gateway를 실행하고 https://<vm-name>.exe.xyz에서 접근할 수 있도록 합니다. 이 가이드에서는 exe.dev의 기본 exeuntu 이미지를 사용한다고 가정합니다. 다른 배포판에서는 패키지를 알맞게 대응하여 설치하세요.

필요한 항목

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

초보자를 위한 빠른 경로

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

Shelley를 사용한 자동 설치

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

이 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 생성

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

ssh exe.dev new

그런 다음 연결합니다.

ssh <vm-name>.exe.xyz

이 VM을 상태 유지형으로 보존하세요. OpenClaw는 openclaw.json, 에이전트별 auth-profiles.json, 세션 및 채널/제공자 상태를 ~/.openclaw/ 아래에 저장하고, 작업 공간은 ~/.openclaw/workspace/ 아래에 저장합니다.

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

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

OpenClaw 설치

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

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

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

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에서 서비스 환경에 필요한 비밀 값이 포함되도록 합니다.

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

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

// 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 } },
      },
    },
  },
}

ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --dry-run' < ./openclaw.remote.patch.json5
ssh <vm-name>.exe.xyz 'openclaw config patch --stdin' < ./openclaw.remote.patch.json5
ssh <vm-name>.exe.xyz 'openclaw gateway restart && openclaw health'

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

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로 전달됩니다.

업데이트

openclaw update

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

Install overview

Maintenance

Containers

Hosting

Advanced setup

필요한 항목

초보자를 위한 빠른 경로

Shelley를 사용한 자동 설치

수동 설치

원격 채널 설정

원격 접근

업데이트

관련 문서

​필요한 항목

​초보자를 위한 빠른 경로

​Shelley를 사용한 자동 설치

​수동 설치

​원격 채널 설정

​원격 접근

​업데이트

​관련 문서

필요한 항목

초보자를 위한 빠른 경로

Shelley를 사용한 자동 설치

수동 설치

원격 채널 설정

원격 접근

업데이트

관련 문서