SMS처리 도우미
Sonolbot Latest Release

소놀봇 최신버전 소개

텔레그램에서 Claude Code와 Codex CLI를 함께 운용하는 AI 작업 실행 환경입니다. Go 기반 런타임으로 속도와 안정성을 높이고, Windows와 macOS를 모두 지원합니다.

Claude Code / Codex 동시 지원 Windows / macOS 지원 설치 파일: GitHub 공식 저장소
Focus Overview

텔레그램으로 AI CLI를 원격 제어하는 실사용형 작업 환경

봇마다 Claude Code 또는 Codex를 선택해 쓰고, 위치·이미지·파일·TASK·Mini App·업데이트까지 하나의 컨트롤 패널에서 관리합니다.

Go 런타임 기반 속도 개선 Claude Code + Codex 혼용 Telegram 중심 원격 작업
Shared Advantage

최신 소놀봇에서 개선된 공통 기능

기존 Python 중심 구조를 Go 기반 실행 구조로 전환하면서 응답 속도, 장시간 작업 안정성, 파일·이미지·위치 처리 정확도를 함께 개선했습니다.

  • 응답속도 대폭 개선컴파일 방식의 Go 런타임으로 전환해 컨트롤 패널, 데몬, 텔레그램 응답 경로의 체감 속도를 높였습니다.
  • 토큰 최적화TASK 단위 작업 메모리와 provider별 지침 분리를 통해 불필요한 토큰 사용을 줄이는 방향으로 정리했습니다.
  • 이전 소놀봇 가져오기기존에 쓰던 소놀봇 설정과 봇 정보를 새 설치 폴더로 가져와 이어서 사용할 수 있습니다.
  • 에러 보고와 업데이트 확인문제가 생기면 로그를 묶어 보낼 수 있고, 새 버전은 컨트롤 패널의 업데이트 확인으로 적용할 수 있습니다.
1 Codex

Codex CLI 지원

Codex CLI를 텔레그램 봇으로 연결해 코딩, 파일 생성, 이미지 입력, TASK 작업을 원격으로 진행할 수 있습니다.

지원 환경
Windows에서는 WSL 기반 실행을 사용하고, macOS에서는 macOS 환경에서 실행합니다.
소놀봇 소개 영상
소개 영상
영상은 참고용입니다. 최신 설치 파일과 설치 방법은 GitHub 공식 저장소를 기준으로 확인해 주세요.
  • 파일 요청 처리사용자가 특정 파일을 달라고 하면 로컬 경로 안내가 아니라 텔레그램 첨부 파일로 받을 수 있습니다.
  • 이미지와 캡처 이해에러 화면이나 작업 이미지를 텔레그램에 올리면 Codex가 해당 이미지를 바탕으로 분석하고 작업할 수 있습니다.
  • Mini App과 TASK 메뉴모델 설정, 작업 목록, TASK 이어하기, 사용량 확인 같은 관리 기능을 텔레그램에서 함께 사용할 수 있습니다.
  • Rewriter 선택 지원필요하면 메인 엔진과 Rewriter 엔진을 분리해 답변 정리 품질과 비용을 조절할 수 있습니다.
2 Claude Code

Claude Code 지원

Claude Code를 텔레그램과 연결해 장시간 코딩 작업, 파일 생성, MCP·스킬 확인, 모델 선택 흐름을 원격으로 사용할 수 있습니다.

지원 환경
Windows와 macOS를 지원합니다. Windows에서는 WSL 기반 실행 환경을 사용합니다.
소놀봇 최신버전 소개 영상
Claude Code 원격 작업
현재 설치와 업데이트는 Codex와 같은 GitHub 공식 패키지에서 함께 제공됩니다.
  • Claude Code 채널 연동텔레그램 메시지를 Claude Code 작업 흐름에 연결하고, 필요한 확인 화면은 텔레그램 버튼으로 이어갈 수 있습니다.
  • 스킬즈 보기 · MCP 보기Claude Code에서 실제로 보이는 스킬과 MCP 상태를 확인하고, 필요한 경우 활성화·비활성화 흐름을 사용할 수 있습니다.
  • 위치 공유 정확도 개선텔레그램에서 위치를 공유한 뒤 근처 맛집, 이동 동선, 주변 정보처럼 위치 기반 질문을 이어갈 수 있습니다.
  • 파일과 이미지 전달 안정화이미지 캡처, 문서, 결과 파일을 작업 맥락에 포함하고 텔레그램으로 다시 전달받는 흐름을 개선했습니다.
