인프런 커뮤니티 질문&답변

빠른 답변 감사드립니다.

openclaw-gateway | 2026-03-14T06:00:31.058+00:00 Gateway failed to start: Error: non-loopback Control UI requires gateway.controlUi.allowedOrigins (set explicit origins), or set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true to use Host-header origin fallback mode

이런 오류 메시지가 출력됩니다

안녕하세요 정호님.

질문주신 내용에 대한 답변을 드려보겠습니다.

openclaw-gateway 설정은 지금 강의에서 안내드린 구조(demo/config, demo/workspace)랑 잘 맞게 작성해 주셨어요.
말씀하신 “Docker Desktop Files 탭에서 접속이 됐다 안 됐다 한다”는 증상은, Mac용 Docker Desktop이 호스트 폴더를 마운트할 때 생기는 이슈일 가능성이 큽니다.

현재 .env를 보면:

OPENCLAW_CONFIG_DIR=./config
OPENCLAW_WORKSPACE_DIR=./workspace

이렇게 상대 경로로 되어 있습니다.
이 자체는 “반드시 demo 폴더 안에서 docker compose up을 실행한다”는 전제에서는 괜찮은데,
Mac에서는 다음 두 가지 때문에 문제가 생길 수 있어요.

1. docker compose up을 실행한 위치가 demo 폴더가 아닐 때

   • 예를 들어 상위 폴더에서 docker compose up을 실행하면,
     Docker 기준 ./config, ./workspace는 다른 실제 위치를 가리키게 됩니다.

   • 이 경우, 컨테이너에 마운트된 경로가 계속 바뀌면서 Files 탭에서 폴더가 보였다 안 보였다 할 수 있습니다.

2. demo 폴더 위치가 Docker Desktop의 File sharing 허용 범위 밖일 때

   • Docker Desktop → Settings → Resources → File sharing에서
     demo 폴더가 위치한 상위 경로(예: /Users/계정명/Projects 등)가 공유 허용으로 등록되어 있지 않으면,
     ./config, ./workspace 바인드 마운트가 실패할 수 있습니다.

   • 이 때도 Files 탭에서는 마치 접속이 불안정한 것처럼 보일 수 있습니다.

그래서 아래 순서로 한 번 점검해 보시면 좋겠습니다:

1. 항상 demo 폴더 안에서만 실행하기

cd /Users/내계정명/path/to/demo
docker compose down
docker compose up -d openclaw-gateway

이렇게 하면 .env에 있는 ./config, ./workspace가 항상 demo/config, demo/workspace를 정확히 가리키게 됩니다.

2. Docker Desktop File sharing 설정 확인 (Mac 전용)

• Docker Desktop → Settings → Resources → File sharing에서
  demo 폴더가 들어 있는 상위 경로(예: /Users/내계정명/Dev, /Users/내계정명/Documents 등)가 목록에 포함돼 있는지 확인해 주세요.

• 없다면 추가 후 Apply & Restart를 눌러 Docker를 재시작합니다.

3. Files 탭에서 보는 경로 확인

• 컨테이너 내부 기준으로:

  • /home/node/.openclaw → demo/config와 연결 (설정, 내부 workspace 등)

  • /home/node/workspace → demo/workspace와 연결 (실제 강의에서 쓰는 작업 폴더)

• Files 탭에서 주로 /home/node/workspace 아래를 보시고,
  demo/workspace에 파일을 하나 만들어서 양쪽에서 같이 보이는지 확인해 주세요.

이렇게 했을 때도 Files 탭 접속이 계속 들쭉날쭉하다면,
Mac Docker Desktop 버전 문제나, iCloud/보안 소프트웨어 쪽 간섭 가능성도 있을텐데,

docker-compose logs -f 명령으로 오류 메시지가 표시되는게 있는지 확인해보시고, 오류 메시지를 보여주시면 다시 한번 분석을 해보겠습니다.

해결 되시길 바랄게요!

감사합니다!

안녕하세요, 인프런 AI 인턴입니다. 이정호님.

도커 컨테이너의 상태가 “Restarting”으로 표시되며 파일 탭에 오류가 발생하는 상황에 대해 도움을 드리고자 합니다. 일반적으로 “Restarting” 상태는 컨테이너 내부에서 오류가 발생하고, 이에 따라 자동으로 재시작을 시도하는 경우입니다. 이 문제를 해결하기 위해 몇 가지 체크포인트를 확인해 보세요.

문제 해결 방법:

1. 로그 확인
   가장 먼저 해야 할 일은 도커 컨테이너 내의 로그를 확인하는 것입니다. 다음 명령어로 로그를 확인할 수 있습니다:

   docker logs openclaw-gateway
   

   로그를 통해 오류 메시지나 경고를 확인할 수 있으며, 이것이 문제를 해결하는 데 도움이 될 수 있습니다.

2. 환경 변수 확인
   사용하고 있는 환경 변수들이 올바르게 설정되어 있는지 확인해 보세요. 특히 OPENCLAW_GATEWAY_TOKEN과 같은 중요한 변수가 올바르게 설정되어 있는지 체크하세요.

3. 포트 사용 확인
   3000포트가 다른 프로세스에 의해 이미 사용되고 있는지 확인해 보세요. 포트 충돌이 발생하는 경우 다른 포트를 사용하도록 컨테이너 설정을 변경할 수 있습니다.

4. 볼륨 설정 확인
   설정한 볼륨 경로(./config 및 ./workspace)가 OS에서 접근 가능한지, 경로가 올바르게 설정되어 있는지 확인하세요. 만약 경로가 없거나 접근할 수 없는 경우 오류가 발생할 수 있습니다.

5. 재시작 정책 확인
   restart: unless-stopped 설정으로 인해 컨테이너가 오류 발생 시 자동으로 재시작을 시도하고 있습니다. 설정을 일시적으로 제거하고 문제의 원인을 안정적으로 파악한 후에 다시 추가하는 것도 방법입니다.

유사 사례 첨부

유사한 문제가 다루어진 답변 게시물로는 아래와 같은 사례를 참조할 수 있습니다:

• Docker 컨테이너 오류 및 로그 분석 - Docker 관련 대표적인 문제 해결 사례.
  

위 링크를 통해 Docker 컨테이너의 로그 분석과 관련된 지식 및 경험을 참고하시면 도움이 될 것입니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.