OpenClaw系统监控与收入追踪工具集：Bash脚本与付费技能实践

1. 项目概述与核心价值

最近在折腾OpenClaw环境，发现日常维护和收入管理是两件挺费神的事儿。系统跑久了，磁盘满了、内存飙了都不知道，等技能报错才手忙脚乱去查；另一边，作为独立开发者，GitHub Sponsors、ClawHub上技能销售、偶尔接点零活，收入来源零零散散，每个月到底赚了多少、花了多少、该补多少Token，心里总没个准数。市面上虽然监控工具不少，但要么太重，要么不贴合OpenClaw这套生态。于是，我动手攒了一套工具集，就是OpenClaw Utils。它核心就解决两个问题：让系统健康状态一目了然，以及让个人或小团队的开发收入变得清晰可追踪。这个工具集包含一个完全免费的系统健康监控脚本，和一个功能更深入的自动收入追踪器（付费技能）。所有通过付费技能获得的收入，我都会100%用来购买OpenClaw Token，反哺到服务的持续运行和新工具的开发上。如果你也在用OpenClaw做开发，或者是个管理着多收入来源的自由职业者，这套工具应该能帮你省下不少折腾的时间。

2. 工具设计与实现思路拆解

2.1 为什么选择 Bash + 独立技能的组合？

在设计之初，我考虑了几个方案。一是用Python写个带Web界面的仪表盘，二是用Go编译成单个二进制文件，三是用最朴素的Bash脚本。最终选择了Bash脚本 + ClawHub付费技能的混合架构，主要基于以下几点考量：

1. 极致的轻量与零依赖：系统健康监控的核心诉求是“随时可跑，不添麻烦”。Bash是Linux系统的原生语言，无需安装任何额外的运行时或依赖库。一个脚本文件，chmod +x后就能执行，这对于资源可能本就有限的OpenClaw服务器或VPS来说是最友好的。你甚至可以直接通过curl管道执行，连下载到本地的步骤都能省。

2. 清晰的职责分离：免费工具解决的是普适性、高频次的需求——检查系统基础状态。这类需求功能相对固定，逻辑简单，用Bash实现并开源，能最大程度降低用户的使用门槛和信任成本。而收入追踪涉及数据持久化、复杂计算、外部API集成和隐私，逻辑更复杂，迭代更快。将其作为ClawHub上的付费技能，可以利用OpenClaw生态的安装、更新、付费验证机制，保障了功能的持续维护和开发者的合理回报。

3. 符合Unix哲学：“一个工具只做好一件事”。健康监控脚本就专注在“检查”和“报告”，收入追踪器则专注在“收集”、“计算”和“提醒”。它们可以通过Cron任务组合使用，但彼此独立，避免了单体应用的臃肿。

4. 商业化与可持续发展的平衡：完全免费固然好，但服务器成本、开发时间都是真实的投入。通过将高级功能（收入追踪）设为付费，既能为有深度需求的用户提供价值，又能获得持续维护项目的资金。并且，我承诺将所有收入用于购买OpenClaw Token，这形成了一个小型的正向循环：工具好用 → 用户购买 → 获得Token → 维持/增强服务 → 吸引更多用户。

2.2 系统健康监控器的核心设计要点

这个Bash脚本的设计目标不仅仅是输出一堆数字，而是提供一份可快速解读的健康诊断报告。我重点考虑了以下几点：

• 检查项的选择：并非所有系统指标都值得关注。我筛选了最可能影响OpenClaw及常见技能运行的几项：磁盘空间（避免日志写满）、内存使用（防止OOM Killer杀进程）、CPU负载（反映实时压力）、关键进程（如OpenClaw核心服务）是否存在、网络连通性（影响API调用），以及通过ClawHub CLI检查已安装技能的状态。
• 阈值定义的合理性：警告阈值不能拍脑袋决定。例如，磁盘使用率警告线我设在了80%，这是一个比较通用的临界点，给管理员留出了反应时间。内存和CPU的阈值则动态关联，如果内存使用率超过85%且15分钟平均负载超过CPU核心数的70%，才会触发高级别警告，避免因瞬间波动造成误报。
• 输出的人性化：采用彩色终端输出（使用ANSI转义码），绿色代表正常，黄色代表警告，红色代表严重。同时，输出信息结构化，有清晰的章节分隔和符号标识（✓/⚠/✗），让人一眼就能抓住重点。支持--log参数将结果追加到文件，便于后续回顾或监控系统抓取。
• 执行效率：脚本内所有命令调用（如df,free,uptime,ss）都是轻量级的，整个检查过程通常在1-2秒内完成，几乎不会给系统带来额外负担。

