Your personal finance AI agent — scan receipts, track expenses, query budgets. All from Telegram.
Built with OpenClaw + Actual Budget + Telegram.
Send a photo of a bank slip or receipt — the AI reads it and logs it automatically.
┌─────────────────────────────────────────┐
│ You: │
│ 📷 [bank_transfer_receipt.jpg] │
│ │
│ Penny: │
│ ✅ Logged! │
│ 📅 01 Mar | 💸 -$42.50 │
│ 🏪 Whole Foods Market | 🏦 Checking │
│ 📝 Ref: TXN-20260301-8847 │
└─────────────────────────────────────────┘
Just type the amount and what it was for.
┌─────────────────────────────────────────┐
│ You: 90 lunch │
│ │
│ Penny: │
│ ✅ Logged! │
│ 📅 01 Mar | 💸 -$90.00 │
│ 🏪 lunch | 🏦 Checking │
├─────────────────────────────────────────┤
│ You: grab 150 │
│ │
│ Penny: │
│ ✅ Logged! │
│ 📅 01 Mar | 💸 -$150.00 │
│ 🏪 Grab | 🏦 Checking │
├─────────────────────────────────────────┤
│ You: salary 5000 income Savings │
│ │
│ Penny: │
│ ✅ Logged! │
│ 📅 01 Mar | 💰 +$5,000.00 │
│ 🏪 Salary | 🏦 Savings │
└─────────────────────────────────────────┘
┌─────────────────────────────────────────┐
│ You: how much did I spend this month? │
│ │
│ Penny: │
│ 📊 March 2026 Summary │
│ │
│ 💸 Expenses: -$2,847.50 │
│ 💰 Income: +$5,000.00 │
│ 📈 Net: +$2,152.50 │
│ │
│ Top categories: │
│ 🍔 Food: -$890.00 (31%) │
│ 🚗 Transport: -$650.00 (23%) │
│ 🛒 Shopping: -$520.00 (18%) │
│ 💡 Bills: -$487.50 (17%) │
│ 🎬 Fun: -$300.00 (11%) │
├─────────────────────────────────────────┤
│ You: what's my balance? │
│ │
│ Penny: │
│ 🏦 Account Balances │
│ │
│ Checking: $12,450.00 │
│ Savings: $45,000.00 │
│ Credit Card: -$273.58 │
└─────────────────────────────────────────┘
┌──────────┐ ┌──────────┐ ┌──────────────┐ ┌───────────────┐
│ │ │ │ │ │ │ │
│ Telegram │────▶│ OpenClaw │────▶│ AI Agent │────▶│ Actual Budget │
│ App │◀────│ Server │◀────│ (Penny) │◀────│ (SQLite) │
│ │ │ │ │ │ │ │
└──────────┘ └──────────┘ └──────────────┘ └───────────────┘
phone router reads images stores data
parses text runs queries
calls scripts syncs budgets
- You send a receipt photo or text to your Telegram bot
- OpenClaw routes it to your budget agent
- The agent reads the image (no OCR needed — the AI IS the OCR), extracts transaction details
- add-transaction.js logs it in Actual Budget
- The agent confirms with a clean summary
- Receipt scanning — Send a photo of any bank slip or receipt. The AI reads it directly and extracts date, amount, payee, and account.
- Quick text logging — Type "90 lunch" or "grab 150" and it logs the expense instantly.
- Budget queries — Recent transactions, account balances, monthly summaries, or search by payee.
- Multi-account support — Track checking, savings, credit cards — as many accounts as you need.
- Telegram interface — Works from your phone, anywhere. No app to install.
- Self-hosted — Your financial data stays on your server. No cloud services.
- Docker (for Actual Budget server)
- Node.js v18+ (for integration scripts)
- OpenClaw installed and configured
- A Telegram account
cd setup/
docker compose up -dThis starts Actual Budget at http://localhost:5006. Open it in your browser, create a password, and set up a budget with your bank accounts.
Safari users: If you see a SharedArrayBuffer error when accessing from another device, uncomment the Caddy section in
docker-compose.ymlfor HTTPS support, or click "Advanced options" on the error page.
cd integrations/
npm init -y
npm install @actual-app/apiACTUAL_PASSWORD=yourpass node setup/discover-accounts.jsThis prints your budget IDs and account UUIDs. You'll need these for the next step.
Example output:
=== Available Budgets ===
Name: My Budget 2026
Group ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx <-- use this as "budgetId" in config.json
=== Accounts ===
const ACCOUNTS = {
'Checking': 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
'Savings': 'yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy',
'Credit': 'zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz',
};
cd integrations/
cp config.example.json config.jsonEdit config.json with your Actual Budget password and budget ID from Step 3.
Then update the ACCOUNTS object and BUDGET_LOCAL_ID in:
integrations/add-transaction.jsintegrations/query-budget.jsworkspace/skills/budget/query-budget.js
- Open Telegram, search for @BotFather
- Send
/newbot - Choose a name and username (must end with
_bot) - Copy the bot token
Add these entries to your ~/.openclaw/openclaw.json:
Agent entry (in agents.list):
{
"id": "budget-bot",
"name": "Budget Bot",
"workspace": "/path/to/workspace",
"agentDir": "/path/to/agents/budget-bot/agent"
}Telegram binding (in bindings):
{
"agentId": "budget-bot",
"match": {
"channel": "telegram",
"accountId": "budget-bot"
}
}Telegram account (in channels.telegram.accounts):
"budget-bot": {
"dmPolicy": "pairing",
"botToken": "YOUR_BOT_TOKEN_HERE",
"groupPolicy": "open",
"streaming": "partial"
}Copy the workspace files to your OpenClaw workspace directory:
cp -r workspace/ ~/.openclaw/workspace-budget-bot/Update the file paths in your workspace files:
TOOLS.md— update integration paths and account UUIDsAGENTS.md— update tool command pathsskills/budget/SKILL.md— update tool command pathsskills/budget/query-budget.js— update config pathskills/receipt-parser/SKILL.md— update add-transaction path
# Test adding a transaction
node integrations/add-transaction.js '{"amount":-50,"payee":"Test","notes":"setup test","account":"Checking"}'
# Test querying
node integrations/query-budget.js '{"command":"recent","limit":5}'
# Test balance
node integrations/query-budget.js '{"command":"balance"}'Then restart OpenClaw and message your bot on Telegram. Send /pair to pair your account.
Edit workspace/SOUL.md to change the agent's name, personality, and response style.
Edit workspace/skills/receipt-parser/SKILL.md to add your country's bank slip formats, colors, and logos.
Update the accounts table in workspace/AGENTS.md and the categories list to match your budget setup.
Update workspace/USER.md with your currency symbol and timezone.
├── README.md # This file
├── workspace/ # Agent workspace (copy to ~/.openclaw/)
│ ├── SOUL.md # Agent personality
│ ├── AGENTS.md # Agent protocols
│ ├── USER.md # User profile
│ ├── TOOLS.md # Environment config
│ ├── IDENTITY.md # Quick reference
│ ├── HEARTBEAT.md # Background checks (empty)
│ └── skills/
│ ├── receipt-parser/SKILL.md # Receipt/slip reading protocol
│ └── budget/
│ ├── SKILL.md # Budget query protocol
│ └── query-budget.js # Query script
├── integrations/
│ ├── config.example.json # Config template (copy to config.json)
│ ├── add-transaction.js # Add transactions to Actual Budget
│ └── query-budget.js # Query transactions
└── setup/
├── discover-accounts.js # Find budget IDs & account UUIDs
└── docker-compose.yml # Actual Budget + optional HTTPS
- You send a bank slip photo or text like "90 lunch" to your Telegram bot
- OpenClaw routes the message to your agent
- The agent reads the image (it IS the OCR — no external service needed) or parses the text
- It calls
add-transaction.jsto log the transaction in Actual Budget - It confirms with a clean summary
For queries, the agent calls query-budget.js with commands like recent, balance, summary, or search.
MIT
AI ผู้ช่วยจัดการเงินส่วนตัว — สแกนใบเสร็จ, บันทึกรายจ่าย, ดูสรุปงบประมาณ ทั้งหมดผ่าน Telegram
สร้างด้วย OpenClaw + Actual Budget + Telegram
ส่งรูปสลิปโอนเงินหรือใบเสร็จ — AI อ่านและบันทึกให้อัตโนมัติ
┌─────────────────────────────────────────┐
│ คุณ: │
│ 📷 [สลิปโอนเงิน.jpg] │
│ │
│ Penny: │
│ ✅ บันทึกแล้ว! │
│ 📅 01 มี.ค. | 💸 -฿42.50 │
│ 🏪 ร้านอาหาร | 🏦 KBank │
│ 📝 Ref: TXN-20260301-8847 │
└─────────────────────────────────────────┘
แค่พิมพ์จำนวนเงินกับรายละเอียด
┌─────────────────────────────────────────┐
│ คุณ: 90 ข้าวมันไก่ │
│ │
│ Penny: │
│ ✅ บันทึกแล้ว! │
│ 📅 01 มี.ค. | 💸 -฿90.00 │
│ 🏪 ข้าวมันไก่ | 🏦 KBank │
├─────────────────────────────────────────┤
│ คุณ: grab 150 │
│ │
│ Penny: │
│ ✅ บันทึกแล้ว! │
│ 📅 01 มี.ค. | 💸 -฿150.00 │
│ 🏪 Grab | 🏦 KBank │
├─────────────────────────────────────────┤
│ คุณ: เงินเดือน 50000 รายรับ ออมทรัพย์ │
│ │
│ Penny: │
│ ✅ บันทึกแล้ว! │
│ 📅 01 มี.ค. | 💰 +฿50,000.00 │
│ 🏪 เงินเดือน | 🏦 ออมทรัพย์ │
└─────────────────────────────────────────┘
┌─────────────────────────────────────────┐
│ คุณ: เดือนนี้ใช้ไปเท่าไหร่? │
│ │
│ Penny: │
│ 📊 สรุปเดือนมีนาคม 2026 │
│ │
│ 💸 รายจ่าย: -฿28,475.00 │
│ 💰 รายรับ: +฿50,000.00 │
│ 📈 คงเหลือ: +฿21,525.00 │
│ │
│ หมวดหมู่หลัก: │
│ 🍔 อาหาร: -฿8,900.00 (31%) │
│ 🚗 เดินทาง: -฿6,500.00 (23%) │
│ 🛒 ช้อปปิ้ง: -฿5,200.00 (18%) │
│ 💡 ค่าบิล: -฿4,875.00 (17%) │
│ 🎬 บันเทิง: -฿3,000.00 (11%) │
├─────────────────────────────────────────┤
│ คุณ: ยอดเงินเหลือเท่าไหร่? │
│ │
│ Penny: │
│ 🏦 ยอดเงินในบัญชี │
│ │
│ KBank: ฿124,500.00 │
│ ออมทรัพย์: ฿450,000.00 │
│ บัตรเครดิต: -฿2,735.80 │
└─────────────────────────────────────────┘
┌──────────┐ ┌──────────┐ ┌──────────────┐ ┌───────────────┐
│ │ │ │ │ │ │ │
│ Telegram │────▶│ OpenClaw │────▶│ AI Agent │────▶│ Actual Budget │
│ App │◀────│ Server │◀────│ (Penny) │◀────│ (SQLite) │
│ │ │ │ │ │ │ │
└──────────┘ └──────────┘ └──────────────┘ └───────────────┘
มือถือ เราเตอร์ อ่านรูป เก็บข้อมูล
แปลงข้อความ รันคำสั่ง
เรียกสคริปต์ ซิงค์งบประมาณ
- คุณ ส่งรูปสลิปหรือข้อความไปที่บอท Telegram
- OpenClaw ส่งต่อไปยัง AI agent ของคุณ
- Agent อ่านรูปภาพ (ไม่ต้องใช้ OCR แยก — AI อ่านเองได้เลย) หรือแปลงข้อความ
- add-transaction.js บันทึกรายการใน Actual Budget
- Agent ยืนยันด้วยข้อความสรุป
- สแกนใบเสร็จ — ส่งรูปสลิปโอนเงินหรือใบเสร็จ AI อ่านและดึงข้อมูลวันที่ จำนวนเงิน ร้านค้า และบัญชีให้อัตโนมัติ
- บันทึกรายจ่ายเร็ว — พิมพ์ "90 ข้าวมันไก่" หรือ "grab 150" ระบบบันทึกให้ทันที
- ดูสรุปงบประมาณ — รายการล่าสุด ยอดเงินในบัญชี สรุปรายเดือน หรือค้นหาตามร้านค้า
- รองรับหลายบัญชี — บัญชีออมทรัพย์ บัญชีกระแสรายวัน บัตรเครดิต จะกี่บัญชีก็ได้
- ใช้ผ่าน Telegram — ใช้ได้จากมือถือ ที่ไหนก็ได้ ไม่ต้องติดตั้งแอปเพิ่ม
- โฮสต์เอง — ข้อมูลการเงินอยู่ในเครื่องคุณ ไม่ส่งขึ้นคลาวด์
- Docker (สำหรับ Actual Budget server)
- Node.js v18+ (สำหรับสคริปต์เชื่อมต่อ)
- OpenClaw ติดตั้งและตั้งค่าแล้ว
- บัญชี Telegram
cd setup/
docker compose up -dเปิด Actual Budget ที่ http://localhost:5006 ในเบราว์เซอร์ ตั้งรหัสผ่าน และสร้างงบประมาณพร้อมบัญชีธนาคาร
ผู้ใช้ Safari: ถ้าเจอ SharedArrayBuffer error ตอนเข้าจากเครื่องอื่น ให้เปิดส่วน Caddy ใน
docker-compose.ymlเพื่อรองรับ HTTPS หรือกด "Advanced options" บนหน้า error
cd integrations/
npm init -y
npm install @actual-app/apiACTUAL_PASSWORD=yourpass node setup/discover-accounts.jsจะแสดง budget IDs และ account UUIDs ที่ต้องใช้ในขั้นตอนถัดไป
cd integrations/
cp config.example.json config.jsonแก้ไข config.json ใส่รหัสผ่าน Actual Budget และ budget ID จากขั้นตอนที่ 3
จากนั้นอัปเดต ACCOUNTS และ BUDGET_LOCAL_ID ใน:
integrations/add-transaction.jsintegrations/query-budget.jsworkspace/skills/budget/query-budget.js
- เปิด Telegram ค้นหา @BotFather
- ส่ง
/newbot - ตั้งชื่อและ username (ต้องลงท้ายด้วย
_bot) - คัดลอก bot token
เพิ่มรายการต่อไปนี้ใน ~/.openclaw/openclaw.json:
Agent entry (ใน agents.list):
{
"id": "budget-bot",
"name": "Budget Bot",
"workspace": "/path/to/workspace",
"agentDir": "/path/to/agents/budget-bot/agent"
}Telegram binding (ใน bindings):
{
"agentId": "budget-bot",
"match": {
"channel": "telegram",
"accountId": "budget-bot"
}
}Telegram account (ใน channels.telegram.accounts):
"budget-bot": {
"dmPolicy": "pairing",
"botToken": "YOUR_BOT_TOKEN_HERE",
"groupPolicy": "open",
"streaming": "partial"
}คัดลอกไฟล์ workspace ไปยังไดเรกทอรี OpenClaw:
cp -r workspace/ ~/.openclaw/workspace-budget-bot/อัปเดตพาธไฟล์ใน workspace:
TOOLS.md— อัปเดตพาธและ account UUIDsAGENTS.md— อัปเดตพาธคำสั่งเครื่องมือskills/budget/SKILL.md— อัปเดตพาธคำสั่งเครื่องมือskills/budget/query-budget.js— อัปเดตพาธ configskills/receipt-parser/SKILL.md— อัปเดตพาธ add-transaction
# ทดสอบเพิ่มรายการ
node integrations/add-transaction.js '{"amount":-50,"payee":"ทดสอบ","notes":"ทดสอบระบบ","account":"Checking"}'
# ทดสอบดึงข้อมูล
node integrations/query-budget.js '{"command":"recent","limit":5}'
# ทดสอบยอดเงิน
node integrations/query-budget.js '{"command":"balance"}'จากนั้นรีสตาร์ท OpenClaw และส่งข้อความหาบอทใน Telegram ส่ง /pair เพื่อจับคู่บัญชี
- บุคลิกของ Agent — แก้ไข
workspace/SOUL.mdเพื่อเปลี่ยนชื่อ บุคลิก และสไตล์การตอบ - รูปแบบสลิปธนาคาร — แก้ไข
workspace/skills/receipt-parser/SKILL.mdเพื่อเพิ่มรูปแบบสลิปธนาคารของประเทศคุณ - บัญชีและหมวดหมู่ — อัปเดตตารางบัญชีใน
workspace/AGENTS.mdให้ตรงกับงบประมาณของคุณ - สกุลเงิน — อัปเดต
workspace/USER.mdด้วยสัญลักษณ์สกุลเงินและโซนเวลาของคุณ