1. 项目概述VetClaw为兽医AI智能体注入专业灵魂如果你是一名兽医或者从事动物健康相关的工作最近肯定没少听说AI。但当你兴致勃勃地打开那些通用的大语言模型想让它帮你分析一个复杂的犬猫病例时结果往往令人沮丧它可能会给出一个看似合理、实则对人类医学更适用的治疗方案完全忽略了物种间的巨大差异。比如它可能建议给猫使用对乙酰氨基酚止痛——而这对于猫科动物是致命的。这种“一本正经地胡说八道”在兽医领域不是玩笑而是潜在的安全事故。这就是VetClaw诞生的背景。它不是另一个聊天机器人也不是一个封闭的应用程序。你可以把它理解为一个专为兽医领域量身定制的“技能插件库”专门服务于像OpenClaw这样的AI智能体框架。简单来说它给通用AI装上了兽医的“专业大脑”和“条件反射”。当AI在处理一个兽医问题时VetClaw提供的技能会强制它遵循兽医特有的思维路径先问物种和品种再查药物在不同动物身上的安全性最后依据兽医领域的证据等级教科书优先于零散的文献进行推理。目前人类医学的AI技能库有超过869个技能而兽医领域在此前是零。VetClaw填补了这个绝对的空白它包含了51个开箱即用的技能覆盖临床诊断、药学安全、物种医学、文献循证等核心领域。其背后的OpenVet.ai团队目标就是为地球上的每一只动物建造一座“AI医院”而VetClaw是这座医院开源的基础设施和操作规程。2. 核心理念与设计原则为什么兽医AI必须与众不同在深入技能细节之前我们必须先理解兽医AI的独特性。直接套用人类医学的AI模型是危险且无效的VetClaw的设计正是建立在以下几个铁律之上。2.1 物种优先一切推理的起点在人类医学中患者是“人”这个前提通常被默认。但在兽医领域“患者是什么动物”是第一个也是最重要的问题。VetClaw的每一个技能都内嵌了“物种优先”原则。药物代谢的“生死之别”经典的例子是对乙酰氨基酚扑热息痛。在犬类它是相对安全的解热镇痛药但在猫体内由于缺乏特定的葡萄糖醛酸结合代谢途径会导致高铁血红蛋白血症引起组织缺氧小剂量即可致死。VetClaw的lethal-variance-detection致死差异检测技能就是专门为此设计的守卫在AI试图提供药物建议前会强制进行物种安全检查。品种带来的疾病倾向一只呼吸困难的斗牛犬和一只同样症状的牧羊犬优先考虑的疾病列表完全不同。斗牛犬的短头综合征、牧羊犬的MDR1基因突变导致伊维菌素等药物神经毒性都是必须纳入考量的因素。breed-predisposition品种易感性技能让AI具备这种“品种意识”从而调整鉴别诊断的权重。2.2 兽医专属的证据体系人类医学的循证金字塔顶端是随机对照试验RCT和Meta分析。兽医循证则有其现实情况教科书与专著仍是金标准由于经费和病例数限制许多兽医领域的高质量RCT很少。因此像《Ettinger’s Textbook of Veterinary Internal Medicine》、《Plumb’s Veterinary Drug Handbook》这类由专科医师委员会编纂的权威教科书在临床决策中占据最高证据等级。文献覆盖不均PubMed上关于犬猫的文献相对丰富但对于马、反刍动物、珍奇物种如爬行动物、鸟类高质量文献非常稀缺。专业数据库兽医有自己独特的数据库如FDA动物药品绿皮书Green Book、动物残留避免数据库FARAD、在线孟德尔遗传动物数据库OMIA等。VetClaw的evidence-grading证据分级和veterinary-pubmed-search兽医PubMed检索等技能编码了这套独特的证据体系引导AI优先引用教科书共识和物种特异性数据库而不是盲目信任通用文献检索结果。2.3 安全绝非可选而是内置的强制流程基于上述两点安全在VetClaw中不是事后检查而是贯穿推理链的强制性步骤。这通过技能的组合调用实现。例如一个“开止痛药”的请求会触发以下连锁反应首先调用species-aware-reasoning物种感知推理确认动物种类。接着lethal-variance-detection会拦截对猫使用NSAIDs非甾体抗炎药的某些类型或对MDR1突变犬使用伊维菌素。然后veterinary-drug-lookup兽医药物查询会提供该物种下的标准剂量范围。最后contraindication-checker禁忌症检查会结合患者的特定情况如肾功能、是否怀孕给出最终警告。这种设计将领域知识固化到工作流中极大地降低了AI因“无知”而产生有害建议的风险。3. 技能库深度解析六大模块如何赋能临床与科研VetClaw的51个技能被系统地组织在六个目录下构成了一个完整的兽医知识推理矩阵。3.1 临床技能从分诊到专科诊疗/skills/clinical目录下的17个技能模拟了从接诊到专科处理的完整临床路径。emergency-triage急诊分诊这不是简单的症状列表而是编码了兽医急诊的“ABCDE”评估法气道、呼吸、循环、神经功能、暴露/环境并集成了toxicology-calculator毒理学计算器用于快速计算摄入毒物的剂量。例如处理“狗吃了巧克力”的案例它能根据巧克力类型、摄入量和体重计算可可碱剂量并对应到轻、中、重度中毒流程。differential-diagnosis鉴别诊断其核心在于生成一个按概率排序的列表并且这个排序受到breed-predisposition技能的动态影响。输入“年轻大型犬跛行”它会列出诸如全骨炎、髋关节发育不良、骨肉瘤等并因品种不同调整顺序。personalized-oncology个性化肿瘤学这是最具前瞻性的技能之一。它提供了一个从肿瘤采样、测序到新生抗原neoantigen预测的分析框架蓝图。虽然不直接执行生物信息学分析但它指导用户或AI如何利用pVACtools、NetMHCpan等开源工具针对犬类DLA或猫类FLA分型进行新生抗原预测为个性化癌症疫苗设计铺路。注意临床技能输出的是“鉴别诊断列表”和“建议检查方案”而非最终诊断。它明确要求输出中必须包含“此列表需由执业兽医师结合临床检查最终确认”的免责声明严格区分了辅助决策与替代决策。3.2 药学与安全技能守住用药的生命线/skills/pharma和/skills/safety目录共同构筑了用药安全的防火墙。veterinary-drug-lookup它对接的不仅是药品说明书更整合了FDA动物药品绿皮书的数据提供权威的适应症、剂量、停药期信息。其查询必须以物种为第一参数。drug-interactions药物相互作用除了常见的药代动力学相互作用特别强调了兽医常见的相互作用如氟喹诺酮类与含阳离子钙、铝的止泻药同服会降低吸收。withdrawal-times停药期针对食品动物牛、羊、猪的技能关联FARAD数据库确保奶、肉、蛋中的药物残留低于法定限值这对养殖业至关重要。安全技能组合toxicology-calculator、lethal-variance-detection、contraindication-checker这三个技能常常被捆绑调用形成“计算毒性剂量 - 筛查物种绝对禁忌 - 检查个体相对禁忌”的三重安全校验链。3.3 物种与循证技能连接知识与实践/skills/species和/skills/literature目录确保了AI的“知识”是正确且可追溯的。物种技能除了常见的犬、猫、马还包含了ruminant反刍动物、avian禽类、camelid骆驼科和swine猪等技能。exotic-wildlife-medicine珍奇野生动物医学技能则提供了处理爬行动物、两栖动物、小型哺乳动物等非传统宠物时的特殊考量如环境温度、特异性病原体等。循证技能evidence-grading技能定义了一个兽医专用的证据等级例如Level 1专科教科书共识、高质量的物种特异性Meta分析。Level 2单个高质量的RCT或队列研究。Level 3病例对照研究、专家意见。Level 4病例报告、体外研究。 当AI引用信息时会附带此等级标签让使用者对证据强度一目了然。textbook-hierarchy教科书层级技能则进一步指明了在冲突时应优先参考哪一本权威著作。3.4 数据库技能结构化数据的桥梁/skills/databases目录下的4个技能提供了与外部权威数据库的“连接器”逻辑。openfda-animal-vet定义了如何查询FDA的动物不良反应事件数据库可以按物种、品种、药物、不良反应类型进行统计用于评估药物的真实世界安全性信号。obo-foundry-ontologies整合了动物疾病本体VBO、动物性状本体VT等生物医学本体使AI能理解“犬传染性肝炎”与“病毒性肝炎”之间的上下位关系进行更精准的语义检索。ncbi-taxonomy确保AI使用的物种学名如Canis lupus familiaris与通用名Dog能正确映射避免数据查询时的歧义。4. 实战演练从安装到运行完整工作流让我们以一个真实的场景 walkthrough 如何使用VetClaw技能。4.1 环境准备与技能安装VetClaw本身不依赖复杂环境它是一组Markdown文件。其运行依赖于一个兼容的AI智能体框架如OpenClaw。假设你已安装OpenClaw。安装步骤# 1. 克隆VetClaw仓库到本地 git clone https://github.com/OpenVet-Projects/VetClaw.git # 2. 在OpenClaw的工作空间目录下创建skills文件夹如果不存在 # 通常OpenClaw的工作空间在 ~/.openclaw/workspace/ mkdir -p ~/.openclaw/workspace/skills # 3. 将VetClaw的所有技能复制到工作空间的skills目录下 # 你可以复制全部也可以只复制你需要的类别如clinical和safety cp -R VetClaw/skills/* ~/.openclaw/workspace/skills/ # 或者仅复制临床和安全模块 # cp -R VetClaw/skills/clinical ~/.openclaw/workspace/skills/ # cp -R VetClaw/skills/safety ~/.openclaw/workspace/skills/ # 4. 启动一个新的OpenClaw会话 # OpenClaw会在启动时扫描并加载workspace/skills下的所有技能 openclaw start安装后OpenClaw智能体就具备了调用这些兽医技能的能力。智能体会根据你的问题自动匹配并激活相关的技能。4.2 案例实操犬巧克力中毒的紧急处理场景你在OpenClaw会话中以兽医或宠物主人的身份输入“我的狗一只10公斤的泰迪大约2小时前吃了50克黑巧克力可可含量约70%。我现在该怎么办”智能体背后的技能调用与推理过程意图识别与技能匹配智能体识别出“巧克力”、“中毒”、“狗”等关键词优先匹配到safety/toxicology-calculator和clinical/emergency-triage技能。执行toxicology-calculator技能数据提取从问题中提取参数物种犬体重10kg巧克力类型黑巧克力70%可可摄入量50g。毒性计算技能内嵌公式。黑巧克力约含7%可可碱。摄入可可碱总量 50g * 7% 3.5g 3500mg。剂量mg/kg 3500mg / 10kg 350 mg/kg。风险分级参照技能内置的犬可可碱毒性分级表100 mg/kg可能中毒兴奋、多尿。200 mg/kg严重中毒癫痫、心律失常。300 mg/kg可能致死。输出“计算完成。摄入可可碱剂量约为350 mg/kg属于严重中毒范围有癫痫和心脏骤停风险。”链式调用emergency-triage技能接收输入从上一个技能接收结果“严重中毒”。启动急诊流程技能遵循“稳定生命体征 - 去污 - 对症支持 - 解毒”的兽医急诊原则。生成行动清单立即行动联系最近的动物急诊医院或宠物毒物控制中心如ASPCA动物毒物控制中心888-426-4435告知计算出的剂量和中毒时间。医疗建议需在兽医指导下进行去污如果摄入在2小时内且动物无神经症状兽医可能会诱导呕吐如使用3%过氧化氢切勿自行操作尤其是有神经症状时。活性炭呕吐后服用活性炭以减少后续吸收。支持治疗静脉输液促进排泄使用苯二氮卓类药物控制癫痫使用β受体阻滞剂控制心动过速。监测持续监测心率、心律、体温和神经状态至少24小时。最终整合输出智能体将两个技能的结果整合生成一段连贯、有层级的回答明确标出风险等级、紧急建议和具体步骤并强调必须立即寻求专业兽医帮助。4.3 案例实操品种相关的诊断支持场景“一只7岁的骑士查理王猎犬听诊发现IV级心杂音。建议进行哪些检查”智能体背后的技能调用与推理过程技能匹配触发species/breed-predisposition和clinical/cardiology-workup。执行breed-predisposition技能查询内部数据库确认骑士查理王猎犬是粘液瘤性二尖瓣疾病MMVD的高发品种且发病年龄早。输出“该品种为MMVD极高风险品种。心杂音很可能源于二尖瓣返流。”链式调用cardiology-workup技能接收品种风险信息将其作为首要考虑。应用ACVIM美国兽医内科学院分期标准根据“无症状心杂音”的特征将患者初步归为B1期或B2期。生成结构化检查方案必需检查超声心动图评估左心房和左心室大小LA/Ao比值 LVIDDN、二尖瓣形态、返流严重程度。这是区分B1心脏未重塑和B2心脏已重塑的金标准。胸部X光侧位和背腹位评估心脏整体轮廓、肺血管纹理和有无肺水肿迹象。血压测量排除系统性高血压作为继发或加重因素。建议检查NT-proBNP检测作为心肌拉伸的生物标志物辅助诊断和监测。Holter监测24小时动态心电图对于有晕厥史或特定品种如拳师犬筛查隐匿性心律失常。输出一份清晰的检查清单并解释每项检查的目的如“超声心动图用于精确分期以决定是否启动匹莫苯丹等药物治疗”。通过这两个案例你可以看到VetClaw技能如何将零散的兽医知识转化为结构化、可重复、安全的推理流程极大地提升了AI辅助决策的可靠性和专业性。5. 高级应用与未来展望从技能库到个性化医疗平台VetClaw的技能库模式只是起点。其真正的潜力在于为更复杂的兽医AI应用提供标准化模块尤其是在前沿的个性化医疗领域。5.1 “罗西案例”的启示AI驱动的个性化癌症疫苗项目文档中提到的“罗西案例”并非虚构它是一个里程碑式的事件。2026年一只名叫罗西的狗通过AI辅助设计的个性化mRNA癌症疫苗战胜了侵袭性肥大细胞瘤。这个过程完美展示了VetClaw技能可能扮演的角色肿瘤测序与新生抗原预测未来personalized-oncology技能可以整合clawbio生物信息学技能中的工具指导用户如何对肿瘤和正常组织进行DNA测序使用pvacseq等流程从体细胞突变中预测能被免疫系统识别的新生抗原。物种特异性验证species-aware-reasoning技能确保所有分析基于犬类基因组CanFam3.1和犬白细胞抗原DLA分型而不是人类HLA。安全性与可行性评估veterinary-drug-lookup虽然这里是疫苗和safety技能可以扩展包含治疗性生物制品的信息和潜在免疫相关不良反应的监测要点。VetClaw的路线图v0.2, v0.3正是朝着这个方向从静态的技能描述发展到包含计算工具的Web界面最终与湿实验室测序、合成形成联动的工作流。5.2 技能开发与集成实践如果你想为VetClaw贡献一个新技能或者将现有技能集成到自己的AI应用中需要理解其技能格式。每个技能是一个文件夹核心是一个SKILL.md文件。其结构严格遵循YAML Frontmatter加Markdown的格式--- name: emergency-triage description: Performs veterinary emergency triage assessment following ABCDE principles and integrates toxicology calculations. --- # 急诊分诊 ## 概述 本技能用于对兽医急诊病例进行初步评估和分级遵循气道、呼吸、循环、神经功能、暴露/环境的ABCDE法则并集成毒理学计算器进行快速风险评估。 ## 何时使用 当用户描述涉及创伤、急性中毒、严重呼吸困难、虚脱、癫痫等急性状况时触发。 ## 关键能力 1. ABCDE系统化评估提问。 2. 集成调用toxicology-calculator进行毒物剂量计算与分级。 3. 提供基于症状严重程度的紧急行动建议立即就医、密切观察、家庭护理。 4. 输出联系宠物毒物控制中心或急诊医院的指引。 ## 工作流程 1. **确认ABCs**首先通过提问评估气道、呼吸、循环是否稳定如“动物现在有意识吗呼吸是否困难牙龈颜色是什么”。 2. **识别威胁生命的紧急情况**如呼吸困难、大出血、虚脱、持续癫痫。 3. **收集关键历史**摄入物、时间、剂量、既往病史。 4. **调用子技能**如涉及毒物调用toxicology-calculator。 5. **生成分诊决策**分为“红色立即转诊”、“黄色尽快就医”、“绿色家庭观察”。 6. **提供具体行动步骤**包括转运注意事项、途中可进行的支持措施。 ## 输出格式 一个结构化的分诊报告包含风险等级、生命体征评估摘要、最可能的紧急问题列表、具体的下一步行动建议带编号的步骤。 ## 局限性 - 不能替代现场兽医体检。 - 对于非急性或慢性问题的分诊准确性有限。 - 依赖于用户提供信息的准确性。开发新技能的关键在于精准描述触发条件、明确输入输出、细化推理步骤、并严格界定能力边界。一个好的技能应该让AI智能体能够像一位经验丰富的兽医专家一样按部就班地思考问题。5.3 与现有系统的融合策略对于兽医诊所或动物健康科技公司集成VetClaw可以有以下路径轻量级集成直接使用其SDK中的参考客户端如OpenFDA兽医不良事件查询API将实时安全数据接入自己的系统。智能体增强在基于OpenClaw或类似框架如LangChain、AutoGen构建的内部助手或客服机器人中导入VetClaw技能文件夹使其具备兽医专业问答能力。工作流引擎将VetClaw技能作为标准化节点嵌入到临床决策支持系统CDSS或电子病历EMR的工作流中。例如当医生在EMR中开具“伊维菌素”时系统自动触发lethal-variance-detection和breed-predisposition技能若患者是柯利犬则弹出强警告并建议进行MDR1基因检测。6. 常见问题、挑战与应对策略在实际部署和使用VetClaw或类似兽医AI技能时会遇到一些典型问题。6.1 技能调用失败或不准问题AI智能体没有正确触发预期的技能或者调用了错误的技能。排查检查技能描述确保SKILL.md文件中的description字段包含了准确、全面的关键词这些关键词是智能体进行语义匹配的基础。检查技能放置路径确认技能文件夹已正确复制到OpenClaw工作空间的skills目录下并且目录结构未被破坏。验证智能体配置不同的智能体框架对技能加载和匹配的机制可能不同。查阅OpenClaw文档确认其技能发现和调用逻辑。解决优化技能描述使用更通用和精准的兽医术语。在开发阶段可以编写简单的测试用例模拟用户输入验证技能是否能被正确触发。6.2 信息过时或缺失问题技能中引用的药物剂量、治疗方案或数据库信息可能不是最新的。挑战兽医知识更新迅速新药、新疗法、新指南不断出现。手动维护所有技能的信息是一项巨大工程。策略明确版本与时效性在每个技能的Limitations部分明确注明其知识截止日期和主要参考来源如“基于Plumbs Handbook第9版”。设计可更新机制技能应尽可能引用外部权威、可动态更新的数据源如FDA Green Book API、OMIA数据库而非将数据硬编码在描述中。建立社区更新流程通过开源社区鼓励兽医专业人士提交Pull Request来更新技能内容。VetClaw的CONTRIBUTING.md文件应详细说明如何安全地更新临床信息。6.3 法律责任与临床责任界定问题这是兽医AI面临的最大挑战。即使有免责声明如果AI提供了错误建议导致不良后果责任如何界定核心原则VetClaw及其技能必须被定位为“兽医专业人员的辅助决策支持工具”而非“自主决策的临床医生”。所有输出都必须包含清晰的、强制的免责声明。实操设计输出水印在所有技能生成的建议末尾自动附加标准免责声明“此信息由VetClaw AI技能生成仅供参考和教育目的不能替代执业兽医的专业诊断、建议或治疗。所有医疗决策必须由持证兽医在亲自检查患者后作出。对于依赖此信息产生的任何后果技能作者和OpenVet.ai不承担任何责任。紧急情况请立即联系兽医或宠物毒物控制中心。”强制确认在关键操作建议如药物剂量、治疗方案前设计交互步骤要求用户假设是兽医或兽医学生确认“我已阅读并理解此信息需经我专业判断后使用”。审计追踪在集成的系统中记录技能调用的完整链条输入、触发的技能、输出便于事后审查。6.4 处理模糊或信息不全的输入问题用户提问“我的狗吐了怎么办”信息极度模糊。技能设计应对优秀的技能应能引导对话。emergency-triage技能不会直接给出答案而是会启动一套标准化问诊流程“为了评估紧急程度我需要了解以下信息1. 呕吐发生多久了频率2. 呕吐物是什么样子食物、黄水、带血3. 狗狗的精神、食欲、排便情况如何4. 它有没有可能误食什么东西5. 牙龈颜色是粉红、苍白还是发黄”通过结构化的问题收集关键信息逐步将模糊问题转化为可被具体技能如differential-diagnosistoxicology-calculator处理的清晰场景。从我过去整合专业知识库到AI系统的经验来看VetClaw最大的价值在于它首次为兽医AI建立了一套可组合、可验证、安全导向的推理范式。它解决的不仅仅是“知识”问题更是“如何安全地运用知识”的问题。对于开发者它提供了即插即用的模块对于兽医从业者它展示了一种人机协作的新可能——AI负责快速检索、计算和提供结构化鉴别列表而兽医则凭借其不可替代的临床触觉、经验智慧和最终决策权做出最负责任的选择。这条路还很长但VetClaw无疑已经打下了第一块也是至关重要的一块基石。