박정기
박정기
🗡️ AI 레전드
🎖️ 마스터 파트너
🚀 SNS 챌린지 달성자

OpenClaw에서 텔레그램 파일 전송이 안 될 때, 실제로 해결한 방법

소개

최근 OpenClaw를 실사용하면서 텔레그램으로 문서 파일을 보내야 하는 상황이 있었습니다. 설문 응답을 분석해서 Word 문서(.docx)를 만들고, 그 결과 파일을 제 텔레그램 채팅으로 바로 받고 싶었습니다.

처음에는 이게 당연히 될 줄 알았습니다. 그런데 막상 해보니, 대화 세션 안에서는 파일을 첨부해서 보내는 도구가 보이지 않았고, 계속 막히는 상황이 반복됐습니다.

이 과정을 겪으면서 느낀 건, OpenClaw는 설치 자체보다 실제 내 환경에서 어떤 경로로 동작하는지를 튜닝하는 게 훨씬 중요하다는 점이었습니다.

시도하고자 했던 것과 그 이유

제가 하고 싶었던 건 단순했습니다.

  • 설문 응답 CSV를 정리해서

  • OpenClaw 기반 자동화 제안서를 Word 문서로 만들고

  • 그 파일을 바로 텔레그램으로 받는 것

이 작업은 실제로 스터디 운영에도 바로 도움이 되는 흐름이라, 단순 테스트가 아니라 “내 삶/업무 자동화” 관점에서도 의미가 있었습니다.

문제는, 문서 생성까지는 잘 됐는데 텔레그램으로 파일을 보내는 마지막 단계에서 계속 막혔다는 점이었습니다.

진행 방법

1. 처음에는 “안 되는 기능”처럼 보였습니다

처음에는 현재 채팅 세션에서 파일 첨부를 보낼 수 있는 도구가 보이지 않았습니다. 그래서 한동안은 “텔레그램으로 파일 전송이 원래 안 되나?” 혹은 “설정 문제인가?” 쪽으로 생각하게 됐습니다.

실제로 텔레그램 설정도 확인하고, openclaw.json도 확인했고, channels.telegram.actions.sendMessage, channels.telegram.mediaMaxMb 같은 설정도 명시적으로 넣어봤습니다.

하지만 그걸로 바로 해결되지는 않았습니다. 이 지점에서 중요한 건, 세션에서 보이는 도구만 보고 기능 전체를 판단하면 안 된다는 거였습니다.

2. 문서를 다시 읽고 실제 전송 경로를 확인했습니다

막혔을 때 결국 다시 한 건 문서를 보는 것이었습니다. OpenClaw 텔레그램 문서와 CLI 도움말을 다시 확인해보니, 대화 세션 안의 첨부 전송 인터페이스와 별개로, CLI 메시지 전송 경로가 따로 있었습니다.

핵심은 이 명령이었습니다.

openclaw message send \
  --channel telegram \
  --target <chat_id> \
  --message "메시지" \
  --media <absolute-path>

즉, “대화 세션에서 파일 보내기 버튼이 안 보인다”와 “OpenClaw가 텔레그램으로 파일을 못 보낸다”는 같은 말이 아니었습니다.

3. 작은 파일로 먼저 테스트했습니다

바로 .docx를 보내기 전에, 작은 텍스트 파일로 먼저 테스트했습니다.

openclaw message send \
  --channel telegram \
  --target 6545586473 \
  --message "텔레그램 파일 전송 테스트" \
  --media /absolute/path/to/test.txt

이 테스트가 성공하면서, 문제는 “텔레그램 자체가 안 되는 것”이 아니라 올바른 전송 경로를 아직 안 쓴 것이라는 점이 명확해졌습니다.

4. 실제 .docx 전송까지 성공했습니다

그 다음 같은 방식으로 Word 문서도 전송했습니다.

openclaw message send \
  --channel telegram \
  --target 6545586473 \
  --message "OpenClaw 스터디 자동화 제안서 docx 파일이야." \
  --media /absolute/path/to/document.docx

결과적으로 설문 응답 분석, Word 문서 생성, 텔레그램 파일 전송까지 한 흐름으로 이어졌고, 제가 실제로 원하는 결과를 받을 수 있었습니다.

결과와 배운 점

1. OpenClaw는 설치보다 운영 튜닝이 더 중요했습니다

설치가 끝났다고 바로 다 되는 게 아니었습니다. 실제로는 내 채널, 내 워크플로우, 내 파일 경로, 내 사용 방식에 맞게 운영 경로를 찾아가는 과정이 중요했습니다.

2. 안 되는 것처럼 보여도, 문서를 보면 길이 있는 경우가 많았습니다

처음에는 “파일 첨부 전송이 안 된다”로 보였지만, 문서를 다시 읽어보니 세션 UI 경로가 아니라 CLI 경로가 있었습니다. 막혔을 때 무조건 포기하는 대신 문서 → 실제 명령 → 작은 테스트 순서로 가는 게 효과적이었습니다.

3. 실사용하면서 스킬과 워크플로우를 계속 고치는 방식이 강력했습니다

이번 작업도 단순히 기능을 쓰는 데서 끝난 게 아니라, 설정을 확인하고, 전송 방식을 바꾸고, 성공한 경로를 메모리에 남기고, 다음에도 반복 사용할 수 있게 정리하는 방식으로 발전했습니다.

결국 OpenClaw는 “처음부터 완벽한 시스템”이라기보다, 실사용하면서 점점 내 환경에 맞게 다듬어가는 도구에 더 가깝다고 느꼈습니다.

4. 작은 성공 하나가 다음 자동화로 이어졌습니다

이번엔 단지 .docx 파일 하나를 텔레그램으로 보내는 문제였지만, 이게 해결되고 나니 앞으로는 리포트 자동 생성 후 전송, 요약본 전송, 캘린더/문서 결과물 전달 같은 흐름도 훨씬 쉽게 확장할 수 있게 됐습니다.

앞으로의 계획

앞으로는 텔레그램 파일 전송이 필요할 때, 대화 세션 안에서만 해결하려고 하기보다 먼저 아래 경로를 기준으로 생각할 것 같습니다.

openclaw message send --channel telegram --target <chat_id> --message ... --media <absolute-path>

그리고 이런 식으로 실제로 실패한 문제를 하나 잡고, 문서와 설정을 확인하고, 작은 테스트로 검증하고, 성공 경로를 메모리와 스킬에 남기는 방식으로 OpenClaw를 계속 제 환경에 맞게 튜닝해볼 생각입니다.

한 줄 요약

OpenClaw 텔레그램 파일 전송이 안 되는 줄 알았는데, 문서를 다시 보고 CLI 전송 경로를 찾아 실제로 해결했다. 설치보다 운영 튜닝이 더 중요하다는 걸 배운 사례였다.

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요