시놀로지 NAS로 개인 AI 비서 만들기 8편 — 텔레그램으로 OpenClaw에게 말 걸기

시놀로지 NAS에 OpenClaw를 설치하고 workspace 폴더까지 연결했다면, 이제 남은 질문은 하나입니다. “이 개인 AI 비서를 어디서 부를 것인가?”입니다. 매번 NAS 관리 화면이나 PC 터미널을 열어야 한다면 개인 비서라기보다 관리 도구에 가깝습니다. 진짜 편해지는 순간은 휴대폰에서 짧게 말했을 때 NAS 안의 자료를 읽고, 요약하고, 결과를 다시 보내줄 때입니다.

이번 8편에서는 텔레그램을 OpenClaw의 입구로 사용하는 흐름을 정리합니다. 텔레그램 봇을 만들고, OpenClaw에 연결하고, 허용된 사용자만 응답하게 제한한 뒤, NAS 파일 요약·블로그 초안·문서 정리 같은 실제 요청 예시까지 다룹니다. 핵심은 편의성과 보안을 동시에 잡는 것입니다.

이번 편의 목표
1. 텔레그램을 OpenClaw의 대화 창구로 연결한다.
2. 봇 토큰과 사용자 ID를 안전하게 관리한다.
3. NAS workspace 파일을 휴대폰에서 요약 요청하는 흐름을 만든다.
4. 외부 노출을 줄이고 허용 사용자만 응답하게 설정한다.

1. 왜 텔레그램을 OpenClaw 입구로 쓰는가

텔레그램을 연결하면 휴대폰 메시지 하나로 NAS 안의 자료 작업을 시작할 수 있습니다.

OpenClaw를 NAS에 올리는 이유는 단순히 서버를 하나 더 만들기 위해서가 아닙니다. NAS에 쌓인 문서, 메모, 사진, 블로그 자료를 AI가 읽고 정리하도록 만들기 위해서입니다. 그런데 이 기능을 쓰기 위해 매번 PC 앞에 앉아야 한다면 활용도가 크게 떨어집니다.

텔레그램은 이 문제를 해결하는 좋은 입구가 됩니다. 휴대폰에서 메시지를 보내면 OpenClaw가 그 메시지를 받고, NAS workspace 안의 파일을 읽거나 정리한 뒤 다시 답장을 보낼 수 있습니다. 즉 텔레그램은 AI 비서의 “호출 버튼” 역할을 합니다.

방식	장점	주의점
PC 접속	설정 변경에 유리	항상 PC 필요
텔레그램	휴대폰에서 즉시 지시	사용자 제한 필수
웹 대시보드	상태 확인에 편리	외부 노출 주의

핵심 정리
텔레그램은 OpenClaw를 가장 쉽게 부르는 입구입니다. 다만 아무나 말을 걸 수 있으면 위험하므로, 반드시 허용 사용자 제한을 함께 설정해야 합니다.

2. Telegram BotFather로 봇 만들기

텔레그램 연동은 봇을 만드는 것에서 시작합니다. 텔레그램에서 BotFather를 검색한 뒤 새 봇을 만들고, 봇 이름과 사용자명을 정하면 토큰이 발급됩니다. 이 토큰은 OpenClaw가 텔레그램 메시지를 주고받기 위해 사용하는 열쇠입니다.

봇 이름은 독자가 알아보기 쉬운 이름이면 됩니다. 예를 들어 `My NAS Assistant`처럼 기능이 드러나는 이름이 좋습니다. 사용자명은 반드시 `bot`으로 끝나야 합니다. 예를 들어 `my_nas_assistant_bot` 같은 형태입니다.

항목	예시	설명
봇 이름	NAS AI Assistant	대화 목록에 보이는 이름
사용자명	nas_ai_helper_bot	반드시 bot으로 끝남
Bot Token	숫자:문자열	절대 공개 금지

꼭 알아두세요
Bot Token은 비밀번호와 같습니다. 블로그, 캡처, 메모장, 공개 저장소에 그대로 올리면 안 됩니다. 노출되었다면 BotFather에서 즉시 토큰을 재발급해야 합니다.

3. Bot Token은 어디에 보관해야 하나

토큰은 OpenClaw 설정 또는 환경변수에 보관해야 합니다. 중요한 것은 본문, 명령 기록, 공개 저장소에 남기지 않는 것입니다. Docker나 Container Manager 환경에서는 보통 환경변수 형태로 넣는 것이 관리하기 쉽습니다.