2.3 自动收入追踪器的架构规划

收入追踪器作为一个付费技能，设计上更复杂。我将其规划为几个模块：

1. 数据采集模块：负责从不同源头拉取数据。

   • GitHub Sponsors：通过GitHub REST API（需要Personal Access Token）定期获取赞助金额和赞助者列表。
   • ClawHub：通过解析clawhub list --sales或类似命令的输出（假设未来ClawHub提供更详细的销售API），获取技能销售数据。
   • 手动录入：提供命令行或配置文件接口，让用户可以手动添加Fiverr、Upwork等其他平台的收入，或记录服务器续费、Token购买等支出。

2. 数据存储模块：使用轻量级数据库（如SQLite）本地存储所有收支记录。每条记录包含时间、来源、金额、类型（收入/支出）、分类、备注等字段。SQLite无需单独服务，文件形式易于备份和迁移。

3. 计算与分析模块：

   • 实时统计：计算当日、本周、本月、本年的总收入、总支出、净收入。
   • 趋势分析：生成与上周、上月同期的对比数据（增长/下降百分比）。
   • 预测模型：基于历史收入数据，使用简单的移动平均法预测下个周期的收入，帮助进行财务规划。
   • OpenClaw Token关联：根据当前Token价格（可从公开API获取），计算当前净收入能购买多少Token，并对比预设的月度Token购买目标。

4. 通知提醒模块：集成OpenClaw的通知系统或发送邮件/Telegram消息，在以下情况触发提醒：

   • 每日/每周收入简报。
   • 当支出超过设定的月度预算时。
   • 当Token购买目标完成一定百分比（如50%， 100%）时。
   • 当检测到某收入来源连续多日无进账时（可能意味着需要关注）。

这个架构确保了功能的扩展性，未来可以相对容易地接入新的数据源（如Patreon、支付宝）或增加新的分析维度。

3. 免费工具：系统健康监控器深度解析与实操

3.1 脚本源码核心逻辑剖析

让我们深入看看system-health-monitor.sh这个脚本的关键部分。理解了原理，你不仅能用好它，还能根据需要自己修改。

