클로드 코드 텔레그램 연결 방법, 오픈클로 대신 메가 프롬프트로

내 컴퓨터의 클로드 코드(Claude Code)를 텔레그램에 연결해, 오픈클로(OpenClaw) 없이 휴대폰에서 부리는 개인 비서로 만드는 방법을 정리했습니다. 영상 속 메가 프롬프트 21단계를 따라가고, 영상이 건너뛴 텔레그램 봇 만들기와 권한 점검, 되돌리는 법은 따로 채웠습니다.

클로드 코드 텔레그램 연결, 먼저 알아 둘 보안

Mark Kashef는 몇 주 동안 오픈클로를 써 보다가 접었다고 합니다. 대신 자기 데스크톱의 클로드 코드를 텔레그램에 연결해 개인 비서로 쓰고 있고, "OpenClaw만큼, 어쩌면 더 낫다"고 말합니다. 어디까지나 화자 주장입니다.

화자는 이 구조를 만들어 주는 "메가 프롬프트"를 영상 설명란 두 번째 링크로 공개하고, 첫 번째 링크로는 자기 커뮤니티(early adopters community)를 안내합니다. 이해관계가 있는 안내이고, 유료인지는 영상에서 말하지 않았습니다.

휴대폰 메시지 하나로 내 컴퓨터의 클로드 코드가 움직이는 구조입니다. 그런데 이 원격 실행 구조 자체의 위험이나 권한 설정에 대한 경고는 영상에 없습니다. 보안 쪽으로 나온 말은 이 정도입니다.

• 예전 오픈클로 파생판 방식에서는 보안과 권한을 하나하나 직접 점검해야 했다.
• 메시지가 텔레그램 API를 거칠 때 본인 확인을 한다.
• 처음 만들 때 첫 프롬프트가 "Telegram에서 Claude Code를 쓰되 이용약관(terms of service)을 어기지 않고 싶다"였다.

메시지를 보낼 수 있는 사람이 곧 내 컴퓨터에 명령을 내릴 수 있는 사람이 되는 구조입니다. 그래서 봇에 말을 걸 수 있는 사람과 클로드 코드가 손댈 수 있는 범위는 직접 확인해 두는 편이 안전합니다. 확인 방법은 아래 "영상에 없는 배경" 구획에 정리했습니다.

화자가 오픈클로를 버리고 클로드 코드를 고른 이유

화자는 오픈클로(예전 이름 ClawdBot)가 "4분 벽을 깬 것"처럼 가능성을 보여 줬다고 평가합니다. 육상에서 1마일 4분 벽이 한 번 깨지자 다들 따라 깬 것처럼, 휴대폰으로 AI 비서를 부리는 길을 처음 보여 줬다는 비유입니다. 다만 이미 훌륭한 클로드 코드 구조(harness, AI 모델이 도구를 쓰게 감싸 주는 틀)를 다시 이리저리 이어 붙인 것이라고 봅니다.

OpenClaw, Nano Claw, Pico Claw 저장소를 복제해 직접 만들어 보니 더 빠르긴 했답니다. 문제는 "이중 입력"이었습니다.

• 데스크톱 클로드 코드에서 잘 되는 스킬을 새 도구용으로 또 옮겨야 한다.
• 예약 작업은 클라우드 어딘가에서 따로 돌려야 한다.
• 보안과 권한을 하나하나 직접 점검해야 한다.

새 방식에서는 지난 6~7개월 동안 데스크톱에 쌓은 스킬, MCP(클로드가 외부 서비스를 직접 쓰게 해 주는 연결 규격), CLAUDE.md(클로드 코드가 매번 읽는 작업 규칙 파일), 파일을 그대로 씁니다. 기존 클로드 코드 요금제를 쓰니 원하지 않으면 API 비용을 낼 필요도 없습니다.

연결 다리는 제3자 도구가 아니라 Anthropic의 Agent SDK(클로드 코드와 같은 에이전트를 내 프로그램 안에서 돌리게 해 주는 개발 도구)입니다. Anthropic API만 쓰면 "모델의 지능"만 얻고 도구 실행 체계는 직접 만들어야 하지만, Agent SDK를 쓰면 클로드 코드의 작은 하위 프로세스가 늘 돌아간다는 설명입니다.

텔레그램 메시지 하나가 처리되는 흐름

화자는 "메시지 하나가 8단계를 거쳐 5초 안에" 처리된다고 말합니다. 8단계를 전부 번호로 말하지는 않았고, 발화된 흐름은 이렇습니다.

