farmos-marketing

What This Skill Does

The farmos-marketing skill provides OpenClaw with the capability to interface directly with the FarmOS grain marketing stack. It is designed to act as an intelligent layer over a large-scale agricultural operation, processing data related to grain marketing positions, forward contracts, delivery schedules, and complex revenue structures. By leveraging both integration endpoints for rapid summaries and authenticated API access for granular data, this skill allows users to query the state of their corn and soybean operations across multiple entities. It effectively bridges the gap between raw database entries and actionable management insights, ensuring that farm managers and admins can retrieve real-time data regarding bushels sold, open contracts, and settlement histories without needing manual spreadsheet manipulation.

Installation

To add this skill to your OpenClaw environment, ensure you have the clawhub utility installed and your local farmos-auth script configured correctly. Run the following command in your terminal:

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

Following installation, verify that your user account is listed in the ~/.clawdbot/farmos-users.json file. Authentication is strictly enforced: you must possess at least 'manager' level credentials for dashboard viewing and 'admin' status for full data access. Authentication tokens expire every 15 minutes and will require refreshing via the provided script.

Use Cases

• Inventory Management: Querying remaining bushels to identify how much grain is still available for sale across different farm entities.
• Cash Flow Analysis: Utilizing the revenue endpoints to view monthly settlement trends and projected versus contracted sales, assisting in financial planning.
• Delivery Coordination: Monitoring upcoming delivery schedules to optimize logistics during harvest or contract fulfillment windows.
• Market Position Tracking: Rapidly aggregating open contracts to assess current hedge positions or market exposure for corn and soybean crops.

Example Prompts

1. "What is our total marketing position for 2025 corn across all entities?"
2. "Show me the dashboard summary for this week's revenue and pending deliveries."
3. "List all open contracts for entity 2 and let me know if we are under-contracted."

Tips & Limitations

When using this skill, always prioritize the specific authenticated endpoints for accurate data, as the default dashboard endpoints truncate results for performance reasons. Always cross-reference returned counts; if the data looks sparse, the skill will alert you. Note that token rotation is required for continuous monitoring; if you receive a 401 error, trigger the auth helper immediately. If the API base is unreachable or an endpoint fails, the system will report an error rather than presenting incomplete metrics, ensuring data integrity for your farm management decisions.