#!/bin/bash # 1. 定义颜色和符号，让输出更友好 GREEN='\033[0;32m' YELLOW='\033[1;33m' RED='\033[0;31m' NC='\033[0m' # No Color CHECKMARK='✓' WARNING='⚠' CROSS='✗' # 2. 日志功能函数 LOG_FILE="/var/log/openclaw_health.log" log_message() { if [ "$ENABLE_LOG" = true ]; then echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" >> "$LOG_FILE" fi } # 3. 检查磁盘空间的函数 check_disk() { echo -e "\n=== 磁盘使用情况 ===" # 获取根分区（/）的使用情况，-h参数让人读，-B G指定以GB为单位 local disk_info=$(df -h / | tail -1) local total=$(echo $disk_info | awk '{print $2}') local used=$(echo $disk_info | awk '{print $3}') local avail=$(echo $disk_info | awk '{print $4}') local use_percent=$(echo $disk_info | awk '{print $5}' | tr -d '%') echo "根目录: 总空间 $total, 已用 $used, 可用 $avail, 使用率 ${use_percent}%" # 阈值判断逻辑 if [ "$use_percent" -ge 90 ]; then echo -e "${RED}${CROSS} 严重警告：磁盘空间即将耗尽！${NC}" log_message "CRITICAL: Disk usage at ${use_percent}%" return 2 elif [ "$use_percent" -ge 80 ]; then echo -e "${YELLOW}${WARNING} 警告：磁盘使用率较高，建议清理。${NC}" log_message "WARNING: Disk usage at ${use_percent}%" return 1 else echo -e "${GREEN}${CHECKMARK} 磁盘空间正常${NC}" log_message "INFO: Disk usage normal (${use_percent}%)" return 0 fi } # 4. 检查内存使用的函数 check_memory() { echo -e "\n=== 内存使用情况 ===" # free -m 以MB为单位显示，grep Mem获取内存行 local mem_info=$(free -m | grep Mem) local total_mem=$(echo $mem_info | awk '{print $2}') local used_mem=$(echo $mem_info | awk '{print $3}') # 计算使用率，使用bc进行浮点计算，scale=2保留两位小数 local mem_use_percent=$(echo "scale=2; $used_mem * 100 / $total_mem" | bc) echo "内存: 总共 ${total_mem}MB, 已用 ${used_mem}MB, 使用率 ${mem_use_percent}%" # 更精细的阈值：结合缓存和缓冲区的考虑 # 使用 free -m 中的 available 字段（Linux 4.3+）更准确反映可用内存 local avail_mem=$(free -m | grep Mem | awk '{print $7}') local avail_percent=$(echo "scale=2; $avail_mem * 100 / $total_mem" | bc) if (( $(echo "$avail_percent < 10" | bc -l) )); then echo -e "${RED}${CROSS} 严重警告：可用内存不足10%！${NC}" log_message "CRITICAL: Available memory only ${avail_percent}%" return 2 elif (( $(echo "$avail_percent < 20" | bc -l) )); then echo -e "${YELLOW}${WARNING} 警告：可用内存较低（${avail_percent}%）。${NC}" log_message "WARNING: Available memory at ${avail_percent}%" return 1 else echo -e "${GREEN}${CHECKMARK} 内存使用正常${NC}" log_message "INFO: Memory usage normal (available ${avail_percent}%)" return 0 fi } # 5. 主执行流程 main() { echo "================================" echo " OpenClaw 系统健康监控器 " echo "================================" # 解析参数，例如 --log ENABLE_LOG=false for arg in "$@"; do case $arg in --log) ENABLE_LOG=true shift ;; esac done # 依次执行各项检查 local overall_status=0 check_disk; local disk_status=$? check_memory; local memory_status=$? # ... 这里省略了check_cpu, check_process等其它函数调用 # 汇总健康状态 if [ $overall_status -eq 2 ]; then echo -e "\n${RED}=== 系统状态: 严重警告 ===${NC}" elif [ $overall_status -eq 1 ]; then echo -e "\n${YELLOW}=== 系统状态: 需要注意 ===${NC}" else echo -e "\n${GREEN}=== 系统状态: 健康 ===${NC}" fi } # 脚本入口 main "$@"

注意：以上是核心代码片段，完整的脚本还包括check_cpu、check_network、check_openclaw等函数。你可以从GitHub仓库获取完整版。

3.2 完整部署与自动化监控指南

仅仅手动运行脚本还不够，我们需要让它自动化，真正成为系统的“守夜人”。

1. 一键安装与初次运行：正如项目README所示，最快捷的方式是使用curl管道。这条命令做了四件事：下载脚本、保存为文件、赋予执行权限、然后立即运行。

curl -sSL https://raw.githubusercontent.com/lion88728-wq/openclaw-utils/main/tools/system-health-monitor.sh -o system-health-monitor.sh && chmod +x system-health-monitor.sh && ./system-health-monitor.sh

运行后，你会看到类似开头的彩色输出，对系统状态有个即时了解。

2. 配置定时任务（Cron Job）：这是实现自动化监控的关键。我们让系统每天固定时间（比如每小时）自动检查一次。

# 编辑当前用户的cron任务 crontab -e

在打开的编辑器中，添加以下行（假设脚本放在你的家目录~下）：

# 每小时的第5分钟运行一次，并将输出追加到指定日志文件（可选） 5 * * * * /home/你的用户名/system-health-monitor.sh --log >> /home/你的用户名/health_cron.log 2>&1 # 或者，如果你只想在每天早晚高峰时间检查（上午9点和下午6点） 0 9,18 * * * /home/你的用户名/system-health-monitor.sh --log

• 5 * * * *：表示每小时的第5分钟。
• >> ... 2>&1：将脚本的标准输出和错误输出都重定向追加到日志文件，方便日后查阅。
• --log参数会让脚本自己也记录一份简化的日志到/var/log/openclaw_health.log。

3. 与告警系统集成（进阶）：对于更严肃的生产环境，你可能希望当脚本检测到严重状态（返回非0状态码）时，能主动通知你。这可以通过在脚本中集成邮件、Telegram Bot或Webhook来实现。这里给出一个集成sendmail或curl调用Webhook的简单思路：

