2026-03-09 작업 요약

1. Telegram 브리지에 미디어 송수신 기능 추가

• 사진/문서 업로드 수신 후 로컬 저장
• 응답 내 MEDIA:/path 형식을 감지해 Telegram 사진/문서로 전송

2. 장시간 작업 진행 알림 추가

• 작업 시작 시 즉시 진행 안내 메시지 전송
• 1분 단위로 진행중 메시지 전송

3. Telegram 단일 라우팅 경로로 안정화

• OpenClaw gateway 기본 Telegram polling 비활성화
• 커스텀 telegram_router_bridge.py 를 launchd LaunchAgent로 등록
• 중복 polling(409 Conflict) 원인 제거 및 단일 브리지 경로로 정리

4. 운영 스크립트 정리

• 브리지 start/stop 방식을 launchd 기준으로 정리
• 재기동 시 startup notify가 다시 발송되도록 유지

관련 파일

• /Users/pmac/.openclaw/workspace/telegram_router_bridge.py
• /Users/pmac/.openclaw/bin/start_telegram_router_bridge.sh
• /Users/pmac/.openclaw/bin/stop_telegram_router_bridge.sh
• /Users/pmac/.openclaw/workspace/launchd/ai.openclaw.telegram-router.plist

동작 플로우

현재 구조는 Telegram 입력을 커스텀 브리지가 단독으로 받아 라우팅하고, 실행 결과를 텍스트/이미지/파일로 다시 Telegram에 전달하는 형태입니다.

flowchart TD
    A[Telegram 사용자 메시지/파일 전송] --> B[telegram_router_bridge.py 수신]
    B --> C{첨부파일 존재?}
    C -->|예| D[로컬 inbox에 파일 저장]
    C -->|아니오| E[텍스트/캡션만 추출]
    D --> E
    E --> F{명령 유형 판별}

    F -->|/codex ask edit run| G[OpenClaw agent 실행]
    F -->|/fast| H[codex52 에이전트 실행]
    F -->|/lite /local| I[Ollama 로컬 모델 실행]
    F -->|/shortcut /pro| J[Shortcut 경유 질의]
    F -->|/notion| K[Notion API 조회/생성]
    F -->|기타 일반 질의| G

    G --> L[작업 시작 알림 전송]
    H --> L
    I --> L
    J --> L
    K --> M[즉시 결과 생성]

    L --> N{60초 초과?}
    N -->|예| O[1분 단위 진행중 메시지 전송]
    N -->|아니오| P[작업 계속 실행]
    O --> P
    P --> Q[실행 결과 수집]
    M --> Q

    Q --> R{응답에 MEDIA 경로 포함?}
    R -->|예| S[파일 경로 분리]
    R -->|아니오| T[텍스트만 전송]
    S --> U{이미지인가?}
    U -->|예| V[Telegram sendPhoto]
    U -->|아니오| W[Telegram sendDocument]
    T --> X[Telegram sendMessage]
    V --> Y[사용자에게 최종 결과 전달]
    W --> Y
    X --> Y

    Z[launchd LaunchAgent] --> B
    AA[OpenClaw gateway]
    AA -->|브라우저 제어 / 에이전트 실행 지원| G
    AA -->|기본 Telegram polling 비활성화| Z

핵심 포인트

• Telegram polling은 이제 커스텀 브리지만 담당하고, OpenClaw gateway 기본 Telegram provider는 비활성화했습니다.
• 사진/문서는 수신 시 로컬에 저장되고, 요청 텍스트와 함께 실행 컨텍스트로 전달됩니다.
• 실행 결과에 MEDIA:/경로 가 포함되면 이미지면 sendPhoto, 그 외는 sendDocument로 전송됩니다.
• 장시간 작업은 시작 알림 후 1분 단위로 진행중 메시지를 보내도록 변경했습니다.