farmos-observations
Query and create field observations and AI-processed captures. Photos, voice notes, and text notes from the field.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/brianppetty/farmos-observationsFarmOS Observations
AI-powered quick capture system — field observations, photos, voice notes, and issue reports.
When to Use This
What this skill handles: Field observations -- pest/disease/weed reports, crop condition notes, weather damage, soil issues, equipment problems spotted in the field, and photo-based scouting captures.
Trigger phrases: "found [pest/weed/disease] in field X", "beans look rough", "something is wrong with field 12", "create an observation", "log this problem", "any observations today?", "what has been reported in field X?"
What this does NOT handle: Equipment maintenance scheduling or fleet status (use farmos-equipment), task/work order creation (use farmos-tasks -- but the bot will offer to create a work order after logging an observation), weather forecasts or spray conditions (use farmos-weather).
Minimum viable input: Any mention of something observed in the field. "Beans look bad" is enough -- the bot will ask smart follow-ups.
Data Completeness
- The
/api/integration/dashboardendpoint is for summary stats only — observation counts and pending reviews. Do NOT use it to list individual observations. - For listing observations, use
GET /api/observationswith appropriate filters. This endpoint is paginated — uselimitparameter and note the total. - Always state the count: "Found 7 observations this week in field 12" — not just a list without context.
- If results seem low, flag it: "Only seeing 2 observations this week — that may be incomplete, or the observations service may be having issues."
- If the service is down, say so plainly. Don't present empty results as "no observations."
API Base
Note: The observations backend may have stability issues (restart loops reported). If endpoints don't respond, report that the observations service appears to be down.
Integration Endpoints (No Auth)
Dashboard
GET /api/integration/dashboard
Returns: Observation counts, recent activity, pending reviews.
Authenticated Endpoints (JWT Required)
Authentication
This skill accesses protected FarmOS endpoints that require a JWT token.
To get a token:
TOKEN=$(~/clawd/scripts/farmos-auth.sh manager)
To use the token:
curl -H "Authorization: Bearer $TOKEN" http://100.102.77.110:8008/api/endpoint
Token expiry: Tokens last 15 minutes. If you get a 401 response, request a new token.
List Observations
GET /api/observations?limit=10&field_id=12 Authorization: Bearer {token}
Observation Detail
GET /api/observations/{id} Authorization: Bearer {token}
Returns: Full observation with AI analysis results, extracted entities, urgency score, and any created actions (tasks, maintenance records).
Create Observation
POST /api/observations Authorization: Bearer {token} Content-Type: multipart/form-data
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-brianppetty-farmos-observations": {
"enabled": true,
"auto_update": true
}
}
}Tags
Related Skills
farmos-workforce
Query employee data, time clock entries, schedules, and requests. Requires authentication — employees see own data, managers see team.
farmos-weather
Query weather data and forecasts for farm fields via the Agronomy module.
farmos-land-portfolio
Query land ownership, leases, landlord info, and land payments. Write operations for payment management and lease renewals.
farmos-tasks
Query and manage farm work orders and tasks. View assignments, create tasks, update status. Uses integration endpoints (no auth) for reads and authenticated endpoints for writes.
farmos-equipment
Query equipment status, maintenance schedules, and service history for the farm fleet. Uses integration endpoints (no auth required).