Livestock Assistant

面向西班牙语农户的牲畜管理助手，覆盖牛、绵羊、山羊、猪、马和家禽，就畜群管理、动物健康、繁殖、遗传、营养与品种选择给出建议，并附带可持久登记畜群数据的本地 REST 服务；正文提供品种、疾病、营养与 API 参考文档，回答统一使用西班牙语。

antonygiomarxdev

热度 59.70

最近更新 2026-05-17 15:13:36

分类：知识依赖：代码执行 / 读写文件 / 第三方 API / 内部调用大模型应用场景：教学辅导 / 概念解释 / 健康 / 推荐

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add livestock-assistant

Metadata

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

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:

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.