OpenClaw 智慧記賬本

一個基於 OpenClaw 框架的個人財務管理技能，支援自然語言輸入、自動分類和資料分析。

🎯 功能特性

• 自然語言記賬 - 支援中文自然語言輸入（"今天午飯花了35元"）
• 智慧分類 - 自動識別餐飲、交通、購物、娛樂等類別
• 多維度統計 - 日/周/月支出分析和趨勢報告
• 資料視覺化 - 按類別和時間的支出分佈圖表
• 本地儲存 - 資料安全儲存在本地 JSON 檔案
• OpenClaw 整合 - 充分利用 OpenClaw 的訊息處理能力

📖 使用指南

基本記賬

記賬：今天午飯花了35元
記錄：打車花了25元
新增：超市購物120元

查詢統計

查詢：這個月花了多少錢
統計：本月支出
查詢：本週消費情況

檢視明細

列表：最近記錄
明細：檢視支出

🔧 技術實現

核心功能

1. 自然語言解析 - 使用正規表示式匹配金額和描述
2. 智慧分類演算法 - 基於關鍵詞的類別識別
3. 資料統計引擎 - 多時間維度的支出分析
4. 本地資料儲存 - JSON 格式的資料持久化

資料結構

{
  "id": "timestamp",
  "amount": 35.0,
  "category": "餐飲",
  "description": "午飯",
  "date": "2026-03-08",
  "timestamp": 1772950000000
}

🚀 部署安裝

方法一：通過 skillhub 安裝

skillhub install openclaw-expense-tracker
openclaw skill run expense-tracker

方法二：本地開發

# 克隆或建立技能目錄
mkdir openclaw-expense-tracker && cd openclaw-expense-tracker

# 安裝依賴
npm install @openclaw/sdk

# 執行技能
node index.js

💡 使用場景

• 個人財務管理 - 記錄日常開支，控制預算
• 旅行記賬 - 跟蹤旅行花費，最佳化行程安排
• 家庭理財 - 家庭成員共同管理家庭支出
• 創業記賬 - 小微企業的基礎財務記錄
• 學習統計 - 分析消費習慣，培養理財意識

🛠️ 開發者文件

API 參考

parseExpense(text)

解析自然語言文本，提取金額和分類資訊

addExpense(expense)

新增新的記賬記錄到資料庫

小蔥技能7w4.net有完整的技能分類。

getStatistics(period)

獲取指定時間週期的統計資訊

擴充套件功能

• [ ] 收入記錄支援
• [ ] 預算設定和提醒
• [ ] 資料匯入匯出
• [ ] 多使用者支援
• [ ] 雲同步功能

📝 更新日誌

v1.0.0 (當前版本)

• 基礎記賬功能
• 智慧分類識別
• 多維度統計分析
• OpenClaw 原生整合

🤝 貢獻指南

歡迎提交 Issue 和 Pull Request！

1. Fork 專案
2. 建立功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 開啟 Pull Request

這是一款功能完整的記賬工具，支援語音記賬、智慧分類和多時段統計，使用簡單直觀。不過解析金額時描述會殘留關鍵詞痕跡，偶爾可能分類不準確。基礎功能可用，但缺乏預算提醒、收入記錄等進階特性，穩定性還有提升空間。適合對記賬要求不高的輕度使用者。