예를 들어 `TELEGRAM_BOT_TOKEN` 같은 이름으로 값을 넣고, OpenClaw 설정에서 해당 환경변수를 참조하게 만들 수 있습니다. 실제 토큰 값은 화면에 그대로 노출하지 않는 것이 원칙입니다. 설정 화면을 캡처할 때도 토큰은 반드시 가려야 합니다.

보관 위치	권장도	이유
환경변수	높음	컨테이너 관리에 적합
비공개 설정 파일	가능	권한 관리 필요
본문/메모	금지	노출 위험 큼

주의사항
토큰을 블로그 예시 코드에 실제 값으로 넣지 마세요. 예시는 반드시 `123456:ABC...`처럼 가짜 값으로 표시하고, 실제 값은 환경변수나 비공개 설정에만 넣어야 합니다.

4. OpenClaw에 Telegram 채널 연결하기

OpenClaw는 텔레그램 채널을 통해 외부 메시지를 받고 답장을 보낼 수 있습니다.

봇을 만들었다면 OpenClaw 쪽에서 Telegram 채널을 활성화해야 합니다. 설정 방식은 설치 환경에 따라 다를 수 있지만 핵심은 같습니다. 봇 토큰을 등록하고, 메시지를 받을 채널을 켜고, 허용 사용자 또는 허용 채팅을 제한합니다.

시놀로지 Container Manager를 사용한다면 OpenClaw 컨테이너의 환경변수 또는 설정 파일에 텔레그램 관련 값을 넣은 뒤 컨테이너를 재시작합니다. 재시작 후에는 OpenClaw 상태 화면에서 Telegram 채널이 정상인지 확인합니다.

TELEGRAM_BOT_TOKEN=123456:ABCDEF_SAMPLE_TOKEN
AUTHORIZED_USERS=123456789

위 값은 설명용 예시입니다. 실제 토큰이나 실제 사용자 ID는 공개 글에 적지 않습니다. 중요한 것은 봇 토큰만 넣는 것이 아니라, 누가 이 봇에게 말을 걸 수 있는지도 함께 제한해야 한다는 점입니다.

5. 내 Telegram ID 확인하기

사용자 제한을 하려면 텔레그램 사용자 ID가 필요합니다. 텔레그램의 이름이나 사용자명은 바뀔 수 있지만 숫자 ID는 비교적 안정적입니다. OpenClaw가 특정 사용자에게만 응답하게 만들려면 이 숫자 ID를 허용 목록에 넣어야 합니다.

확인 방법은 여러 가지입니다. ID 확인용 봇을 잠깐 사용하거나, OpenClaw 로그에서 들어온 메시지의 sender ID를 확인할 수 있습니다. 단, 로그를 볼 때는 개인정보나 토큰이 함께 노출되지 않도록 주의해야 합니다.

확인 방법	장점	주의점
ID 확인 봇	빠름	신뢰 가능한 봇 사용
OpenClaw 로그	실제 수신값 확인	민감정보 마스킹
봇 응답	흐름 테스트 가능	초기 설정 필요

핵심 정리
텔레그램 연동은 “봇 토큰 + 허용 사용자 ID”가 한 세트입니다. 토큰만 넣고 사용자 제한을 하지 않으면 개인 비서가 아니라 열린 메시지 창이 될 수 있습니다.

6. 허용 사용자만 응답하게 제한하기

개인 AI 비서에서 가장 중요한 보안 장치는 허용 사용자 제한입니다. 봇 링크를 아는 사람이 메시지를 보낼 수 있다면, 누군가 NAS 자료 요약을 요청하거나 내부 정보를 물어볼 가능성이 생깁니다. 그래서 봇은 반드시 허용된 사용자에게만 반응해야 합니다.

허용 사용자 목록은 숫자 ID 기준으로 관리하는 편이 좋습니다. 가족이나 팀원이 함께 쓴다면 사용자 ID를 여러 개 넣을 수 있지만, 처음에는 본인 1명만 허용하는 것이 안전합니다. 그룹방에 넣는 것도 초반에는 피하는 편이 좋습니다.

설정	권장값	이유
허용 사용자	1명부터	오작동 범위 최소화
그룹방 사용	초반 비권장	대화 노출 가능성
명령 범위	읽기 중심	삭제·이동 방지

주의사항
초기에는 삭제, 이동, 대량 수정 같은 명령을 텔레그램에서 바로 실행하지 않는 것이 좋습니다. 먼저 요약, 정리안 작성, 초안 생성처럼 되돌리기 쉬운 작업부터 시작하세요.

7. 첫 테스트 메시지 보내기

