Openclaw Telegram Miniapp — Communication skill for Claude Code

OpenClaw Telegram Mini App

---

소개

**OpenClaw Telegram Mini App**은 Telegram Mini App 안에서 OpenClaw를 제어하고 모니터링하기 위한 한국어 중심 companion UI입니다.

이 저장소는 [clawvader-tech/hermes-telegram-miniapp](https://github.com/clawvader-tech/hermes-telegram-miniapp)을 기반으로 만든 OpenClaw 포크입니다. 원본 프로젝트의 좋은 UX와 MIT 라이선스를 존중하며, OpenClaw Gateway와 운영 흐름에 맞도록 bridge, 인증, 세션, 크론, 시스템 상태 기능을 다시 연결했습니다.

원작자에게 감사드립니다. 이 포크는 원본을 대체하려는 프로젝트가 아니라, **OpenClaw 환경에서 바로 실사용 가능한 Telegram Mini App companion**으로 발전시키는 것을 목표로 합니다.

핵심 기능

1. Terminal

• Telegram 안에서 OpenClaw와 바로 대화
• /command 기반 빠른 운영 명령
• 모델 / 컨텍스트 / 토큰 사용량 표시
• 파일 첨부 UI와 빠른 프롬프트 버튼

2. Status

• OpenClaw Gateway 연결 상태
• 활성 작업 / 세션 수 / 최근 오류 표시
• Cloudflare Tunnel, public origin, bridge diagnostics
• 브리지 / 게이트웨이 복구 액션

3. System

맥미니나 self-hosted 머신 상태를 Mini App에서 바로 확인합니다.

• CPU / 메모리 / 디스크 사용률 카드
• macOS / Apple Silicon / uptime 표시
• OpenClaw 운영 상태 카드
  • Gateway
  • Bridge
  • Tunnel
  • Public origin
• 실행 중인 앱 목록
• CPU 사용량 상위 프로세스 목록
• 보호 로직이 있는 프로세스 종료 버튼
• bridge / cloudflared 최근 오류 요약

Kill 기능은 편의를 위한 운영 보조 기능입니다. `openclaw-gateway`, bridge, launchd, system daemon, 다른 사용자 프로세스는 보호 처리합니다.

4. Agents

• OpenClaw agent / heartbeat 상태 확인
• subagent 목록 확인
• subagent steer / kill 액션 연결

5. Sessions

• 최근 세션 목록 보기
• 세션 상태 / 요약 / 기록 확인
• 특정 세션에 메시지 보내기
• 새 explicit session 생성

6. Cron

• OpenClaw cron 작업 목록
• 작업 생성 / 수정 / 실행 / 일시중지 / 재개 / 삭제
• Telegram 안에서 반복 작업을 빠르게