2026-07-13 기준 · OpenClaw 2026.7.1 안정 버전 기준 · 시리즈 3/3
결론부터: 이 에러는 버그가 아니라 오픈클로의 보안 가드레일이 정상 작동한 것입니다. 외부 접속이 필요 없다면 openclaw config set gateway.bind loopback, 필요하다면 토큰 인증을 먼저 설정한 뒤 바인딩하면 됩니다. 인증 없이 게이트웨이를 네트워크에 노출하는 설정을 오픈클로가 스스로 거부한 상황이라, "에러를 없애는 법"보다 "왜 막았는지"를 이해하는 게 중요합니다.
증상
--bind lan 이나 gateway.bind 를 loopback 이외 값(lan·tailnet·custom 등)으로 두고 게이트웨이를 시작하면 다음과 같이 거부됩니다:
refusing to bind gateway ... without auth
원인 (한 문장)
루프백(127.0.0.1)이 아닌 주소로 게이트웨이를 열려면 인증 수단(토큰·패스워드, 또는 구성된 trusted-proxy)이 반드시 있어야 하는데, 인증 설정 없이 바인딩을 시도했기 때문입니다.
해결 단계
경우 A — 사실 외부 접속이 필요 없다 (대부분의 개인 사용자)
내 컴퓨터에서만 쓸 거라면 바인딩을 루프백으로 되돌리는 게 정답입니다:
openclaw config set gateway.bind loopback
openclaw gateway restart
경우 B — 다른 기기에서 접속해야 한다
1) 토큰 생성
openssl rand -hex 32
2) 토큰 인증 설정
openclaw config set gateway.auth.mode "token"
openclaw config set gateway.auth.token "생성한-토큰"
3) 그다음에 바인딩 변경 + 재시작
openclaw config set gateway.bind lan
openclaw gateway restart
4) 확인
openclaw gateway status
경우 B의 더 안전한 대안 — 포트를 아예 열지 않기
LAN 노출 대신 Tailscale Serve 같은 사설 터널로 접근하는 방식이 공식적으로 권장됩니다. 공유기 포트포워딩으로 18789 를 인터넷에 여는 것은 인증이 있어도 권하지 않습니다.
관련 보안 주의
이 에러를 만났다는 건 게이트웨이를 네트워크에 노출하기 직전까지 갔다는 뜻입니다. 2026년 초 뉴스화된 오픈클로 보안 사고 상당수가 바로 "인증 없이 열린 게이트웨이" 유형이었고, 그래서 최신 버전은 이 조합을 아예 시작 단계에서 차단합니다. 바인딩·토큰 외에 Docker 샌드박스(Sandbox) 격리, 비루트 계정, DM 허용목록까지 포함한 전체 점검은 오픈클로 보안 체크리스트 글을 보세요. 게이트웨이(Gateway)·채널(Channel) 같은 용어는 AI 에이전트 단어장에 한 문장 비유로 정리돼 있습니다.
에러를 고쳤다면, 이제 일을 시킬 차례
보안 가드레일까지 이해했다면 오픈클로 세팅의 어려운 구간은 다 지났습니다. 이제 에이전트에게 실제 업무(리서치·정리·반복 작업)를 맡기는 단계는 AI 에이전트 강의에서 비개발자 기준으로 이어집니다. 1차시 무료 공개.
FAQ
Q. 인증을 끄고 바인딩만 여는 옵션은 없나요?
A. 없습니다(의도된 설계). 인증 없는 비루프백 바인딩은 시작 자체가 거부되며, 이를 우회하려는 시도는 보안 사고로 직결됩니다.
Q. 토큰을 설정 파일에 그대로 적어도 되나요?
A. 가능하지만, 환경변수 파일로 분리하고 chmod 600 으로 권한을 잠그는 편이 안전합니다. 구체 방법은 보안 체크리스트 글 2번 항목 참고.
Q. 클라이언트에서 AUTH_TOKEN_MISMATCH 가 나요.
A. 접속하는 쪽이 보낸 토큰이 게이트웨이에 저장된 토큰과 다른 경우입니다. openclaw config get gateway.auth.token 으로 값을 확인해 양쪽을 맞추고, 기기 토큰이 꼬였다면 openclaw devices rotate 로 재발급하세요.
이 글은 2026-07-13 기준 OpenClaw 공식 트러블슈팅 문서(docs.openclaw.ai/gateway/troubleshooting)와 GitHub 이슈 #9275 를 교차 확인해 작성했습니다. 버전 업데이트로 명령·설정 키가 바뀔 수 있으니 공식 문서를 함께 확인하세요.