farmos-finance

What This Skill Does

The farmos-finance skill provides OpenClaw with the capability to perform sophisticated financial oversight for agricultural operations. It serves as an interface for querying complex cash flow projections, detailed cost tracking, and precise breakeven analysis. By connecting to the FarmOS infrastructure, this skill aggregates data from multiple sources—including marketing revenue and operational expenditures—to offer a holistic view of farm performance. Whether you are planning for the next crop year or performing an audit of current expenses, this skill translates raw data into actionable business intelligence, ensuring that financial decisions are grounded in accurate, real-time projections.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Ensure you have the necessary environment variables set for your FarmOS instance. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/brianppetty/farmos-finance

Once installed, verify that the ~/.clawdbot/farmos-users.json file is correctly configured to manage admin-level role mapping, as this skill strictly enforces authentication for sensitive data access.

Use Cases

This skill is designed for farm owners and financial managers who need to monitor fiscal health. Primary use cases include:

• Strategic Planning: Predicting monthly cash flow gaps before they occur by comparing projected marketing revenue against scheduled operational outflows.
• Cost Efficiency: Analyzing cost per acre for specific commodities to identify over-spending or inefficient allocation.
• Risk Management: Calculating breakeven price points for crops to inform forward-contracting decisions and insurance coverage requirements.

Example Prompts

1. "What does our cash flow projection look like for the 2025 crop year?"
2. "Can you break down our cost per acre for corn compared to soybeans?"
3. "What are our biggest expense categories for this season, and how do they impact our breakeven price?"

Tips & Limitations

• Authentication Requirements: This skill mandates admin-level authentication. If a user lacks the appropriate role in the user mapping file, the system will explicitly deny access to sensitive information.
• Data Integrity: Never present partial financial data. If the revenue module or a specific API endpoint returns an error, the skill will report the failure rather than presenting an incomplete or misleading financial summary.
• Accuracy: Always verify that total values are included in your responses. When reporting costs, provide the category aggregation to ensure the user understands the context of the figures presented.