Claude Code와 Codex는 봇별로 따로 선택할 수 있습니다. 예를 들어 A봇은 Claude Code, B봇은 Codex로 운영할 수 있습니다.
3 Gemini

Gemini CLI는 준비중

현재 사용자용 정식 provider는 Claude Code와 Codex입니다. Gemini CLI는 향후 지원을 위한 준비 단계입니다.

현재 권장 사용 방식
설치와 봇 생성은 Claude Code 또는 Codex 중 하나 이상을 정상 설치·로그인한 상태에서 진행해 주세요.
준비중입니다.

Gemini CLI는 아직 공식 사용 대상으로 안내하지 않습니다. 공개 시 GitHub 설치 문서와 함께 업데이트하겠습니다.

Setup Guide

설치 파일과 기본 설치 순서

최신 설치 파일은 GitHub 공식 저장소에서 제공합니다. 예전 배포 경로나 영상 댓글 기준이 아니라 아래 GitHub 안내를 기준으로 설치해 주세요.

공식 다운로드

설치 전 준비

소놀봇 자체 설치 전에 운영체제별 기본 실행 환경과 사용할 AI CLI 로그인이 준비되어 있어야 합니다.

  1. Windows는 WSL/Ubuntu가 설치되어 있어야 합니다. Windows에서 Claude Code와 Codex는 WSL 기반으로 실행됩니다.
  2. Windows WSL/Ubuntu 안에는 Python, Node.js, npm, tmux가 준비되어야 합니다.
  3. macOS는 WSL을 쓰지 않고 Mac에 설치된 Claude Code 또는 Codex를 직접 사용합니다.
  4. macOS도 Node.js/npm이 필요하고, 문서·PDF·엑셀 등 고급 스킬까지 안정적으로 쓰려면 Python 3도 준비하는 것이 좋습니다.
  5. Claude Code 또는 Codex CLI 중 최소 하나가 설치되어 있고 로그인되어 있어야 합니다. 둘 중 하나만 정상이어도 소놀봇을 사용할 수 있습니다.

Windows 설치 흐름

Windows에서는 먼저 WSL/Ubuntu와 WSL 내부 도구를 준비한 뒤, Windows용 폴더에서 1~6번 파일을 순서대로 실행합니다.

  1. PowerShell 또는 명령 프롬프트에서 wsl --status로 WSL 설치 여부를 확인합니다.
  2. WSL/Ubuntu가 없다면 wsl --install -d Ubuntu를 실행하고, 재부팅이 필요하면 재부팅합니다.
  3. Windows 시작 메뉴에서 Ubuntu를 실행하거나 PowerShell에서 wsl을 입력해 Ubuntu 터미널을 엽니다.
  4. Ubuntu 처음 실행 시 사용자 이름과 비밀번호를 만듭니다. 비밀번호 입력 문자가 화면에 보이지 않는 것은 정상입니다.
  5. Ubuntu 터미널에서 sudo apt-get update를 실행합니다.
  6. Ubuntu 터미널에서 sudo apt-get install -y python3 python3-pip python3-venv nodejs npm tmux를 실행합니다.
  7. Codex를 쓸 경우 Ubuntu 터미널에서 codex --version이 동작하고, codex 실행 후 로그인까지 완료되어야 합니다.
  8. Claude Code를 쓸 경우 Ubuntu 터미널에서 claude를 직접 실행해 로그인까지 완료되어야 합니다.
  9. 압축을 푼 뒤 sonolbot_universal/windows-amd64/ 폴더에서 1.사전점검.bat을 실행합니다.
  10. 2.설치하기.bat를 실행합니다.
  11. Codex를 사용할 경우 3.코덱스로그인.bat를 실행합니다.
  12. Claude Code를 사용할 경우 4.클로드코드로그인.bat를 실행합니다.
  13. 5.제미나이로그인.bat는 현재 사용하지 않으므로 실행하지 않아도 됩니다.
  14. 6.컨트롤패널.bat를 실행합니다.

macOS 설치 흐름

