v2.2.0

📦 v2.2.0부터 portable zip 이 두 개로 분리되었습니다. rcli (메인 봇) 와 Law Bot 을 독립적으로 다운로드 / 설치 / 실행할 수 있습니다.

받을 것	다운로드
🤖 Claude Code 텔레그램 원격 제어 봇 (rcli)	rcli-v2.2.0.zip (67 MB)
⚖️ 법률 도우미 봇 (Law Bot)	law-bot-v2.2.0.zip (40 MB)

두 zip 은 완전히 독립이며, 같은 PC 에 둘 다 설치해도 서로 영향이 없습니다 (별도 트레이 아이콘 / 별도 프로세스 / 별도 텔레그램 봇 토큰).

---

✨ Highlights

⚖️ Standalone Law Bot

법률 봇이 별도의 Windows 트레이 앱 (dist\Law Bot.exe) 으로 분리되었습니다. 자체 보라색 ⚖️ 천칭 아이콘과 독립 프로세스를 가지며, 메인 rcli 봇을 재시작/재빌드해도 법률 봇은 영향받지 않습니다 — 가족이 함께 쓰는 PC 에 이상적입니다.

• 🟣 전용 트레이/exe 아이콘 (multi-resolution ICO, make-law-icon.ps1 로 자동 생성)
• 🔄 독립 crash watch + 자동 재시작 (최대 3회)
• 🔧 사용자 메시지가 올 때만 "점검 중" 회신 — 종료할 때마다 모든 가족에게 broadcast 하던 동작 제거. launcher 가 봇이 꺼져있는 동안 직접 폴링하여 사용자별 1회만 회신
• 🚀 자동 시작 설정이 기존 bot-state.json 에서 HKCU\Run\LawBot 로 자동 마이그레이션 — 기존 사용자는 재설정 불필요
• 🔒 법률 봇 system prompt 가 한국 법률 주제로 엄격히 잠김 — 코딩, 잡담, 번역, jailbreak 시도 모두 고정 메시지로 거절 (관리자 포함)

🐛 Streaming 응답 버그 수정 (rcli 메인 봇)

오래된 두 가지 streaming 버그를 고쳤습니다:

• 단일 메시지 streaming: 응답이 이제 하나의 메시지 로 in-place 편집됨. 이전엔 청크마다 새 메시지가 발송되어 한 응답이 5+개의 누적 중복 메시지로 도배됐었음. Root cause 는 safeSend() 의 누락된 return 으로 streamingMsgId 가 undefined 였던 것
• 단일 rolling 도구 indicator: 도구 사용 아이콘 (🔍 Glob, 📖 Read, ✏️ Edit 등) 이 하나의 indicator 로 in-place 갱신. 이전엔 도구 호출 사이에 텍스트가 끼면 아이콘이 매번 새로 생겨 채팅에 도배됐음
• 즉시 "thinking" 피드백: 프롬프트 받자마자 🤔 생각하는 중... 메시지를 보내고 첫 텍스트 또는 도구 호출 시 in-place 편집. 모델의 thinking 단계 동안의 침묵 구간 해소

📱 CLI vs 텔레그램 시각 구분

텔레그램 봇은 이제 약식 한 줄 bkit Feature Usage 리포트 (📱 bkit: Tool1, Tool2) 만 출력하므로, 답변이 텔레그램 봇에서 온 것인지 컴퓨터 CLI 에서 온 것인지 한눈에 구분 가능합니다.

---

📦 업그레이드 (v2.0 / v2.1 사용자)

기존 사용자는 본인이 쓰는 봇만 받으면 됩니다:

rcli 만 쓰던 분들:

1. rcli-v2.2.0.zip 다운로드 후 기존 폴더에 덮어쓰기 (또는 새 폴더에 풀고 .env, bot-state.json 만 복사)
2. dist\Claude Telegram Bot.exe 재시작

Law Bot 도 같이 쓰던 분들:

1. 위 + law-bot-v2.2.0.zip 도 별도 폴더에 다운로드
2. 기존 law-bot 의 .env 를 새 zip 의 law-bot/.env 위치로 복사 (토큰/사용자 정보 유지)
3. dist\Law Bot.exe 더블클릭
4. 이전에 자동 시작 켜놨다면 자동으로 HKCU\Run\LawBot 에 마이그레이션됨 — 재설정 불필요

---

🆕 신규 설치

사전 준비

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

rcli (메인 봇)

1. rcli-v2.2.0.zip 다운로드 → 압축 해제
2. setup.bat 실행 → 의존성 설치 + .env 설정 + exe 빌드 (zip 에 prebuilt exe 도 들어있음)
3. dist\Claude Telegram Bot.exe 더블클릭

Law Bot (법률 봇, 선택)

1. law-bot-v2.2.0.zip 다운로드 → 별도 폴더에 압축 해제
2. setup.bat 실행 → 법률 봇 의존성 설치 + Law Bot.exe 빌드
3. dist\Law Bot.exe 더블클릭 → 트레이 → 설정 → 토큰/OC 키/사용자 ID 입력

---

🔧 기타

