Maybe Finance - 个人财务助手 — 技能

技能详情（站内镜像，无评论）

Personal finance management skill using Maybe Finance OS. Use when users need to track expenses, analyze budgets, monitor net worth, or manage personal finan...

开发与 DevOps

作者：antonia huang @antonia-sz

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v1.0.0

统计：⭐ 0 · 21 · 0 current installs · 0 all-time installs

⭐ 0

安装量（当前） 0

🛡 VirusTotal：Pending · OpenClaw ：可疑

Package：antonia-sz/maybe-finance

安全扫描（ClawHub）

VirusTotal：Pending
OpenClaw ：可疑

OpenClaw 评估

The skill's description promises integration with a self‑hosted Maybe Finance API and asks you to provide an API URL/token, but the included code mostly prints mock data and does not actually call the API — the metadata and implementation are inconsistent.

目的

The skill claims to integrate with a Maybe Finance self‑hosted instance (track transactions, manage accounts, etc.). The SKILL.md instructs you to deploy Maybe and set MAYBE_API_URL and MAYBE_API_TOKEN. However, the provided CLI implementation mainly prints hardcoded/mock data for accounts, transactions, budgets, net worth and never invokes the make_api_request helper. Registry metadata lists no required env vars/credentials despite SKILL.md r…

说明范围

SKILL.md stays within the stated domain (deploy Maybe via Docker, set API URL/token, use CLI commands). It does not instruct reading unrelated system files or sending data to third‑party endpoints. However, the instructions imply network/API activity while the code does not perform it — ambiguous scope: user guidance asks for credentials that the shipped code doesn't actually use in its command handlers.

安装机制

No install spec is provided and the skill is instruction + single Python script. Nothing is downloaded or installed automatically by the skill package itself, which lowers risk.

证书

SKILL.md requires MAYBE_API_URL and MAYBE_API_TOKEN (reasonable for a remote API integration). But the registry metadata declares no required env vars/primary credential, so the published manifest is inconsistent with the runtime instructions. That inconsistency is concerning because a user could be prompted to provide sensitive API tokens that the package metadata did not advertise. The code reads those env vars but does not use them in the v…

持久

The skill does not request always:true and there is no indication it modifies other skills or system-wide settings. Default autonomy flags are unchanged. No special persistence or elevated privilege is requested.

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Maybe Finance - 个人财务助手」。简介：Personal finance management skill using Maybe Finance OS. Use when users need t…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/antonia-sz/maybe-finance/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: maybe-finance
description: Personal finance management skill using Maybe Finance OS. Use when users need to track expenses, analyze budgets, monitor net worth, or manage personal finances through the Maybe Finance self-hosted platform. Supports transaction tracking, account management, budget analysis, and financial reporting.
---

# Maybe Finance Skill

Personal finance management powered by [Maybe Finance](https://github.com/maybe-finance/maybe) - an open-source personal finance OS.

## Overview

Maybe Finance is a self-hosted personal finance platform for tracking:
- **Transactions** - Income and expenses
- **Accounts** - Bank accounts, investments, loans
- **Budgets** - Monthly spending targets
- **Net Worth** - Assets minus liabilities over time
- **Cash Flow** - Income vs expenses analysis

## Prerequisites

1. **Self-hosted Maybe instance** - Deploy via Docker:
   ```bash
   docker run -d -p 3000:3000 ghcr.io/maybe-finance/maybe:latest
   ```
2. **API Token** - Generate in Maybe UI: Settings → API Keys

## Configuration

Set environment variables:
```bash
export MAYBE_API_URL="http://localhost:3000"
export MAYBE_API_TOKEN="your-api-token"
```

## Usage

### Account Management
```bash
# List all accounts
maybe-finance accounts list

# Add a new account
maybe-finance accounts add --name "Alipay" --type checking --balance 5000

# Update account balance
maybe-finance accounts update <account-id> --balance 6000

# Delete account
maybe-finance accounts delete <account-id>
```

### Transaction Tracking
```bash
# List recent transactions
maybe-finance transactions list --limit 20

# Add income
maybe-finance transactions add --amount 10000 --type income --category "工资" --description "三月工资"

# Add expense
maybe-finance transactions add --amount -150 --type expense --category "餐饮" --description "午餐"

# Search transactions
maybe-finance transactions search --category "餐饮" --from 2024-01-01 --to 2024-03-31
```

### Budget Analysis
```bash
# View current month budget
maybe-finance budget current

# Analyze spending by category
maybe-finance budget analyze --month 2024-03

# Compare months
maybe-finance budget compare --from 2024-01 --to 2024-03
```

### Net Worth & Reports
```bash
# Current net worth snapshot
maybe-finance networth

# Cash flow report
maybe-finance cashflow --period monthly

# Generate financial summary
maybe-finance summary --year 2024
```

## Scripts

All functionality is available through `scripts/maybe-cli.py`:
- Handles API authentication
- Formats output for readability
- Supports JSON export for further processing

## Integration Ideas

- Connect with CSV import skill for bulk transaction entry
- Schedule daily/weekly financial reports via cron
- Export data for tax preparation
- Alert on budget overruns