• 텔레그램에서 텔레그램 API로 넘어가며 본인 확인
• 미디어 처리기가 영상, 사진, 음성 메모를 처리
• 메모리 주입: 로컬 SQLite(내 컴퓨터에 파일 하나로 저장되는 작은 데이터베이스)에 저장된 최근 기억을 넣는다. Supabase나 Convex 같은 유료 클라우드 DB 없이 무료입니다. 화자는 이걸 5단계라고 부릅니다.
• Agent SDK가 클로드 하위 프로세스를 띄워 명령을 실행
• 응답을 글이나 음성으로 바꿔 텔레그램으로 돌려보냄

도입부 시연에서는 휴대폰으로 찍은 영상을 보내자 30~40초 뒤 영상 내용을 해석한 답이 왔습니다. nano banana로 이미지도 만든다고 합니다.

메모리 3층 구조 (화자 설계)

• 1층: 첫 메시지 때 세션 ID가 생기고, 같은 세션 ID로 맥락을 이어 간다. 클로드 코드의 컨텍스트 창(AI가 한 번에 기억하는 대화 분량) 한계는 그대로라서, Sonnet 모델의 100만 컨텍스트 창과 함께 쓰는 게 "가장 큰 치트키"라고 합니다.
• 2층: SQLite에 의미 기반(semantic, 뜻이 비슷한 기억을 찾는 벡터 DB 방식) 기억과 일화(episodic, 언제 무슨 일이 있었는지) 기억을 둔다. 최근 대화일수록 가중치를 높인다.
• 3층: 매 메시지 전에 최근 기억과 상위 기억을 검색하고, 잡음을 중복 제거해 주입한다(context injection).

이게 자기 기준 "최적점"일 뿐이고, 각자 바꾸거나 통째로 버려도 된다는 게 화자 입장입니다.

메가 프롬프트에 들어 있는 것

화자 요약으로는 이 도구가 무엇인지, 할 수 있는 일, 단계, 인프라별 비용, 지식베이스·세션 재개·메모리가 가득 찼을 때의 동작, 텔레그램을 왓츠앱에 연결하는 이야기, cron(정해진 시각에 자동 실행하는 예약 기능) 예약 작업이 들어 있습니다.

음성은 속도 때문에 Groq를 쓰고, 복제 목소리가 필요하면 ElevenLabs가 낫다고 합니다.

따라 하기 전에 알아 둘 것

아래 21단계는 화자가 영상에서 실제로 진행하며 말한 조작만 옮긴 것입니다. 처음부터 끝까지 이어지는 완전한 설치 과정은 아닙니다. 세 군데가 비어 있습니다.

• 1부 마법사는 끝까지 가지 않습니다. 화자 컴퓨터에는 이미 설치돼 있어서, 덮어쓰기 직전에 Esc로 멈췄습니다. 그 뒤 이어지는 맞춤 질문과 빌드 완료 화면은 영상에 없습니다.
• 3부 화면은 화자의 "풀 버전"입니다. 이미 설치해 둔 화자 자신의 Claude Claw 화면이라, 1~2부에서 만드는 Lite 버전에서도 똑같이 나오는지는 알 수 없습니다.
• 텔레그램 연결 방법, 실행 명령의 정확한 철자, 되돌리는 방법은 나오지 않습니다. 텔레그램 봇을 만드는 과정이 프롬프트 안에 있는지도 화자는 말하지 않습니다. 이 셋은 글 뒤쪽에서 채웠습니다.

처음부터 직접 만드는 데 1~2시간 걸렸고, 메가 프롬프트로는 빌드에 10~30분 걸린다고 합니다.

준비물

• 이미 설치해서 쓰고 있는 클로드 코드. 없다면 맥 터미널에서 curl -fsSL https://claude.ai/install.sh | bash로 설치하고 claude로 로그인합니다.
• 메가 프롬프트 파일: 설명란 두 번째 링크에서 받습니다. 파일은 클로드 코드를 실행할 작업 폴더 안에 두면 @로 태그하기 쉽습니다.
• 텔레그램 계정
• Anthropic API 키, 또는 Claude Code Max 요금제(OAuth 로그인용, 이미 가입한 계정으로 로그인해 권한을 빌려주는 방식)
• 계속 켜 둘 컴퓨터나 맥미니: 예약 작업을 계속 돌리려면 켜져 있어야 합니다.
• 비용: 원하지 않으면 API 비용 없이 기존 요금제로 된다는 게 화자 설명입니다. 음성 기능(Groq, OpenAI, ElevenLabs) 비용은 언급하지 않았으니 각 서비스의 공식 요금 안내를 확인해야 합니다.

1부. 메가 프롬프트 실행하기