첫 테스트는 짧고 안전한 요청으로 시작하는 것이 좋습니다.

연결이 끝나면 바로 중요한 파일을 요청하지 말고 간단한 인사 테스트부터 합니다. 봇에게 “안녕, 연결됐는지 확인해줘”처럼 보내고 OpenClaw가 정상적으로 답하는지 확인합니다. 그 다음 7편에서 만든 테스트 파일을 읽게 합니다.

/workspace/test/test-note.txt 파일을 읽고 세 줄로 요약해줘.

정상적으로 답변이 오면 텔레그램에서 OpenClaw로 메시지가 들어가고, OpenClaw가 NAS workspace에 접근하며, 결과를 다시 텔레그램으로 보내는 전체 흐름이 연결된 것입니다.

실제 예시
처음 요청은 반드시 테스트 파일로 시작하세요. 연결, 권한, 경로, 응답 흐름을 모두 확인한 뒤 실제 문서나 블로그 자료로 넘어가는 것이 안전합니다.

8. NAS 파일 요약 요청 예시

텔레그램 연동의 가장 실용적인 기능은 NAS 파일 요약입니다. 예를 들어 `documents` 폴더에 회의록이나 PDF에서 추출한 텍스트를 넣어두고, 이동 중에 휴대폰으로 요약을 요청할 수 있습니다.

/workspace/documents/meeting-note.txt 파일을 읽고
핵심 결정사항, 해야 할 일, 다음 확인사항으로 나눠 정리해줘.

이때 요청을 구체적으로 적을수록 결과가 좋아집니다. “요약해줘”보다 “핵심 결정사항, 해야 할 일, 다음 확인사항으로 나눠줘”가 훨씬 실무에 맞는 답변을 만듭니다.

요청 유형	좋은 요청	결과
회의록	결정·할일·확인사항	실행 중심 요약
자료 요약	3단계로 정리	읽기 쉬운 답변
체크리스트	빠진 항목 표시	검수에 유리

9. 블로그 초안 작성 요청 예시

NAS에 블로그 자료를 모아두는 사람이라면 텔레그램 연동의 효과가 더 큽니다. 자료 파일을 workspace에 넣어두고, 휴대폰에서 제목안과 목차를 요청할 수 있습니다. 이동 중에도 아이디어를 저장하고, 집에 돌아와 바로 편집할 수 있습니다.

/workspace/blog-drafts/synology-notes.txt를 읽고
블로그 제목 5개, H2 목차 12개, 핵심 요약 박스 3개를 제안해줘.

이 요청은 단순 초안보다 훨씬 유용합니다. 제목, 목차, 핵심 박스까지 한 번에 받으면 글의 구조가 빠르게 잡힙니다. 이후 PC에서 본문을 다듬고 이미지와 표를 넣으면 발행 속도가 빨라집니다.

핵심 정리
텔레그램에서는 긴 글 전체를 한 번에 완성시키기보다, 제목안·목차·요약 박스·체크리스트처럼 구조화된 중간 결과물을 요청하는 것이 안정적입니다.

10. 사진·문서 정리 요청 예시

텔레그램 요청은 사진·문서 정리 같은 반복 작업과 잘 맞습니다.

OpenClaw가 NAS에 연결되어 있다면 사진이나 문서 정리에도 활용할 수 있습니다. 단, 원본 파일을 바로 바꾸는 작업은 신중해야 합니다. 처음에는 파일명 변경안을 만들거나 폴더 구조 추천을 받는 정도가 좋습니다.

/workspace/inbox 폴더의 파일 목록을 보고
여행사진, 업무문서, 블로그자료로 나누는 정리안을 만들어줘.
파일은 아직 이동하지 말고 제안만 해줘.

마지막 문장이 중요합니다. “파일은 아직 이동하지 말고 제안만 해줘”라고 적으면 실제 변경 전에 사람이 확인할 수 있습니다. 자동화는 편하지만, 원본 자료를 다룰 때는 확인 단계를 남겨두는 것이 안전합니다.

꼭 알아두세요
사진, 계약서, 세금 자료처럼 원본 가치가 큰 파일은 처음부터 자동 이동하지 마세요. 정리안만 먼저 받고, 확인 후 수동으로 옮기는 방식이 안전합니다.

11. 연결 실패 시 체크리스트

텔레그램 연동이 한 번에 되지 않을 수도 있습니다. 가장 흔한 문제는 봇 토큰 오타, 컨테이너 재시작 누락, 허용 사용자 ID 불일치, 네트워크 차단입니다. 문제를 크게 생각하기보다 아래 순서대로 좁혀가면 됩니다.