# 在脚本的main函数汇总判断后，添加如下逻辑 if [ $overall_status -ge 1 ]; then # 状态为警告或严重 ALERT_MESSAGE="【OpenClaw健康告警】服务器 $(hostname) 于 $(date) 检测到问题。详情请查看日志。" # 方式1: 发送邮件（需配置好系统邮件） echo "$ALERT_MESSAGE" | mail -s "系统健康告警" your-email@example.com # 方式2: 调用钉钉/企业微信等Webhook（需提前准备URL） # curl -H "Content-Type: application/json" -X POST -d "{\"msgtype\":\"text\",\"text\":{\"content\":\"$ALERT_MESSAGE\"}}" YOUR_WEBHOOK_URL fi

3.3 自定义监控项与阈值调整

脚本是开源的，你可以根据自己服务器的具体情况调整监控项和阈值。

1. 监控特定目录的磁盘空间：如果你的OpenClaw日志或数据存储在/data分区，而不是根目录/，修改check_disk函数：

# 将 df -h / 改为 df -h /data local disk_info=$(df -h /data | tail -1)

2. 监控特定进程：脚本默认检查openclaw进程。如果你有某个关键的自定义技能进程需要监控，修改或添加check_process函数：

check_critical_process() { local process_name="your_critical_skill" if pgrep -x "$process_name" > /dev/null; then echo -e "${GREEN}${CHECKMARK} 关键进程 [$process_name] 正在运行${NC}" else echo -e "${RED}${CROSS} 错误：关键进程 [$process_name] 未运行！${NC}" return 1 fi } # 然后在main函数中调用 check_critical_process

3. 调整警告阈值：如果你觉得默认的80%磁盘警告太敏感，或者服务器内存大想调高内存阈值，直接修改脚本中的数字即可。例如，将磁盘警告阈值从80改为85：

# 在 check_disk 函数中 # elif [ "$use_percent" -ge 80 ]; then elif [ "$use_percent" -ge 85 ]; then # 修改这里 echo -e "${YELLOW}${WARNING} 警告：磁盘使用率较高，建议清理。${NC}"

4. 付费技能：自动收入追踪器实现详解

4.1 数据采集模块的实战对接

收入追踪器的核心是准确、自动地获取数据。我们以对接GitHub Sponsors API为例，看看如何安全地实现。

1. 创建GitHub Personal Access Token (PAT)：首先，你需要一个具有read:sponsorship权限的PAT来访问赞助数据。

• 登录GitHub，进入Settings->Developer settings->Personal access tokens->Tokens (classic)。
• 点击Generate new token (classic)。
• 给Token起个名字，例如OpenClaw-Income-Tracker。
• 在Select scopes中，勾选read:sponsorship（这是必须的）。
• 生成后，务必立即复制并妥善保存这个Token字符串，它只会显示一次。

2. 设计数据采集脚本 (github_fetcher.py示例)：我们将使用Python的requests库来调用GitHub API。这个脚本应该被收入追踪器主程序定期调用（例如通过Cron）。