1. 클로드 코드를 연다. 터미널에서 메가 프롬프트 파일이 있는 폴더로 이동한 뒤 claude를 입력합니다.
   • 확인: 클로드 코드 입력창이 준비된다.
2. 입력창에 메가 프롬프트 파일을 @rebuild로 태그해 넣는다.

@rebuild

• 팁: 복사해서 붙여 넣을 필요 없이 태그만 하면 됩니다.
• 주의: @rebuild는 화자 환경의 파일 이름입니다. 받은 파일 이름이 다르면 @를 치고 파일 이름 앞 글자를 입력해 목록에서 고릅니다.
• 확인: 메가 프롬프트 파일이 태그된다.

3. 뒤에 실행 지시를 입력한다.

execute this

• 팁: "read this", "do whatever's in this"처럼 비슷한 말이면 됩니다.
• 확인: 입력창에 @rebuild execute this 형태의 메시지가 들어 있다.

4. Enter를 눌러 메시지를 보낸다.
   • 확인: 작은 ASCII 아트(글자로 그린 그림) 애니메이션과 "Claude Claw Lite"가 뜬다. 화자 자기 버전이 아닌 일반 버전이라 Lite라고 붙였답니다.
5. 화면에 나온 설명(필요한 단계 안내)을 읽는다.
   • 팁: 궁금한 건 이 시점에 물어봐도 됩니다.
   • 확인: 무엇이 필요한지 안내문을 확인했다.
6. 설치 시작을 요청하는 문장을 입력한다.

help me set this up now

• 확인: 입력창에 문장이 들어 있다.

7. Enter를 눌러 보낸다.
   • 확인: 마법사가 실행되고 객관식 선택 창이 뜬다. 기술에 익숙하지 않은 사람도 겁먹지 않게 객관식으로 묻도록 만들었다고 합니다.

2부. 마법사 질문에 답하기

아래 선택값은 화자의 예시입니다. 자기 필요에 맞게 고르면 됩니다. 선택지는 방향키로 옮기고 Enter로 고릅니다.

8. 음성 옵션 하나를 고른다.
   • 위치: 음성 질문의 선택지 Grok(Groq), OpenAI, Eleven Labs, No Voice, type something(직접 입력)
   • 팁: 화자는 Groq를 골랐습니다. 음성이 필요 없으면 No Voice를 고르면 외부 서비스 키가 하나 줄어듭니다.
   • 확인: 고른 항목이 선택된다.
9. Enter(Next)로 다음 질문으로 넘어간다.
   • 확인: "What kind of memory system do you want?"(어떤 메모리 방식을 원하나요) 질문이 뜬다.
10. 메모리 방식에서 "full memory"를 클릭한다.
    • 팁: 기본값(episodic + semantic)으로 먼저 만들어 보고 나중에 고쳐도 됩니다.
    • 확인: 기능 선택 질문으로 넘어간다.
11. 켤 기능을 체크한다.
    • 위치: 기능 목록 scheduler(예약 작업), video analysis(영상 분석), WhatsApp bridge(왓츠앱 연결), background service(백그라운드 상시 실행)
    • 팁: 화자는 scheduler를 예로 들고, 필요 없으면 나머지는 빼도 된다고 합니다. 처음엔 기능을 적게 켤수록 점검할 곳도 줄어듭니다.
    • 확인: 원하는 기능만 체크돼 있다.
12. "submit"을 누른다.
    • 확인: 제출 버튼이 한 번 더 보인다. 화자는 "submit"이라고 말한 뒤 "여기 submit을 클릭"이라고 한 번 더 말합니다.
13. 다시 "submit"을 클릭한다.
    • 주의: 12~13단계가 실제로 두 번 누르는 건지, 한 번 누르는 걸 두 번 말한 건지는 화면을 판독하지 못해 알 수 없습니다. 버튼이 다시 보이면 한 번 더 누르면 됩니다.
    • 주의: 같은 도구를 이미 설치한 컴퓨터라면 기존 것을 덮어씁니다. 화자는 그래서 여기서 Esc를 눌러 멈췄습니다.
    • 확인: 전체 빌드 과정이 시작된다.
14. 이어지는 맞춤 질문에 하나씩 답한다.
    • 주의: 화자가 이 과정을 멈췄기 때문에 질문 내용은 영상에 없습니다. 모르는 질문이 나오면 "이 질문이 무슨 뜻인지, 추천 값은 뭔지 설명해 줘"라고 되물으면 됩니다.
    • 확인: 빌드가 진행된다. 10~30분 걸린다고 합니다.

3부. 설치 후 실행과 온보딩 (화자의 풀 버전 화면)