macOS에서는 본인 Mac 칩에 맞는 폴더에서 터미널을 열고, 실행 권한과 격리 해제를 적용한 뒤 command 파일을 순서대로 실행합니다.

  1. Terminal 앱을 엽니다. Finder에서는 응용 프로그램 > 유틸리티 > 터미널을 실행하면 됩니다.
  2. node --version과 npm --version을 입력해 Node.js/npm 설치 여부를 확인합니다.
  3. Node.js/npm이 없다면 Homebrew 사용자는 brew install node를 실행합니다. Homebrew가 없다면 Node.js 공식 설치 프로그램을 사용해도 됩니다.
  4. 문서 처리 스킬까지 쓸 예정이면 python3 --version을 확인합니다. 없다면 Homebrew 사용자는 brew install python을 실행합니다.
  5. Codex를 쓸 경우 터미널에서 codex --version이 동작하고, codex 실행 후 로그인까지 완료되어야 합니다.
  6. Claude Code를 쓸 경우 터미널에서 claude를 직접 실행해 로그인까지 완료되어야 합니다.
  7. Apple Silicon Mac은 sonolbot_universal/macos-arm64/ 폴더를 사용합니다.
  8. Intel Mac은 sonolbot_universal/macos-amd64/ 폴더를 사용합니다.
  9. 해당 폴더 안의 빈 공간을 마우스 오른쪽 클릭한 뒤 폴더에서 새로운 터미널 열기를 선택합니다.
  10. 터미널에서 chmod +x *.command scripts/run_go_client.sh sonolbot-go-client/sonolbot-client sonolbot-go-client/sonolbot-control-panel을 실행합니다.
  11. 터미널에서 xattr -dr com.apple.quarantine .를 실행합니다.
  12. ./1.사전점검.command를 실행합니다.
  13. ./2.설치하기.command를 실행합니다.
  14. Codex를 사용할 경우 ./3.코덱스로그인.command를 실행합니다.
  15. Claude Code를 사용할 경우 ./4.클로드코드로그인.command를 실행합니다.
  16. ./5.제미나이로그인.command는 현재 사용하지 않으므로 실행하지 않아도 됩니다.
  17. ./6.컨트롤패널.command를 실행합니다.

6번 컨트롤패널 실행 후 필수 설정 순서

컨트롤 패널이 열리면 아래 순서대로 설정합니다. 텔레그램 봇 토큰과 전역 허용 사용자 ID가 모두 필요합니다.

  1. 텔레그램에서 BotFather에게 /newbot을 보내 새 봇을 만듭니다.
  2. BotFather가 발급한 봇 토큰을 복사해 둡니다.
  3. 컨트롤 패널 오른쪽 아래의 전역 허용 사용자 ID 영역에 본인의 Telegram 숫자 ID를 추가합니다. 이 값이 비어 있으면 데몬 시작이 차단됩니다.
  4. 텔레그램 봇 관리 탭에서 봇 추가를 누릅니다.
  5. 봇 토큰을 입력하고 검증합니다.
  6. provider를 선택합니다. Codex를 쓰면 codex, Claude Code를 쓰면 claude-code를 선택합니다.
  7. 실행 환경을 확인합니다. Windows는 wsl, macOS는 macos가 기준입니다.
  8. 필요하면 표시 이름, 메모, 운영 사용가능 여부를 확인합니다.
  9. 기존 소놀봇을 이어서 쓸 경우 이전 소놀봇 가져오기를 먼저 실행하고, 가져온 봇의 provider와 실행 환경을 다시 확인합니다.
  10. 필요하면 Mini App 또는 운영/로그 탭에서 메인 모델과 Rewriter 사용 여부를 조정합니다.
  11. 상단의 시작 버튼을 눌러 데몬을 켭니다.
  12. 텔레그램에서 등록한 봇에게 짧은 메시지를 보내 답변이 오는지 확인합니다.
  13. 문제가 생기면 에러 보고하기를 사용하고, 새 버전이 있으면 업데이트 확인으로 적용합니다.

사용 중 주요 기능

작업 중에는 텔레그램 메뉴와 Mini App을 통해 대부분의 기능을 사용할 수 있습니다.

  1. AI가 작업 중이면 텔레그램에 입력중.. 표시가 나타납니다.
  2. 위치 공유 후 위치 기반 질문을 이어갈 수 있습니다.
  3. 이미지나 에러 캡처를 보내면 provider가 해당 내용을 바탕으로 작업할 수 있습니다.
  4. 파일을 요청하면 가능한 경우 텔레그램 첨부 파일로 받을 수 있습니다.
  5. 문제가 생기면 컨트롤 패널의 에러 보고하기로 로그를 전송할 수 있습니다.
새 버전이 나오면 컨트롤 패널의 업데이트 확인으로 적용할 수 있습니다. 설치 파일과 최신 절차는 항상 GitHub 공식 저장소를 기준으로 확인해 주세요.
X
로그기록