OpenClaw 건강 에이전트: 월 50달러 아키텍처

Reddit 사용자가 텔레그램을 통해 건강 목표(당뇨 전단계, 식이요법, 운동, 수면)를 추적하는 OpenClaw 에이전트를 구축할 계획입니다. 에이전트는 일일 프롬프트, 사진 분석, 피드백, 트렌드 보고서를 처리합니다. 아래는 소스 게시물과 유사 워크플로우의 실무 지식을 바탕으로 한 기술적 분석입니다.

아키텍처 권장 사항

핵심 패턴: 텔레그램 봇 → OpenClaw 에이전트(LLM 백엔드 포함) → 데이터베이스 → 보고 크론 작업.

텔레그램 봇: python-telegram-bot 또는 node-telegram-bot-api를 사용하여 메시지를 수신하고 사전 알림을 보냅니다. 배경 크론(예: APScheduler 또는 CronJob)을 통해 알림을 예약합니다.
OpenClaw 에이전트: 에이전트는 LLM(GPT-4o 또는 비용 효율적인 Gemini 2.0 Flash)을 시스템 프롬프트와 함께 래핑하여 다음을 수행합니다:
- 식사 사진: 요리 이름, 1인분 추정량, 지중해식 식단 준수 여부를 추출합니다.
- 운동/수면 스크린샷: 구조화된 데이터(예: 걸음 수, 수면 시간)를 파싱합니다.
- 업데이트당 3-4문장의 피드백을 반환합니다.
저장소: 간편한 PostgreSQL 또는 SQLite. 아래 DB 스키마를 참조하세요.
보고: 주간 크론이 집계 쿼리를 실행하고 LLM을 호출하여 자연어 보고서를 생성합니다.

데이터베이스 구조

-- 사용자 테이블
CREATE TABLE users (
  user_id INTEGER PRIMARY KEY,
  telegram_id TEXT UNIQUE,
  goals TEXT,          -- JSON: 식이요법, 운동, 수면, 수분 목표
  blood_test_results TEXT -- JSON, 선택 사항
);

-- 일일 항목 (유형별 하루에 하나)
CREATE TABLE entries (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  user_id INTEGER,
  entry_date DATE,
  type TEXT CHECK(type IN ('sleep', 'water', 'exercise', 'meal')),
  raw_text TEXT,
  raw_image BLOB,       -- 또는 S3 URL
  structured_data JSON, -- 예: {"hours":7.5,"quality":"good"}
  feedback TEXT,
  created_at TIMESTAMP
);
-- 주간/월간 요약 (미리 계산)
CREATE TABLE reports (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  user_id INTEGER,
  period_type TEXT CHECK(period_type IN ('weekly', 'monthly')),
  period_start DATE,
  report_text TEXT,
  generated_at TIMESTAMP
);

이미지 해석 신뢰성

OpenClaw 에이전트는 기본 LLM의 비전 기능에 의존합니다. GPT-4o와 Gemini 2.0 Flash는 지중해식 식단 준수 여부를 잘 식별(채소, 콩류, 올리브 오일 인식)하지만 정확한 1인분 크기에는 어려움을 겪습니다. 헬스장/수면 앱 스크린샷의 경우, 이미지가 선명하면 OCR을 통한 텍스트 추출이 잘 작동합니다. 예산 팁: 이미지에는 Gemini 2.0 Flash(입력 토큰 100만 개당 $0.10)를, 텍스트에는 GPT-4o-mini를 사용하세요.

예산 실현 가능성 (월 50달러)

최적화를 통해 현실적입니다. 예시 분석:

LLM 추론: 하루 약 40-50회 호출(일일 체크인, 사진, 보고서). Gemini 2.0 Flash(입력 100만 토큰당 $0.10, 출력 100만 토큰당 $0.40) 사용 시 → 월 약 $5.
데이터베이스: $5 VPS(예: Hetzner CX22)의 SQLite → 월 $5.
텔레그램 봇 호스팅: 동일 VPS → 포함.
총계: 약 $10-15/월. GPT-4o 폴백(20회 호출, 약 $8) 또는 가끔 Gemini Pro Vision으로 이미지 분석을 위한 여유가 있습니다.

위험 및 누락된 기능

의료 조언 경계: 시스템 프롬프트는 진단이나 전문가 조언 변경을 엄격히 금지해야 합니다. 사용자별 면책 조항을 저장하세요.
개인정보 보호: 저장 시 건강 데이터를 암호화(AES-256)합니다. 다른 사람을 위해 서비스를 제공하는 경우 HIPAA 준수를 고려하세요.
피드백 루프: 사용자가 알림을 무시할 수 있습니다. 점진적 알림(예: 수분 알림 3회 무시 후 재미있는 GIF 전송)을 설계하세요.
주간 보고서 생성: LLM 환각 위험. 메트릭에는 결정론적 집계를 선호하고, LLM은 서술에만 사용하세요.

기존 구성 요소: OpenClaw의 내장 텔레그램 커넥터와 PostgreSQL 템플릿을 적용할 수 있습니다. 기성 건강 에이전트는 없으므로 프롬프트와 DB 스키마를 직접 구축해야 합니다.

📖 전체 출처 읽기: r/openclaw