#!/usr/bin/env python3 import requests import sqlite3 import os from datetime import datetime, timedelta import json # 配置项 GITHUB_TOKEN = os.environ.get('GITHUB_PAT') # 从环境变量读取Token，更安全 DB_PATH = '/path/to/your/income_tracker.db' def fetch_github_sponsors(): """从GitHub API获取当前用户的赞助信息""" if not GITHUB_TOKEN: print("错误：未设置 GITHUB_PAT 环境变量。") return [] headers = { 'Authorization': f'token {GITHUB_TOKEN}', 'Accept': 'application/vnd.github.v3+json' } # 注意：API端点可能需要根据你是被赞助者还是组织进行调整 # 这里假设你是被赞助的开发者个人 url = 'https://api.github.com/user/sponsorships' all_sponsorships = [] page = 1 while True: params = {'per_page': 100, 'page': page} try: response = requests.get(url, headers=headers, params=params) response.raise_for_status() # 如果状态码不是200，抛出异常 data = response.json() if not data: break # 没有更多数据了 all_sponsorships.extend(data) # 如果返回的数据少于请求的每页数量，说明是最后一页 if len(data) < params['per_page']: break page += 1 except requests.exceptions.RequestException as e: print(f"请求GitHub API失败: {e}") if response.status_code == 401: print("Token可能无效或权限不足。") break return all_sponsorships def parse_and_store(sponsorships): """解析赞助数据并存入数据库""" conn = sqlite3.connect(DB_PATH) cursor = conn.cursor() # 确保表存在（应在主程序中初始化） # cursor.execute('''CREATE TABLE IF NOT EXISTS income # (id INTEGER PRIMARY KEY AUTOINCREMENT, # date DATE NOT NULL, # source TEXT NOT NULL, # amount REAL NOT NULL, # type TEXT CHECK(type IN ('income', 'expense')), # category TEXT, # description TEXT, # raw_data TEXT)''') today = datetime.now().date() for sponsorship in sponsorships: # GitHub Sponsors API返回的数据结构需要仔细解析 # 这里是一个简化示例，实际需要根据API返回的字段调整 sponsor_login = sponsorship.get('sponsor', {}).get('login', 'Unknown') tier = sponsorship.get('tier', {}) amount_cents = tier.get('monthly_price_in_cents', 0) amount_dollars = amount_cents / 100.0 # 判断是否是本月有效的赞助（根据created_at和可能存在的取消时间） created_at = sponsorship.get('created_at') # ... 时间逻辑处理 ... # 插入数据库 cursor.execute(''' INSERT OR IGNORE INTO income (date, source, amount, type, category, description) VALUES (?, ?, ?, ?, ?, ?) ''', (today, 'GitHub Sponsors', amount_dollars, 'income', 'Recurring', f'Sponsor: {sponsor_login}')) conn.commit() conn.close() print(f"成功处理并存储了 {len(sponsorships)} 条赞助记录。") if __name__ == '__main__': # 在实际技能中，Token应从安全的配置管理器中读取，而不是硬编码或环境变量 sponsorships = fetch_github_sponsors() if sponsorships: parse_and_store(sponsorships)

重要安全提示：绝对不要将PAT等敏感信息硬编码在脚本中或提交到Git仓库。在OpenClaw技能中，应使用技能配置面板或安全的密钥管理服务来存储和读取这些凭证。上面的环境变量方式仅用于本地测试演示。

3. 处理ClawHub销售数据：目前ClawHub可能没有提供直接的销售数据API。一个可行的替代方案是，如果你的技能在ClawHub上销售，可以在技能中集成一个简单的Webhook端点。当ClawHub平台有销售时（如果未来支持），它可以向你的这个端点发送一个POST请求，包含交易信息，然后由你的收入追踪器记录到数据库中。在此之前，可能需要手动录入或通过定期检查邮箱（如果Clawhub发送销售邮件）并配合邮件解析脚本来实现半自动化。

4.2 数据库设计与数据分析逻辑

一个设计良好的数据库是收入追踪器的基石。

1. 核心表结构设计：

-- 收支记录表 CREATE TABLE IF NOT EXISTS transactions ( id INTEGER PRIMARY KEY AUTOINCREMENT, transaction_date DATE NOT NULL, -- 交易发生日期 recorded_at DATETIME DEFAULT CURRENT_TIMESTAMP, -- 记录时间 source TEXT NOT NULL, -- 来源：'GitHub Sponsors', 'ClawHub Sale', 'Fiverr', 'Server Cost', 'Token Purchase'等 amount REAL NOT NULL, -- 金额（正数为收入，负数为支出） currency TEXT DEFAULT 'USD', -- 货币，方便后续多币种支持 type TEXT CHECK(type IN ('income', 'expense')) NOT NULL, category TEXT, -- 分类：'Recurring', 'One-time', 'Service', 'Infrastructure'等 description TEXT, -- 描述，如赞助者名字、购买的服务名 project TEXT, -- 可关联到具体项目 tags TEXT, -- 标签，用逗号分隔，如 'open-source,monthly' external_id TEXT UNIQUE, -- 外部ID，如GitHub Sponsorship ID，用于去重 raw_data TEXT -- 原始API响应或数据，用于调试和审计 ); -- 目标与预算表 CREATE TABLE IF NOT EXISTS budgets ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, -- 目标名称，如'Monthly OpenClaw Token Purchase' target_amount REAL NOT NULL, currency TEXT DEFAULT 'USD', period TEXT CHECK(period IN ('daily', 'weekly', 'monthly', 'yearly')) NOT NULL, start_date DATE, end_date DATE, is_active BOOLEAN DEFAULT 1 ); -- 目标进度表（记录目标完成情况） CREATE TABLE IF NOT EXISTS budget_progress ( id INTEGER PRIMARY KEY AUTOINCREMENT, budget_id INTEGER NOT NULL, check_date DATE NOT NULL, current_amount REAL NOT NULL, FOREIGN KEY (budget_id) REFERENCES budgets (id) );

