📚 문서
모든 기능, 모든 설정.
앱이 하는 모든 것과 가진 모든 설정 — 지금 실행 중인 버전 기준으로 작성했습니다. 메뉴 바부터 스킬 레지스트리까지, 전체 매뉴얼입니다.
빠른 시작
- 설치. .dmg를 다운로드하고 Telebot AI를 응용 프로그램 폴더로 드래그하세요. 아직 공증되지 않은 빌드라 macOS 경고가 뜨면 앱을 마우스 오른쪽 버튼(Control-클릭)으로 클릭하고 열기를 선택하세요 — 한 번이면 됩니다.
- 봇 만들기. 텔레그램에서 @BotFather에게 메시지를 보내 /newbot을 실행하고 토큰을 복사하세요. 봇마다 토큰 하나 — 여러 개를 실행할 수 있습니다.
- 토큰 추가. 메뉴 바에서 Telebot AI를 열고 설정을 연 다음 봇의 토큰 필드에 토큰을 붙여넣으세요. 입력하는 순간 저장됩니다 — 저장 버튼이 없습니다.
- 두뇌 연결. 모델 탭에서 서버 URL(mlx-serve는 http://localhost:11234, Ollama는 http://localhost:11434)과 모델 이름을 설정하거나 OpenAI 호환 클라우드 API를 사용하세요. 테스트를 눌러 연결을 확인합니다.
- 봇 시작. 메뉴 바에서 봇 시작을 선택하세요. 텔레그램에서 봇에게 메시지를 보내면 그 순간부터 답변합니다.
로컬 모델이 처음이신가요? 가이드 읽기 — mlx-serve, Ollama, LM Studio와 각 모델에 필요한 RAM 용량을 다룹니다.
메뉴 바 앱
Telebot AI는 메뉴 바(⌘ 아이콘)에 살고 있습니다. 메뉴에서 할 수 있는 일:
- 시작 / 중지 / 다시 시작 — 봇별로 또는 한 번에. 봇은 LaunchAgent로 실행됩니다: 항상 켜져 있지만 방해하지 않습니다.
- 설정 열기 — 설정 창.
- 로그 — 봇 로그를 실시간으로 확인해 상태를 보거나 문제를 디버깅하세요.
- 종료 — 모든 것을 중지합니다(다시 시작할 때까지 LaunchAgent가 비활성화됩니다).
설정 설명
설정 창에는 두 종류의 페이지가 있는 사이드바가 있습니다:
- 기본값 — 모델, 텔레그램, 앱, 스킬 & 기능, 스킬 레지스트리, 정보, 업데이트. 모든 봇이 상속하는 값입니다.
- 봇 — 봇마다 한 페이지. 각 필드는 이 봇이 실제로 사용하는 값을 보여줍니다: 값이 있으면 기본값을 재정의하고, 빈 필드는 기본값을 상속합니다(각 행 아래의 설명에 표시됩니다). 그래서 "전역 설정 사용" 체크박스가 없는 것입니다 — 빈 필드가 곧 전역 설정 사용입니다.
입력하거나 토글하는 즉시 자동 저장됩니다. 설정은 ~/.mlx-serve/config.json에 저장됩니다.
기본값 → 모델
| 설정 | 역할 |
|---|---|
| 서버 URL | OpenAI 호환 엔드포인트. 로컬 서버는 키가 필요 없습니다. |
| API 키 | 로컬 서버(mlx-serve, Ollama, LM Studio)는 비워두세요. 눈 모양 버튼으로 표시하거나 숨길 수 있습니다. |
| 모델 이름 | 해당 서버에서 사용할 모델, 예: deepseek-v4-flash-free. |
| 테스트 | 현재 값으로 연결을 확인합니다 — 저장 전에 유용합니다. |
| 백업 모델 | 기본 제공자가 실패하거나 제한되면 순서대로 시도됩니다. 각각 자체 닉네임, URL, 키, 모델과 테스트·순서 변경·삭제 기능이 있습니다. 추가 버튼은 마지막 행을 완성해야 활성화됩니다. |
기본값 → 텔레그램
| 설정 | 역할 |
|---|---|
| 허용된 채팅 ID | 봇과 대화할 수 있는 사용자/그룹 ID를 쉼표로 구분. 비우면 모두 허용. |
| 일일 브리핑 시간 | 봇이 일일 브리핑을 보내는 시간 — 24시간제 시/분 드롭다운 (예: 08:00). |
| 브리핑 프롬프트 | 브리핑이 다룰 내용 — 예: "날씨, 오늘의 알림, 가격 알림". |
| 최대 답변 토큰 | 답변의 안전 상한; 긴 답변은 여러 메시지로 분할됩니다. |
| 채팅별 컨텍스트 | 봇이 채팅별로 컨텍스트에 보관하는 최근 메시지 수. |
| 사용자당 메모리 | 봇이 답하는 메시지마다 사용자별로 불러오는 장기 메모리. |
| 메모리 데이터베이스 크기 (사용자별) | 사용자별 최대 저장 메모리 수; 초과 시 가장 오래된 것부터 삭제. |
| 리서치 보고서 토큰 | /research 및 /insiders 보고서용 예산. |
| API 시간 제한 (초) | 느린 제공자를 포기하기까지의 시간(초) — 무료 티어 대기열은 1분 이상 멈출 수 있습니다. |
| Soul 파일 | 봇이 사용하는 페르소나. 이 폴더의 .md 파일(soul*.md, *persona*.md)은 모든 봇의 Soul 드롭다운에 표시됩니다. |
| 봇 트리거 단어 | 그룹에서 봇이 답하게 만드는 단어를 쉼표로 구분(@멘션, 답글, 명령 외) — 예: "momo, jarvis, hey bot". |
| 영상/음성 클립 트리거 단어 | 봇이 첨부된 영상이나 음성을 클립으로 처리하게 하는 단어 — 예: "clip this, save this". |
봇별 페이지
사이드바의 각 봇에는 자체 페이지가 있습니다. 빈 필드는 기본값을 상속하며, 각 행 아래의 설명에 상속 내용이 표시됩니다.
| 설정 | 역할 |
|---|---|
| 토큰 | 봇의 @BotFather 토큰(눈 모양 버튼으로 표시). 변경하면 사이드바의 봇 이름도 바뀝니다. |
| 닉네임 | 상태, 로그, 사이드바에 표시되는 이름 — 예: "트레이딩". |
| 허용된 채팅 ID / 트리거 단어 / 클립 단어 | 해당 기본값에 대한 이 봇의 재정의. |
| 서버 URL, API 키, 모델 | 드롭다운에는 기본값 → 모델에서 설정한 제공자와 사용자 지정 값이 표시됩니다. 봇별로 자체 백업 모델을 추가할 수 있습니다. |
| 일일 브리핑 시간 / 브리핑 프롬프트 | 재정의를 지우는 "전역 설정 사용" 버튼이 있는 봇별 브리핑. |
| 모드 | 리서처, 어시스턴트, 코더, 요리사 또는 없음 — 비우면 기본 모드를 사용합니다. |
| Soul 파일 | 디스크에서 찾은 soul/페르소나 파일 중 선택하는 이 봇의 페르소나 재정의. |
| 스킬 | 봇별 스킬 시트를 엽니다 — 기본값 위에 이 봇의 스킬을 비활성화하거나 기본값으로 재설정할 수 있습니다. |
기본값 → 앱
| 설정 | 역할 |
|---|---|
| Dock에 표시 | 메뉴 바 앱이 Dock에도 표시되는지 여부. |
| 로그인 시 실행 | 로그인할 때 Telebot AI를 시작합니다. |
| 데이터 디렉터리 | 설정, 메모리, 알림, 로그가 저장되는 위치 (기본값 ~/.mlx-serve). |
| 로그 열기 / 데이터 폴더 열기 | Finder에서 로그 파일이나 데이터 폴더로 바로 이동합니다. |
| 설정 내보내기 | 전체 설정(API 키 포함)을 파일로 저장 — 백업 또는 Mac 이동용. |
| 설정 가져오기 | 설정 파일을 불러와 즉시 적용합니다. |
스킬 & 기능
봇의 능력은 모델 기반 스킬입니다 — 모델이 도구와 함께 따르는 일반 지침이라, 명령어를 외우는 대신 원하는 것을 평범한 말로 설명하면 됩니다. 각 그룹에는 마스터 토글이 있고 개별 스킬은 켜고 끌 수 있습니다.
| 그룹 | 스킬 | 이렇게 말해 보세요 |
|---|---|---|
| 리서치 | stock-research, stocks-crypto, insider-trading, currency | "TSLA 리서치", "BTC 가격", "AAPL 내부자 거래", "50 USD는 CAD로 얼마야?" |
| 일일 | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "이 채팅 요약해줘", "오후 5시에 알려줘", "오늘 습관 완료", "주간 리뷰", "/pomodoro 25", "점심 25달러 기록" |
| 미디어 | media, voice, translation, feeds | "이 영상 분석해줘", "이거 소리내어 읽어줘", "이걸 중국어로 번역해줘", "내 피드에 새로운 게 뭐야?" |
| 도구 | memory | "어제 뭐 이야기했지?" |
| 레지스트리에서 | 레지스트리에서 설치한 스킬 | — |
스킬 레지스트리
레지스트리 탭에서는 공개 anthropics/skills 카탈로그에서 완성된 스킬을 설치할 수 있습니다 — PDF 및 문서 처리, 스프레드시트, 프레젠테이션, 웹 앱 테스트, MCP 서버 구축, 아트 등. 카탈로그를 불러와 스킬을 고르면 다른 스킬과 마찬가지로 스킬 & 기능 탭에 나타납니다.
업데이트
업데이트 탭은 설치된 버전과 랜딩 사이트의 매니페스트를 비교해 최신 릴리스를 다운로드 링크와 함께 표시합니다. 확인은 조용히 진행됩니다 — 오프라인이거나 접근할 수 없으면 그냥 "최신 버전"으로 표시됩니다. 업데이트 방법: 새 .dmg를 다운로드해 응용 프로그램 폴더의 기존 앱 위에 드래그하세요. 설정, 봇, 메모리는 앱 외부에 저장되므로 그대로 유지됩니다.
데이터 & 개인정보 보호
- 저장 위치: 설정, 채팅 메모리, 알림, 스킬, 로그는 모두 데이터 디렉터리(기본값 ~/.mlx-serve)에 저장됩니다.
- Mac을 떠나는 것: Telegram API 자체, 봇을 연결한 모델 서버, 익명 사용 통계(앱 실행 및 메뉴 동작). 채팅 내용, 토큰, 개인 데이터는 없습니다.
문제 해결
- "Apple이 악성 소프트웨어가 없는지 확인할 수 없음" — 정상입니다: 응용 프로그램 폴더에서 앱을 마우스 오른쪽 버튼(Control-클릭)으로 클릭 → 열기 → 다시 열기. 한 번이면 그다음부터는 정상 실행됩니다.
- 봇이 답변하지 않습니다. 설정 → 봇 페이지를 열어 토큰이 맞는지 확인하세요. 그다음 기본값 → 모델에서 제공자를 테스트하세요. 마지막으로 로그를 확인하세요(메뉴 바 → 로그 또는 앱 탭 → 로그 열기).
- 답변이 느리거나 봇이 조용해집니다. 무료 티어 제공자는 1분 이상 멈출 수 있습니다 — API 시간 제한을 늘리고 백업 모델을 추가해 기본 제공자가 제한될 때 봇이 대체 모델로 전환하게 하세요.
- 로컬 서버가 응답하지 않습니다. 모델 탭에서 테스트하기 전에 서버(mlx-serve, Ollama…)가 실제로 실행 중인지 확인하세요.
- 업데이트가 이상하게 "최신 버전"이라고 표시됩니다. 확인은 설계상 조용히 진행됩니다 — 매니페스트에 접근할 수 없으면 최신 버전으로 표시합니다.
- 다른 문제가 있으신가요? 피드백 보내기 — 모든 메시지는 개발자의 텔레그램으로 전달되어 실제 답변을 받습니다.
Telebot AI 다운로드 · 마음에 드시나요? 커피 한 잔 사주기 ☕