Xpersona
agentCLAWHUBUnverified

Beancount

Personal bookkeeping assistant for local income and expense tracking, monthly reports with comparisons, budget alerts, and savings goal management. Skill: Beancount Owner: bytesagain-lab Summary: Personal bookkeeping assistant for local income and expense tracking, monthly reports with comparisons, budget alerts, and savings goal management. Tags: latest:2.0.0 Version history: v2.0.0 | 2026-03-17T19:07:18.356Z | user v2.5 standard: Use-when desc, homepage, source, security fix v1.0.4 | 2026-03-16T12:39:34.665Z | user yaml-fix+quality v1.0.3 | 2026-03-16T11:53:02

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.2k

Updated

Oct 10, 2026

Version

2.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/10/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 10, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 10, 2026
Adoption signal
1.2K downloadsadoption · observed Oct 10, 2026
Latest release
2.0.0release · observed Mar 17, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s174pq5f3gzez3838vt2642fmx848f1d:beancount
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-beancount/snapshot"

Documentation

CLAWHUB

24,997 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
version: "2.0.0"
name: Bookkeeping
description: "记账管家。收支记录、月度报表（含同比环比）、预算管理、存钱目标追踪。数据存本地JSON。. Use when you need beancount capabilities. Triggers on: beancount."
  记账理财助手。个人收支记录、月度报表、预算管理、消费分析、储蓄目标。Personal bookkeeping with income/expense tracking, monthly reports, budget management. 记账本、家庭账本、理财规划。Use when tracking personal finances.
author: BytesAgain
homepage: https://bytesagain.com
source: https://github.com/bytesagain/ai-skills
---

# bookkeeping

记账管家。收支记录、月度报表（含同比环比）、预算管理、存钱目标追踪。数据存本地JSON。

## Commands

All commands via `scripts/book.sh`:

| Command | Usage | Description |
|---------|-------|-------------|
| `add` | `book.sh add "金额" "类别" "备注" [--type income\|expense]` | 记一笔账（默认expense） |
| `list` | `book.sh list [--month 2026-03]` | 查看记录（默认当月） |
| `report` | `book.sh report [--month 2026-03]` | 月度收支报表（含同比环比+分类饼图+支出TOP3） |
| `budget` | `book.sh budget "类别" "月预算"` | 设置类别月预算（超支自动提醒） |
| `goal` | `book.sh goal "目标名" "金额" "月数"` | 设置存钱目标（计算每月需存） |
| `goal-save` | `book.sh goal-save "目标名" "金额"` | 往目标里存钱 |
| `goals` | `book.sh goals` | 查看所有存钱目标进度 |
| `help` | `book.sh help` | 显示帮助信息 |

## Data Storage

- 记录文件: `~/.bookkeeping/records.json`
- 预算文件: `~/.bookkeeping/budgets.json`
- 目标文件: `~/.bookkeeping/goals.json`
- 自动创建目录和文件

## Examples

```bash
# 记一笔支出
bash scripts/book.sh add 35.5 餐饮 "午餐外卖"

# 记一笔收入
bash scripts/book.sh add 15000 工资 "3月工资" --type income

# 查看当月记录
bash scripts/book.sh list

# 查看指定月份
bash scripts/book.sh list --month 2026-02

# 生成月度报表（含同比环比）
bash scripts/book.sh report

# 设置餐饮预算
bash scripts/book.sh budget 餐饮 2000

# 设置存钱目标（6个月存8000）
bash scripts/book.sh goal "买相机" 8000 6

# 往目标存钱
bash scripts/book.sh goal-save "买相机" 1500

# 查看所有目标进度
bash scripts/book.sh goals
```

## Categories (建议)

- 支出: 餐饮、交通、购物、娱乐、居住、医疗、教育、其他
- 收入: 工资、奖金、理财、兼职、其他

## Reference

- 参考文档: `tips.md` — 记账理财小贴士（50-30-20法则、存钱技巧等）

## Notes

- 数据存储在 `~/.bookkeeping/` 目录
- JSON 格式，可手动编辑
- 纯本地运行，无需联网
- Python 3.6+ 兼容
---
💬 Feedback & Feature Requests: https://bytesagain.com/feedback
Powered by BytesAgain | bytesagain.com

_meta.json

{
  "ownerId": "kn76vqrf94wk924mddj8fp4p5x8497tb",
  "slug": "beancount",
  "version": "2.0.0",
  "publishedAt": 1773774438356
}

skill-card.md

## Description:

Personal bookkeeping assistant for local income and expense tracking, monthly reports with comparisons, budget alerts, and savings goal management.

This skill is ready for commercial/non-commercial use.

## Publisher:

[bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)

### License/Terms of Use:

MIT-0

## Use Case:

External users and agents use this skill to maintain local personal bookkeeping records, review income and expense reports, manage category budgets, and track savings goals.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill stores personal financial records and command history on local disk without clear permission hardening.