여기부터는 화자가 이미 설치해 둔 "풀 버전" 화면입니다. Lite 버전에서도 같은 순서로 나오는지는 영상에서 말하지 않았습니다.

15. 터미널에서 실행 명령을 입력한다.

claude claw

• 주의: 발화로는 "Claude claw"라는 명령입니다. 실제 철자와 띄어쓰기는 화면을 판독하지 못했습니다. 안 되면 빌드가 끝난 클로드 코드에게 "방금 만든 도구를 실행하는 명령이 뭐야?"라고 물어 확인합니다.
• 확인: 풀 버전 ASCII 아트가 뜨고 온보딩이 시작된다.

16. "yes"를 골라 계속 진행한다.
    • 확인: "Do you want voice input?"(음성 입력을 쓸까요) 질문이 뜬다.
17. 음성 입력에 "yes"를 고른다.
    • 확인: 다음 질문으로 넘어간다. 화자가 "Do you want this?"라고만 말한 항목인데, 무엇을 묻는지는 알 수 없습니다.
18. 그 질문에 "yes"를 고른다.
    • 확인: video analysis 질문이 뜬다.
19. video analysis에 "no"를 고른다.
    • 확인: WhatsApp 질문이 뜬다.
20. WhatsApp에 "no"를 고른다.
    • 확인: "Do you want to clone any of the repos?"(저장소를 복제할까요) 질문이 뜬다.
21. 저장소 복제 질문에 "no"를 고른다.
    • 팁: 여러 저장소에서 마음에 드는 기능을 골라 오고 싶으면 yes를 고릅니다.
    • 확인: 다음 질문이 뜬다. 화자는 그다음 항목에도 "no"를 누르고, 이어서 API 키를 넣을지 Claude Code Max 요금제로 OAuth 로그인할지 묻는 단계가 나온다고 합니다.
    • 주의: 두 번째 "no" 질문의 내용과 API 키/OAuth 이후 과정은 영상에서 진행하지 않았습니다.

클로드 코드 텔레그램 연결이 끝났는지 점검

• @rebuild execute this 실행 후 ASCII 아트(Claude Claw Lite)가 떴는가
• 음성, 메모리, 기능 선택을 마치고 빌드가 시작됐는가
• 빌드가 끝난 뒤 실행 명령으로 온보딩 화면이 뜨는가
• API 키나 Max 요금제 OAuth 중 하나로 인증했는가
• 텔레그램으로 메시지를 보냈을 때 답이 오는가
• 다른 계정으로 봇에 말을 걸었을 때 답하지 않는가

다섯 번째 항목은 성공 기준을 영상에서 따로 말하지 않았습니다. 참고로 도입부 시연에서는 영상 해석 답장이 오는 데 30~40초 걸렸습니다. 마지막 항목은 편집자가 더한 보안 점검입니다.

막힐 때

화자 설명을 기준으로 정리했습니다.

• 마법사가 기존 설정을 덮어쓰려 한다: 이미 설치된 컴퓨터에서 다시 돌린 경우입니다. 화자처럼 Esc로 멈춥니다.
• 대화가 길어지면 맥락이 끊긴다: 클로드 코드의 컨텍스트 창 한계는 그대로입니다. Sonnet 모델의 100만 컨텍스트 창과 함께 쓰라는 제안이 있습니다.
• 예약 작업이 안 돈다: 컴퓨터가 꺼져 있거나 잠든 경우입니다. 맥이라면 시스템 설정 → 에너지(또는 배터리)에서 "디스플레이가 꺼져 있을 때 자동으로 잠자기 방지"를 켜 둡니다. 임시로는 터미널에서 caffeinate -dimsu를 실행해 둔 동안 잠들지 않게 할 수 있습니다.
• 음성 답장이 느리다: 원인은 말하지 않았습니다. 화자는 속도 때문에 ElevenLabs 대신 Groq를 씁니다.

방금 만든 텔레그램 봇이 내 텔레그램 사용자 ID에서 온 메시지에만 답하도록 되어 있는지 코드에서 확인해 줘. 안 되어 있으면 허용 목록(allowlist)을 추가하고, 다른 사용자가 보낸 메시지는 무시하고 기록만 남기게 바꿔 줘.

텔레그램에서 들어온 명령을 실행할 때 클로드 코드가 어떤 권한 모드로 돌고 있는지, 접근할 수 있는 폴더가 어디까지인지 설정 파일 위치와 함께 알려 줘. 파일 삭제, git push, 메일 발송처럼 되돌리기 어려운 동작은 실행 전에 텔레그램으로 나에게 확인을 받도록 바꿀 수 있는지도 알려 줘.

출처: youtu.be/…