증상	가능 원인	확인 방법
응답 없음	토큰 오타	환경변수 확인
권한 거부	ID 불일치	sender ID 확인
설정 반영 안 됨	재시작 누락	컨테이너 재시작
파일 접근 실패	workspace 경로 문제	7편 설정 재확인

실제 예시
봇은 응답하는데 파일을 못 읽는다면 텔레그램 문제가 아니라 NAS workspace 연결 문제일 가능성이 큽니다. 이 경우 7편의 테스트 파일부터 다시 확인하는 것이 빠릅니다.

12. 보안상 절대 하지 말아야 할 것

텔레그램은 편리하지만 외부 메시지 창입니다. 따라서 보안 기준을 느슨하게 잡으면 안 됩니다. 특히 봇 토큰 공개, 그룹방 무제한 사용, NAS 전체 접근, 삭제 명령 허용은 피해야 합니다. 개인 AI 비서는 편할수록 더 좁은 권한으로 운영해야 합니다.

주의사항
다음은 피해야 합니다.
1. 봇 토큰을 공개 저장소나 블로그에 노출
2. 허용 사용자 제한 없이 봇 운영
3. NAS 전체 폴더를 텔레그램 명령으로 접근
4. 원본 파일 삭제·이동 명령을 바로 허용
5. 민감한 계정·토큰·인증서 폴더를 workspace에 포함

처음 한 달은 읽기와 요약 중심으로 운영하는 것을 권장합니다. 충분히 안정성을 확인한 뒤에만 결과 파일 저장, 초안 생성, 파일 목록 정리 같은 작업으로 넓혀가면 됩니다.

특히 텔레그램은 손쉽게 메시지를 보낼 수 있는 만큼 실수도 빠르게 일어날 수 있습니다. “이 폴더 정리해줘”라는 짧은 문장이 실제 파일 이동으로 이어지는 구조라면 위험합니다. 그래서 초반에는 반드시 “정리안만 만들어줘”, “삭제하지 말고 후보만 보여줘”, “결과는 output 폴더에 새 파일로 저장해줘”처럼 안전장치를 문장 안에 넣는 습관이 필요합니다.

또한 봇이 정상적으로 작동하더라도 모든 답변을 그대로 실행 결과로 믿으면 안 됩니다. AI가 파일 내용을 잘못 이해하거나, 경로를 다르게 해석하거나, 사용자가 의도한 폴더와 다른 위치를 참고할 수 있습니다. 중요한 문서일수록 텔레그램 답변은 초안이나 제안으로 보고, 최종 변경은 사람이 확인하는 구조가 좋습니다.

운영 기록도 남겨두면 좋습니다. 어떤 날 어떤 파일을 요약했는지, 어떤 작업을 요청했는지 간단히 기록하면 나중에 문제가 생겼을 때 원인을 찾기 쉽습니다. 개인 AI 비서는 편한 도구이지만, NAS 자료를 다루는 순간부터는 작은 운영 규칙이 장기 안정성을 좌우합니다.

예를 들어 텔레그램으로 회의록을 요약했다면 결과를 채팅방에만 남기지 말고 `/workspace/output` 안에 날짜별 파일로 저장하는 방식이 좋습니다. 블로그 목차를 만들었다면 `/workspace/blog-drafts`에 초안으로 저장하고, 사진 정리안을 받았다면 실제 이동 전에 별도 텍스트 파일로 보관합니다. 이렇게 하면 휴대폰 대화가 단순 알림 창이 아니라 NAS 작업 흐름의 출발점이 됩니다.

또한 중요한 요청은 짧게만 쓰지 말고 조건을 함께 적는 습관이 필요합니다. “요약해줘”보다 “핵심 결정, 해야 할 일, 확인할 위험을 나눠서 정리해줘”가 좋고, “정리해줘”보다 “파일은 옮기지 말고 정리안만 만들어줘”가 안전합니다. 텔레그램에서는 문장이 짧아지기 쉬우므로, 오히려 안전 조건을 의식적으로 붙여야 합니다.

이런 방식으로 운영하면 실수 가능성이 크게 줄어듭니다. OpenClaw는 작업 속도를 높여주는 도구이지만, NAS에 보관된 자료는 대부분 다시 만들기 어렵습니다. 따라서 텔레그램 연동의 첫 목표는 빠른 자동화가 아니라, 안전하게 요청하고 확인 가능한 결과를 받는 구조를 만드는 것입니다.