2. 关键数据分析查询示例：有了数据，我们就可以执行有意义的查询。以下是一些直接在SQLite中或通过程序执行的示例：

• 本月净收入：

  SELECT SUM(CASE WHEN type='income' THEN amount ELSE 0 END) as total_income, SUM(CASE WHEN type='expense' THEN amount ELSE 0 END) as total_expense, SUM(CASE WHEN type='income' THEN amount ELSE -amount END) as net_income FROM transactions WHERE strftime('%Y-%m', transaction_date) = strftime('%Y-%m', 'now');

• 各收入来源占比：

  SELECT source, SUM(amount) as amount, ROUND(SUM(amount) * 100.0 / (SELECT SUM(amount) FROM transactions WHERE type='income' AND strftime('%Y-%m', transaction_date) = strftime('%Y-%m', 'now')), 2) as percentage FROM transactions WHERE type='income' AND strftime('%Y-%m', transaction_date) = strftime('%Y-%m', 'now') GROUP BY source ORDER BY amount DESC;

• 月度趋势对比：

  -- 对比本月和上月的总收入 WITH current_month AS ( SELECT COALESCE(SUM(amount), 0) as current_income FROM transactions WHERE type='income' AND strftime('%Y-%m', transaction_date) = strftime('%Y-%m', 'now') ), last_month AS ( SELECT COALESCE(SUM(amount), 0) as last_income FROM transactions WHERE type='income' AND strftime('%Y-%m', transaction_date) = strftime('%Y-%m', date('now', 'start of month', '-1 month')) ) SELECT current_income, last_income, current_income - last_income as change, ROUND((current_income - last_income) * 100.0 / NULLIF(last_income, 0), 2) as change_percent FROM current_month, last_month;

• 预测下月收入（简单移动平均）：

  -- 基于过去3个月的平均收入预测下个月 SELECT AVG(monthly_income) as predicted_income_next_month FROM ( SELECT strftime('%Y-%m', transaction_date) as month, SUM(amount) as monthly_income FROM transactions WHERE type='income' AND transaction_date >= date('now', 'start of month', '-3 months') AND transaction_date < date('now', 'start of month') GROUP BY month ORDER BY month DESC LIMIT 3 );

4.3 安装、配置与使用流程

作为ClawHub上的付费技能，用户的使用体验必须足够简单。

1. 用户侧安装与初始化：用户购买后，通过一条命令安装：

clawhub install auto-income-tracker

安装后，技能会引导用户进行初始化配置：

• 数据库路径：默认在用户目录下（如~/.openclaw/income_tracker.db），用户可以自定义。
• 数据源配置：通过交互式命令行或配置文件 (~/.config/openclaw-income-tracker/config.yaml) 设置。

  # config.yaml 示例 database: path: /home/user/.openclaw/income_tracker.db sources: github: enabled: true # Token将通过技能的安全配置界面输入，而非明文存储在此文件 # token: ${GITHUB_PAT} fetch_schedule: "0 2 * * *" # 每天凌晨2点获取 manual: enabled: true notifications: telegram: enabled: false bot_token: "" chat_id: "" email: enabled: true smtp_server: "smtp.gmail.com" smtp_port: 587 sender: "your-email@gmail.com" # 密码同样通过安全方式配置 # password: ${EMAIL_PASSWORD} recipients: - "your-email@gmail.com" openclaw_token: price_api: "https://api.coingecko.com/api/v3/simple/price?ids=openclaw&vs_currencies=usd" # 示例API monthly_purchase_goal: 5000000 # 月度目标：500万Token

2. 核心命令与日常使用：技能会提供一组CLI命令：