• 워크플로우 CI fix: npm install --legacy-peer-deps 로 v2.0 / v2.1 빌드 실패 (openai/zod peer dep 충돌) 해결
• 다음 릴리스부터는 GitHub Actions 가 두 zip 을 자동으로 빌드/업로드

Full Changelog: v2.1.0...v2.2.0

v2.0.0 — Full v2 Upgrade

What's New

Phase 1: SDK Upgrade + Foundations

• maxBudgetUsd / effort / compaction SDK options
• PIN SHA-256 hash + state persistence (bot-state.json)
• /setbudget, /effort commands

Phase 2: UX Improvements

• Streaming responses (1.2s throttle editMessage)
• Voice messages (OpenAI Whisper)
• File path detection + download buttons
• Numbered option → inline buttons
• /tree directory view

Phase 3: File Management

• /delete /copy /rename /move /revert /search /grep
• Security: execFile for grep, Windows path traversal fix

Phase 4: Automation

• Webhook server (Express + Bearer auth)
• Cron scheduler (/schedule)
• /teleport session handoff
• /verbose output control

Phase 5: Polish

• Telegraph for long responses
• config.js constant extraction
• File split: bot.js(2615) + i18n.js(591) + commands.js(394) + utils.js(330)

Portable

• claude-telegram-bot.exe — Node.js 내장, 설치 없이 실행

v1.5.1 — Secure PIN Input

Installation

Prerequisites

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

Quick Install

1. Download and extract the zip
2. Run setup.bat (installs dependencies + configures .env)
3. Launch dist\Claude Telegram Bot.exe

Manual Install

1. Extract the zip
2. Copy .env.example to .env and set your tokens
3. npm install (node_modules included in zip, can skip)
4. Run dist\Claude Telegram Bot.exe or node bot.js

Full Changelog: v1.5.0...v1.5.1

v1.5.0 — Multi-Language Support (Korean/English)

Installation

Prerequisites

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

Quick Install

1. Download and extract the zip
2. Run setup.bat (installs dependencies + configures .env)
3. Launch dist\Claude Telegram Bot.exe

Manual Install

1. Extract the zip
2. Copy .env.example to .env and set your tokens
3. npm install (node_modules included in zip, can skip)
4. Run dist\Claude Telegram Bot.exe or node bot.js

Full Changelog: v1.4.0...v1.5.0

v1.4.0

Installation

Prerequisites

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

Quick Install

1. Download and extract the zip
2. Run setup.bat (installs dependencies + configures .env)
3. Launch dist\Claude Telegram Bot.exe

Manual Install

1. Extract the zip
2. Copy .env.example to .env and set your tokens
3. npm install (node_modules included in zip, can skip)
4. Run dist\Claude Telegram Bot.exe or node bot.js

Full Changelog: v1.3.4...v1.4.0

v1.3.4

Installation

Prerequisites

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

Quick Install

1. Download and extract the zip
2. Run setup.bat (installs dependencies + configures .env)
3. Launch dist\Claude Telegram Bot.exe

Manual Install

1. Extract the zip
2. Copy .env.example to .env and set your tokens
3. npm install (node_modules included in zip, can skip)
4. Run dist\Claude Telegram Bot.exe or node bot.js

Full Changelog: v1.3.3...v1.3.4

v1.3.3

Installation

Prerequisites

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

Quick Install

1. Download and extract the zip
2. Run setup.bat (installs dependencies + configures .env)
3. Launch dist\Claude Telegram Bot.exe

Manual Install

1. Extract the zip
2. Copy .env.example to .env and set your tokens
3. npm install (node_modules included in zip, can skip)
4. Run dist\Claude Telegram Bot.exe or node bot.js

Full Changelog: v1.3.2...v1.3.3

v1.3.2

Installation

Prerequisites

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

Quick Install

1. Download and extract the zip
2. Run setup.bat (installs dependencies + configures .env)
3. Launch dist\Claude Telegram Bot.exe

Manual Install

1. Extract the zip
2. Copy .env.example to .env and set your tokens
3. npm install (node_modules included in zip, can skip)
4. Run dist\Claude Telegram Bot.exe or node bot.js

Full Changelog: v1.3.1...v1.3.2

v1.3.1

Installation

Prerequisites

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

Quick Install

1. Download and extract the zip
2. Run setup.bat (installs dependencies + configures .env)
3. Launch dist\Claude Telegram Bot.exe

Manual Install

1. Extract the zip
2. Copy .env.example to .env and set your tokens
3. npm install (node_modules included in zip, can skip)
4. Run dist\Claude Telegram Bot.exe or node bot.js

Full Changelog: v1.3.0...v1.3.1

v1.3.0

Installation

Prerequisites

• Node.js 20+
• Claude Code CLI (npm i -g @anthropic-ai/claude-code)

Quick Install

1. Download and extract the zip
2. Run setup.bat (installs dependencies + configures .env)
3. Launch dist\Claude Telegram Bot.exe

Manual Install

1. Extract the zip
2. Copy .env.example to .env and set your tokens
3. npm install (node_modules included in zip, can skip)
4. Run dist\Claude Telegram Bot.exe or node bot.js

Full Changelog: v1.2.3...v1.3.0