Livestock Assistant

---

name: openclaw-livestock-assistant description: > AI-powered livestock management assistant for Spanish-speaking farmers. Provides expert advice on herd management, animal health, reproduction, genetics, nutrition, and breed selection for bovine, ovine, caprine, porcine, equine, and poultry. Includes a Node.js REST API for persistent herd record-keeping (animal registration, health records, reproduction events). Use when the user asks about livestock, cattle, ganadería, herd management, animal health, veterinary advice, breeds, reproduction, nutrition, forage, or any livestock-related topic. version: 1.0.0 metadata: openclaw: requires: env: - OPENAI_API_KEY - ANTHROPIC_API_KEY - GOOGLE_GENERATIVE_AI_API_KEY bins: - node primaryEnv: OPENAI_API_KEY emoji: "🐄" homepage: https://github.com/antonygiomarxdev/openclaw-livestock-assistant install: - kind: node package: ts-node bins: [ts-node]

---

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 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.

| Provider | API key env var | Default model | |---|---|---| | OpenAI | OPENAI_API_KEY | gpt-5 | | Anthropic | ANTHROPIC_API_KEY | claude-opus-4-6 | | Google | GOOGLE_GENERATIVE_AI_API_KEY | gemini-2.5-pro |

Override explicitly via:

AI_PROVIDER=openai|anthropic|google — force a specific provider

AI_MODEL= — 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:

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//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:

| Reference | When to read | |---|---| | references/breeds.md | User asks about breeds, selection, or characteristics | | references/diseases.md | User reports symptoms, asks about prevention or treatment | | references/nutrition.md | User asks about feeding, rations, forages, or supplementation | | references/api.md | User wants to register animals or retrieve herd data |

Animal Status Reference

| Field | Allowed values | |---|---| | species | 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.