처음에는 답변 속도보다 반복 가능한 절차를 만드는 데 집중하는 편이 좋습니다. 같은 형식의 요청을 여러 번 보내도 결과 저장 위치와 응답 형식이 일정해야 나중에 자동화로 확장할 수 있습니다. 작은 규칙이 쌓이면 텔레그램은 단순 채팅창이 아니라 개인 자료 관리의 실전 명령 창이 됩니다. 특히 가족사진, 계약서, 세금자료처럼 원본 보호가 중요한 파일은 이 원칙을 반드시 지켜야 합니다. 결국 좋은 연동은 많이 열어주는 설정이 아니라 필요한 일만 정확히 허용하는 설정에서 시작됩니다. 이 기준을 지키면 초보자도 부담 없이 운영을 시작할 수 있습니다.

한 줄 정리
텔레그램 연동은 OpenClaw를 매우 편하게 만들지만, 편의성보다 중요한 것은 작업 범위 제한입니다. 읽기, 요약, 제안부터 시작하고 실제 변경 작업은 충분히 검증한 뒤 단계적으로 늘리는 것이 안전합니다.

13. 마무리 — 휴대폰에서 부르는 NAS 개인 AI 비서

텔레그램 연결이 끝나면 OpenClaw는 휴대폰에서 부를 수 있는 NAS 개인 AI 비서가 됩니다.

8편의 핵심은 OpenClaw를 휴대폰에서 부를 수 있게 만드는 것입니다. NAS에 자료를 모아두고, OpenClaw가 그 자료를 읽을 수 있게 만든 뒤, 텔레그램으로 지시하면 개인 AI 비서의 기본 형태가 완성됩니다.

다만 편해지는 만큼 보안 기준도 분명해야 합니다. 봇 토큰은 숨기고, 허용 사용자만 응답하게 하고, NAS 전체가 아니라 workspace 안에서만 일하게 해야 합니다. 이 원칙만 지켜도 텔레그램 연동은 매우 실용적인 작업 창구가 됩니다.

다음 편 예고
9편에서는 텔레그램으로 부른 OpenClaw를 실제 자동화에 활용하는 방법을 다룹니다. 블로그 자료 정리, 문서 요약, 사진 분류, 일정 메모 같은 반복 작업을 NAS 기반으로 연결하는 실전편입니다.

---

이전 글 보기
1편 — 시놀로지 NAS가 개인 AI 비서의 기억 창고가 되는 이유
2편 — AI가 읽기 좋은 자료 창고 만들기
3편 — AI가 잘 읽는 파일 정리법
4편 — OpenClaw를 올리기 전 Docker 준비하기
5편 — OpenClaw 구조 이해
6편 — Container Manager에 OpenClaw 설치하기
7편 — OpenClaw와 NAS 폴더 연결하기

이미지 출처
본문 이미지는 Pixabay 1장, Unsplash 4장을 활용했으며, 이해를 돕기 위한 자료 이미지로 사용했습니다.

자주 묻는 질문

Q1. 텔레그램 봇 토큰을 잃어버리면 어떻게 하나요?
BotFather에서 새 토큰을 발급받으면 됩니다. 기존 토큰이 노출되었을 가능성이 있다면 재발급 후 OpenClaw 설정도 새 값으로 바꿔야 합니다.

Q2. 가족이나 팀원도 같이 사용할 수 있나요?
가능하지만 처음에는 1명만 허용하는 것이 좋습니다. 함께 쓰려면 사용자 ID를 각각 허용 목록에 추가하고, 접근 가능한 작업 범위를 명확히 나누는 것이 안전합니다.

Q3. 그룹방에 OpenClaw 봇을 넣어도 되나요?
가능은 하지만 초반에는 권장하지 않습니다. 그룹방에서는 대화가 섞이고 의도하지 않은 사람이 메시지를 볼 수 있으므로 개인 대화에서 안정화한 뒤 검토하는 것이 좋습니다.

Q4. 텔레그램으로 NAS 파일을 삭제하게 해도 되나요?
처음에는 피하는 것이 좋습니다. 읽기, 요약, 정리안 작성처럼 되돌리기 쉬운 작업부터 시작하고, 삭제나 이동은 사람이 확인한 뒤 처리하는 편이 안전합니다.

Q5. 응답이 늦거나 실패하면 무엇을 확인해야 하나요?
봇 토큰, 허용 사용자 ID, 컨테이너 재시작 여부, OpenClaw 상태, NAS workspace 경로를 순서대로 확인하면 됩니다. 파일만 못 읽는다면 텔레그램이 아니라 workspace 연결 문제일 가능성이 큽니다.