Files
openclaw/agents/budget/workspace/skills/monthly-settlement/SKILL.md
T
hyowons fed3526b20 Initial commit: OpenClaw 워크스페이스 버전관리 시작
설정·스크립트·스킬·문서·큐레이션 메모리 추적.
시크릿(credentials/identity)·런타임 상태(state/logs/sessions/sqlite)·
백업(clobbered/bak)·dream 캐시는 .gitignore로 제외.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-04 15:39:41 +09:00

1.6 KiB

monthly-settlement

매월 1일에 후잉 잔액을 스냅샷으로 저장하고, 전월 스냅샷과 비교해 자산 변동을 리포트한다.

When to use

  • 매월 1일 05:00 KST cron 자동 호출 (agent: budget)
  • 관리자님이 "이번달 결산", "월간 결산", "자산 변동 요약" 요청할 때

How

python3 /Users/snowoyh/.openclaw/agents/budget/workspace/skills/monthly-settlement/scripts/monthly_settlement.py

기본 동작:

  1. whooing_balance.py --json 호출해 현재 순자산/자산/부채 스냅샷 생성
  2. state/monthly_snapshots.json 에서 전월 스냅샷 로드
  3. 계정별 증감 계산 (신규/청산 포함)
  4. 메일 발송: gog gmail send --to mini.snowoyh@gmail.com
    • 제목 [월간결산] YYYY년 M월 자산 변동
    • 모든 계정 증감을 절대값 내림차순으로 정렬
  5. 골디 텔레그램 발송: 순자산 변동 한 줄 + ±100만원 이상 변동 top 5
  6. 이번달 스냅샷을 monthly_snapshots.json 에 저장

첫 실행(비교 대상 없음)은 스냅샷만 저장하고 "첫 결산" 안내만 발송.

Flags

  • --dry-run — 전송·저장 없이 메일/텔레그램 본문만 stdout 출력
  • --no-send — 전송 생략, 스냅샷 저장과 stdout 출력만 수행 (복구/재실행용)
  • --as-of YYYY-MM-DD — 기준일 강제 지정 (기본: 오늘)

Output

마지막 한 줄 요약:

✅ 월간결산 2026-04: 순자산 +1,234,567원, 메일+텔레그램 전송 완료

데이터

  • 스냅샷 저장: state/monthly_snapshots.json (키: YYYY-MM = 스냅샷 시점의 월)
  • 리포트 대상 월: 전월 (스냅샷 시점 기준 직전 달)