환경 및 시행착오 요약
- 운영체제: Windows 11
- 위치: 중국 난징 (만리방화벽 환경)
- VPN: Astrill
- 목표: 텔레그램으로 AI 에이전트 제어
설치 자체는 간단해 보였지만, 중국 네트워크 환경 + Windows 네이티브 한계라는 두 가지 벽에 부딪혔습니다. 이 글은 그 삽질의 기록입니다.
1단계: 일단 설치
설치하는 방법이야 인터넷 상에 워낙 많이 나와 있고, 설명이 잘 되어 있으니 설치 자체는 그리 어렵지 않았습니다.
물론, 각종 API키를 설치하는건 번거롭더라고요.
다른API 키들이야 다 있었으니 상관이 없었는데, 이번엔 인터넷 검색때문에 Brave Search API키도 추가로 설치 했습니다.
※ 원래 제가 사용하던 브라우저도 Brave라서 거부감이 들거나 한건 아닌데, 이것도 API키가 있는줄은 몰랐네요. 혹시나 사용량이 많아지면 유료 서비스로도 연결해야 하는점은 살짝 겁나긴 하는데..
※ 중국 환경에서는 Brave Search를 가장 추천한다고 합니다. 하긴 아무리 VPN을 켜도 Google 서비스는 툭하면 막히니
2단계: 텔레그램 연결 실패
설치 후 실행하자마자 이런 에러가 쏟아졌습니다.
[telegram] fetch fallback: enabling sticky IPv4-only dispatcher (codes=UND_ERR_CONNECT_TIMEOUT)
[telegram] telegram setMyCommands failed: Network request for 'setMyCommands' failed!
[telegram] webhook cleanup failed: Network request for 'deleteWebhook' failed!이건 또 막막하더라고요.
쉽게 찾을수 있는 설치 영상에서는 발생하지도 않는 현상이고 이슈도 없었건만...
그래서 저의 친구 Claude에게 물었더니 바로 가장 가능성 높은 답변을 돌려줬습니다.
원인: 중국의 만리방화벽(GFW)이 Telegram API(`api.telegram.org`)를 차단.
VPN 이 켜져 있었지만, 그럼에도 동작하지는 않더라고요.
3단계: Astrill VPN 프록시 설정
이번에 알게된 개념인데, 이럴때 살펴봐야 하는 것이 Proxy 설정이었습니다.
이야기가 어려워지는데...
프록시(Proxy)는 대신 심부름해주는 중간 대리인이라고 생각하면 된다고 합니다.
직접 가기 어려운 곳에 갈 때, 대리인한테 "나 대신 가서 이거 가져와줘"라고 부탁하는 것과 같아요. 내가 직접 가면 막히지만, 대리인은 다른 경로로 우회해서 다녀올 수 있는 거죠.
그림으로 표현하면 아래와 같은 개념으로 보면 된다고 하네요.
이 프록시를 쓸때 포트 번호를 명확히 해야 하는데, Astrill VPN 같은 경우에는 3213번을 사용하는것이 그 규칙이었습니다. 그리고, 이 규칙을 OS 전체에 부여하여 이 통로를 터널로 뚫는 것이었습니다.
이 프록시 설정 까지도 제대로 되어 있고, VPN도 제대로 동작하는데 아무튼 텔레그램 접속에는 계속 실패 했습니다.
실제 문제의 근본 원인은 node.js가 OS 수준의 네트워크 설정을 우회해서 직접 소켓을 열다보니 VPN에서 기껏 만들어 놓은 통로를 사용하지 않았다는 것이었습니다.
최종적으로는 Claude의 가이드를 받아서 환경변수 만들고, 여기에 프록시 설정을 완료 한 다음에 비로소 텔레그램 연결을 성공할 수 있었습니다.
cat > ~/.openclaw/.env << EOF
HTTPS_PROXY=http://127.0.0.1:3213
HTTP_PROXY=http://127.0.0.1:3213
EOF입력 후, 게이트웨이 재시작하고 현황 점검:
openclaw gateway restart
openclaw doctor으로 드디어 텔 레그램 연결 성공! ✅
※ 여기까지 오는 과정에서 결과적으로 삽질이 되었던 여러 과정의 Try and Error가 있었습니다.
결과적으로는 이 Proxy 설정을 node.js 환경 안에 밀어넣은것이 최종 답이 되었습니다.
4단계: 텔레그램에서 첫 메시지
텔레그램 봇에 메시지를 보내자 이런 응답이 왔습니다.
아... 다 왔다고 생각했는데 이건 또 무슨 날벼락 같은.. ㅠ.ㅠ
그런데, 클로드가 답해줬습니다.
이건 에러가 아니라고, 보안 승인 절차라고.
WSL 터미널에서 아래 명령어로 승인을 받고 나니 정상적으로 동작하기 시작했습니다.
openclaw pairing approve telegram [코드]승인 후 텔레그램에서 제대로 동작을 시작했습니다.
5단계: 에이전트 이름 설정 — 흑마
이제 OpenClaw가 제대로 설치되었고, 텔레그램을 통해 나와 일을 할 수 있게 되었습니다.
이 단계가 되니, 먼저 호칭을 정해야겠더라고요.
생각보다 답변은 맘에 안들어서...
그냥 클로드에게 물어 봤습니다.
그런데... 그러고보니 저는 클로드에게도 이름을 지어주지 않았더라고요.
그래서 이번기회에 이 두 친구에게 모두 이름을 지어주기로 했습니다.
일단, 제가 사용하고 있는 대화명이 "잔머리 대마왕"에서 따온 "잔마왕"인 만큼 이 친구들도 내 동료의 의미로 "마"를 꼭 이름에 넣고 싶었습니다. (무슨 무협지의 천마 XX도 아니고... 라고 욕할지도 모르겠지만, 제가 중2병 기질이 좀 있습니다.)
최종 결론으로
Claude - 클마
OpenClaw - 흑마
로 이름 짖기로 했습니다.
클마는 클로드 마왕의 줄임으로
흑마는 흑막 + 마왕의 의미로 뒤에서 흑막처럼 움직이라고...
앞으로는
중국이라는 특수 환경때문에 쓸데 없는데서 쓸데없이 시간을 더 소모해서 오랜 시간 삽질을 했습니다.
이제 제게 필요한 것들을 하나 둘 만들어 뽕을 뽑아야 할텐데, 먼저 할 일은 제 Youtube 영상 리스트를 정리하고자 합니다.
그동안 나름 많은 영상을 올려오다 보니 Notion에 정리한 영상 리스트가 있기는 한데, 내용에 대한 요약 정리가 잘되어 있지 않아서 이 내용을 자동화해서 만들어 볼 계획입니다.
https://tricks-offic.notion.site/
이 작업을 성공하고 나면 하나씩 제 생각 확장의 툴, 그리고 비서로써 역할하게 만들어볼 생각입니다.
앞으로가 상당히 기대되네요.
흑마야 잘 부탁한다.