Mitigation: Review storage paths before use, avoid entering secrets in command arguments, and restrict permissions on ~/.bookkeeping and the beancount data directory when storing real data.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/bytesagain-lab/skills/beancount)
- [Publisher profile](https://clawhub.ai/user/bytesagain-lab)

## Skill Output:

**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]

**Output Format:** [Markdown and terminal-oriented text with shell command examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [The skill writes local JSON bookkeeping records, budget data, savings goals, and command history files.]

## Skill Version(s):

2.0.0 (source: frontmatter and release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

tips.md

# 💰 记账理财小贴士

## 为什么要记账？

1. **知道钱花哪了** — 80%的人不知道自己每月最大支出类别
2. **控制消费冲动** — 记账后平均减少15%~20%的非必要支出
3. **实现财务目标** — 有记账习惯的人存钱速度是不记账的2倍

## 记账的黄金法则

### 📌 简单原则
- **随手记** — 花完钱立刻记，别攒到月底
- **分类清晰** — 建议6~8个类别：餐饮、交通、购物、娱乐、居住、医疗、教育、其他
- **不要太细** — "午餐外卖"够了，不需要"午餐外卖-美团-麻辣烫"
- **收入也要记** — 不只是工资，奖金、兼职、红包都要

### 📌 50-30-20法则（最简单的预算方案）
- **50% 必要支出** — 房租/房贷、吃饭、交通、水电
- **30% 可选支出** — 购物、娱乐、旅行、社交
- **20% 储蓄投资** — 存钱、基金定投、保险

### 📌 预算管理要点
- 先设总预算，再分配到各类别
- 预算不是要你不花钱，是帮你花对钱
- 超预算20%以内算正常波动
- 连续3个月超预算就要调整（预算太低or消费太高）
- 餐饮和交通最容易超支，重点关注

## 存钱目标技巧

### 📌 SMART目标法
- **S 具体** — "买iPhone"而不是"买东西"
- **M 可衡量** — "8000元"而不是"一些钱"
- **A 可实现** — 月薪1万别设月存8000的目标
- **R 有意义** — 跟你的生活有关联
- **T 有期限** — "6个月内"而不是"以后"

### 📌 存钱小技巧
1. **365存钱法** — 第1天存1元，第2天存2元…一年存66795元
2. **52周存钱法** — 第1周存10元，每周加10元，一年存13780元
3. **工资分账户** — 发工资当天转20%到不动账户
4. **零花钱存钱罐** — 每天剩余的零钱存起来
5. **消费降级测试** — 每月选1个类别试试花一半

## 月度报表怎么看？

### 📌 关键指标
- **储蓄率** — >20%优秀，10%~20%及格，<10%危险
- **收入增长** — 同比（vs去年同月）反映真实增长
- **支出趋势** — 环比（vs上月）看短期变化
- **最大支出类别** — 占比>40%的类别要重点优化

### 📌 分析套路
1. 先看总收入和总支出的差（结余）
2. 看储蓄率是否达标（>20%）
3. 看TOP3支出类别是否合理
4. 看预算执行情况（哪些超了）
5. 看环比变化（是不是比上月花得多了）

## 常见记账误区

1. ❌ 记太细 → 坚持不下去
2. ❌ 只记支出不记收入 → 不知道储蓄率
3. ❌ 设完预算就不管 → 月底才发现超了
4. ❌ 一笔大的忘记 → 数据不准
5. ❌ 追求完美 → 差几块钱无所谓，趋势比精确重要

## 推荐记账节奏

| 频率 | 做什么 |
|------|--------|
| 每天 | 记录当天收支 |
| 每周 | 看一眼本周花了多少 |
| 每月 | 生成月度报表，检查预算 |
| 每季 | 调整预算和存钱目标 |
| 每年 | 年度总结，制定新年计划 |

---

> 💡 记账不是为了省钱，是为了把钱花在值得的地方。
> 
> 数据来源: 中国家庭金融调查(CHFS)、随手记年度报告

Related agents

Same protocol, similar job.

Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/bytesagain-lab/skills/beancount",
      "sourceUrl": "https://clawhub.ai/bytesagain-lab/skills/beancount",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T23:15:26.480Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-beancount/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-beancount/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T23:15:26.480Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.2K downloads",
      "href": "https://clawhub.ai/bytesagain-lab/beancount",
      "sourceUrl": "https://clawhub.ai/bytesagain-lab/beancount",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T23:15:26.480Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "2.0.0",
      "href": "https://clawhub.ai/bytesagain-lab/beancount",
      "sourceUrl": "https://clawhub.ai/bytesagain-lab/beancount",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-03-17T19:07:18.356Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-beancount/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-beancount/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 2.0.0",
      "description": "v2.5 standard: Use-when desc, homepage, source, security fix",
      "href": "https://clawhub.ai/bytesagain-lab/beancount",
      "sourceUrl": "https://clawhub.ai/bytesagain-lab/beancount",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-03-17T19:07:18.356Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to Beancount and adjacent AI workflows.