# 查看帮助 income-tracker --help # 手动触发一次数据同步（拉取GitHub Sponsors等） income-tracker sync # 查看当前财务概览 income-tracker overview # 输出示例： # ================================ # 本月财务概览 (2023-10) # ================================ # 总收入: $245.50 # 总支出: $89.99 (服务器: $59.99, Token: $30.00) # 净收入: $155.51 # 可购买OpenClaw Token: ≈ 3,110,200 (当前价格: $0.00005) # 月度目标进度: 62.2% (3.11M / 5M Token) # 查看详细交易记录 income-tracker list --limit 10 income-tracker list --source "GitHub Sponsors" --type income --month 2023-10 # 手动添加一笔记录（用于记录ClawHub销售、Fiverr收入或其他支出） income-tracker add --date 2023-10-26 --source "Fiverr" --type income --amount 50 --category "Freelance" --description "Website fix for client X" # 生成月度报告（可输出为JSON、CSV或发送邮件） income-tracker report --month 2023-10 --format html --send-email # 检查通知设置 income-tracker notifications test

3. 自动化后台运行：技能安装后，会自动注册为一个系统服务或设置Cron任务，根据配置中的fetch_schedule定期运行数据同步和检查通知条件，用户无需手动干预。

5. 常见问题、排查技巧与进阶玩法

5.1 系统健康监控器常见问题

Q1: 运行脚本时提示“权限被拒绝”或“命令未找到”？A1: 这通常有两个原因。一是你没有给脚本添加执行权限，请确保执行了chmod +x system-health-monitor.sh。二是脚本中调用的某些系统命令（如df,free,ss）不在你的$PATH环境变量中，但这在标准Linux发行版中极为罕见。如果是在Docker容器等最小化环境中，可能需要先安装procps和iproute2包。

Q2: 彩色输出在我的终端里显示为乱码？A2: 脚本使用了ANSI转义码来显示颜色。如果终端不支持（例如某些简单的日志文件查看器），颜色代码会显示为乱码。你可以修改脚本，通过检查终端类型来有条件地启用颜色，或者直接使用--plain参数运行一个无颜色的版本（这个功能可以自己添加到脚本中）。

# 在脚本开头添加颜色启用判断 if [ -t 1 ]; then # 标准输出是终端，启用颜色 GREEN='\033[0;32m' # ... 其他颜色定义 else # 标准输出被重定向到文件或管道，禁用颜色 GREEN='' # ... 其他颜色定义为空 CHECKMARK='[OK]' WARNING='[WARN]' CROSS='[ERR]' fi

Q3: Cron任务不执行，或者执行了但没看到日志？A3: Cron环境与你的交互式Shell环境不同。首先，确保Cron任务中的脚本路径是绝对路径（如/home/user/script.sh），而不是相对路径。其次，Cron的PATH通常非常有限，如果脚本依赖某些自定义命令或环境变量，需要在Cron任务中显式设置，或者在脚本开头通过source ~/.bashrc等方式加载你的环境。最后，检查Cron的日志以排查问题：

# 查看系统Cron日志（位置可能因系统而异） sudo tail -f /var/log/syslog | grep CRON # 或 sudo grep CRON /var/log/syslog

Q4: 如何监控多个磁盘分区或特定目录？A4: 如前文“自定义监控项”部分所述，你可以修改check_disk函数，或者复制一份，创建一个新的函数如check_disk_data，将df -h /改为df -h /data或df -h /home，然后在main函数中调用它。更灵活的做法是，将需要监控的路径作为一个数组，在函数中循环检查。

5.2 自动收入追踪器常见问题

Q1: GitHub API Token 权限不足，获取不到赞助数据？A1: 请确保你创建的Personal Access Token (PAT) 在创建时勾选了正确的Scope。对于读取赞助信息，需要read:sponsorship权限。如果是组织账户的赞助，可能需要admin:org的权限。你可以在GitHub的Token设置页面重新编辑Token的权限。另外，API端点也要确认正确，个人账户和组织的端点不同。

Q2: 数据不同步，手动添加的记录和API拉取的重叠了？A2: 这是数据去重的问题。在设计数据库时，我们为transactions表设置了external_id字段并标记为UNIQUE。对于从API拉取的数据，务必将其唯一标识（如GitHub Sponsorship的id字段）存入external_id。在插入数据时使用INSERT OR IGNORE语句，如果external_id已存在，则忽略这条插入，避免重复。对于手动添加的记录，external_id可以留空或使用自定义规则生成。

