fal-consumption-audit

What This Skill Does

The fal-consumption-audit skill is a robust financial auditing tool designed for OpenClaw agents to monitor, reconcile, and analyze infrastructure costs against user-side charges. It provides an automated bridge between the platform's official usage reports from fal.ai and the internal accounting records within fal_tasks, PointsDetail, and FinancialTransactions. By aggregating these disparate data points, the skill identifies inconsistencies in billing, flags potential overcharging or undercharging, and detects anomalies in API key usage patterns, ensuring financial integrity for the agent service provider.

Installation

To integrate this auditing capability into your OpenClaw environment, run the following command in your terminal: clawhub install openclaw/skills/skills/hexiaochun/fal-consumption-audit Ensure your FalAccount credentials are correctly configured in your database to allow the skill to access the fal Platform API.

Use Cases

• Periodic Financial Reconciliation: Automate the monthly or weekly audit of costs incurred via fal.ai vs. revenue generated from user credits.
• Anomaly Detection: Automatically highlight users or API keys exhibiting unusual spikes in cost_money without corresponding user account deductions.
• Refund Validation: Verify that refunded tasks are correctly processed across all ledgers, ensuring no double-dipping or missed balance adjustments.
• Profit Margin Monitoring: Analyze the spread between real-time infrastructure costs and the pricing models configured for end-users.

Example Prompts

1. "消耗审计：请核对过去七天所有 fal 账号的开销，并对比用户积分明细是否存在异常。"
2. "用量异常排查：最近系统余额波动较大，请执行一次全面对账，列出所有实际成本与用户扣费不一致的任务。"
3. "fal 对账报告：汇总本月所有用户的模型消耗情况，并生成一份关于积分扣除是否准确的审计报告。"

Tips & Limitations

• Time Sensitivity: Always specify a clear start and end date in your audit requests to prevent long-running queries from timing out.
• Data Consistency: This skill relies on the accurate mapping of api_key across FalAccount and FalTasks tables. If keys are rotated frequently, ensure the linkage is updated promptly.
• API Rate Limits: Be mindful of fal Platform API rate limits when auditing large date ranges; the skill is optimized for batch-processed reporting rather than high-frequency real-time analysis.
• Scope: This tool is strictly for consumption auditing. It does not perform automated corrective actions (like force-refunding) to avoid unintended financial discrepancies; it generates reports for administrator review.