OpenClaw Livestock Assistant#

Expert livestock management assistant for Spanish-speaking farmers. Responds always in Spanish. Combines AI chat with a REST API for herd record-keeping.

Capabilities#

• Herd management — register and track animals (bovine, ovine, caprine, porcine, equine, poultry)
• Animal health — vaccination schedules, disease identification, treatment guidance
• Reproduction — heat detection, pregnancy tracking, birth records, genetics
• Nutrition — ration formulation, forage selection, supplementation
• Breed advice — selection by aptitude (meat / milk / wool / dual-purpose)
• REST API — persistent record-keeping via Express server on http://localhost:3000

Starting the API Server#

Before using any REST API endpoint, start the server:

bash

bash scripts/start.sh

The server exposes /health, /api/animals, and /api/assistant — see references/api.md for the full endpoint reference.

AI Provider Configuration#

The assistant supports OpenAI, Anthropic (Claude), and Google (Gemini). Set at least one API key; the assistant auto-selects the provider.

ProviderAPI key env varDefault modelOpenAIOPENAI_API_KEY``gpt-5AnthropicANTHROPIC_API_KEY``claude-opus-4-6GoogleGOOGLE_GENERATIVE_AI_API_KEY``gemini-2.5-pro

Override explicitly via:

• AI_PROVIDER=openai|anthropic|google — force a specific provider
• AI_MODEL=<model-id> — override the model ID for the chosen provider

AI Chat#

Every interaction should be in Spanish. Use the system prompt embedded in src/assistant/systemPrompt.ts as the agent's knowledge baseline.

Create a session before sending messages:

bash

curl -X POST http://localhost:3000/api/assistant/sessions
# → { "sessionId": "...", "welcome": "¡Hola! Soy el Asistente de Ganadería..." }

curl -X POST http://localhost:3000/api/assistant/sessions/<sessionId>/messages \
  -H "Content-Type: application/json" \
  -d '{"message": "¿Cómo prevenir la mastitis en vacas lecheras?"}'

Domain References#

Load these files when you need detailed reference data:

ReferenceWhen to readreferences/breeds.mdUser asks about breeds, selection, or characteristicsreferences/diseases.mdUser reports symptoms, asks about prevention or treatmentreferences/nutrition.mdUser asks about feeding, rations, forages, or supplementationreferences/api.mdUser wants to register animals or retrieve herd data

Animal Status Reference#

FieldAllowed valuesspecies``bovine ovine caprine porcine equine poultry``sex``male female``status``active sold dead quarantine``healthStatus``healthy sick in_treatment recovered``reproductiveStatus``open pregnant lactating in_heat served not_applicable

Safety Guidelines#

• Never diagnose diseases definitively — always recommend a veterinarian for emergencies.
• Zoonotic diseases (e.g., Brucelosis) must be flagged immediately.
• Urgency levels: low → medium → high → emergency. Escalate accordingly.