Q3: 预测模型不准，和实际收入差距很大？A3: 我们实现的简单移动平均（SMA）只是一种基础的预测方法，它假设未来趋势是过去几个周期的平均。对于收入波动较大的情况（例如一次性大额项目收入），SMA可能不准确。可以考虑以下改进：

• 加权移动平均（WMA）：给近期的数据更高的权重。
• 指数平滑（Exponential Smoothing）：另一种考虑时间衰减的平滑方法。
• 引入季节性因素：如果你的收入有明显的月度或季度规律，可以尝试更复杂的模型，如Holt-Winters季节性预测。
• 最重要的是：任何模型都是基于历史数据的推测，仅供参考。对于个人财务，结合对未来已知项目（如已签约的合同）的判断会更可靠。

Q4: 通知功能不工作，收不到提醒邮件？A4: 首先检查技能的通知配置是否正确启用。对于邮件通知，最常见的问题是SMTP服务器配置错误或发送邮箱未开启“允许不够安全的应用”选项（对于Gmail）。建议：

1. 在技能配置中正确填写SMTP服务器、端口（通常587用于TLS）、用户名和密码（可能是应用专用密码）。
2. 测试发送一封邮件：income-tracker notifications test --type email。
3. 查看技能自身的日志文件，通常位于~/.openclaw/logs/income-tracker.log，里面会有更详细的错误信息。
4. 如果使用Telegram Bot，确保Bot Token和Chat ID正确，并且你已经向Bot发送过/start命令。

5.3 进阶技巧与扩展思路

1. 将健康监控集成到仪表盘：如果你有Grafana、Prometheus等监控栈，可以将system-health-monitor.sh的输出进行解析，转化为Prometheus可以抓取的指标格式（如node_disk_used_percent 19.0），然后由Prometheus定期抓取，最终在Grafana上展示出漂亮的图表。这需要编写一个小的适配器脚本。

2. 为收入追踪器添加Web界面：命令行对于开发者很友好，但对于想快速查看数据的用户，一个简单的Web界面更有吸引力。你可以使用轻量级的Python Web框架（如Flask或FastAPI）快速搭建一个本地Web服务。这个服务读取同一个SQLite数据库，提供图表展示（使用Chart.js或ECharts）和简单的过滤查询功能。由于涉及财务数据，务必确保该Web界面只在本地访问（绑定到127.0.0.1）或通过安全的身份验证。

3. 实现多币种支持与汇率转换：如果你的收入来源涉及多种货币（如USD, EUR, CNY），可以在transactions表中增加original_currency和original_amount字段，并添加一个exchange_rates表来记录每日汇率。在统计时，根据交易日期和货币，将所有金额统一换算为基准货币（如USD）再进行计算。可以从免费的汇率API（如exchangerate-api.com）定期获取汇率数据。

4. 与预算工具深度集成：当前的预算功能还比较简单。你可以扩展它，实现 envelope budgeting（信封预算法）或 zero-based budgeting（零基预算法）。例如，创建多个预算信封（如“开发工具”、“服务器费用”、“营销推广”），当记录支出时，不仅记录类别，还指定从哪个“信封”扣除，并实时计算剩余预算，当某个信封超支时触发特别提醒。

5. 开发数据导出与备份策略：定期（如每周）将SQLite数据库加密后备份到云存储（如使用rclone备份到加密的Google Drive或Backblaze B2）。同时，提供一键导出为CSV或Excel的功能，方便用户进行年度报税或更复杂的离线分析。

这套工具集的本质，是把开发者从繁琐的日常运维和财务记录中解放出来。免费的健康监控脚本提供了最基础的保障，而付费的收入追踪器则试图解决一个更复杂、更具长期价值的问题。我的体会是，工具的价值不在于功能有多炫酷，而在于它是否真的能无缝融入你的工作流，安静地解决痛点。在开发过程中，我最大的收获不是代码本身，而是通过梳理自己的收入和支出，对个人项目的财务状况有了前所未有的清晰认识。这反过来又帮助我更好地规划资源，决定将有限的资金投入到哪里（比如购买更多OpenClaw Token来提升服务能力）。如果你在使用中有什么好点子或者遇到了问题，非常欢迎在项目的GitHub仓库提出Issue或讨论。