#Problema con las tools

1 messages · Page 1 of 1 (latest)

upper sorrel
#

Mi agente no para de decirme problemas con las tools, anteriormente me ayudaste y llegamos a la conclucion de que las esta llamando mal use los modelos kimi k2.5 y minimax m2.1, pudiera yo ensenñartle como llamar correctamente a las tools y esto lo solucionaria?

granite jungleBOT
#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

bitter boneBOT
#

Sí, puedes mejorar mucho el comportamiento metiendo “disciplina de tools” en el prompt estable (AGENTS.md), pero ojo: no es un entrenamiento real. Modelos como Kimi K2.5 y MiniMax M2.1 a veces simplemente no cumplen bien con el formato de tool-calls (inventan nombres de tools, omiten input, meten campos extra, etc.), y eso no siempre se arregla solo con instrucciones.

Qué sí suele arreglarlo (en orden de efectividad)

  1. Cambiar a un modelo más fiable para tools cuando vayas a usar herramientas (aunque mantengas MiniMax/Kimi para chat barato).
    En OpenClaw puedes hacerlo rápido con /model … (y si quieres, volver luego).
    Docs: https://docs.openclaw.ai/help/faq (sección modelos y switching)

  2. Empezar sesión nueva si el error que ves es algo tipo:
    LLM request rejected: messages.content.tool_use.input field required
    Eso es típico cuando el historial quedó raro/stale. Solución: /new.
    Fuente: https://docs.openclaw.ai/help/faq#why-am-i-seeing-llm-request-rejected-messagescontenttool_useinput-field-required

  3. Poner reglas estrictas en AGENTS.md (esto es lo de “enseñarle”):

#

Puedes pegar algo así:

## Tool discipline (strict)
- Solo usa tools que existan en la lista de tools disponibles (no inventes nombres).
- Cuando llames una tool, SIEMPRE incluye `input` y respeta el esquema: nada de campos extra.
- Si no sabes el schema exacto, pregunta antes de llamar la tool (no adivines).
- Una tool call por paso; espera el resultado y recién ahí continúas.
- Si una tool falla 2 veces, para y explica el error al usuario.

Para decirte exactamente cuál te conviene

Pásame el texto exacto del error (copiado tal cual) y, si puedes, también:

  • openclaw --version
  • qué tool estaba intentando llamar (ej: browser, web_fetch, message, etc.)

Con eso te digo si estás en el caso de “modelo no cumple tool schema” vs “historial corrupto” vs “tool no permitida/allowlist”, y cuál es el fix más directo.

upper sorrel
#

[tools] read failed: Missing required parameter: path (path or file_path). Supply correct parameters before retrying.
[tools] write failed: Missing required parameter: path (path or file_path). Supply correct parameters before retrying.

bitter boneBOT
#

Ese error ya es “prueba” de que el modelo está haciendo tool calls inválidas:

  • read failed: Missing required parameter: path
  • write failed: Missing required parameter: path

O sea: el agente intentó llamar read/write sin mandar el argumento obligatorio path (y en write también debería mandar content). Eso no es tu config: es el modelo omitiendo campos del esquema.

¿“Enseñarle” a llamar bien las tools lo soluciona?

Puede ayudar, pero no lo garantiza con Kimi/MiniMax. Estos modelos a veces fallan en “tool discipline” aunque se lo pidas, porque no siguen consistentemente el formato requerido.

Lo más efectivo (te ahorra tiempo)

  1. En esa conversación: /new (para limpiar historial)
  2. Cambia temporalmente a un modelo más fiable para tools con /model … y prueba de nuevo el mismo “read/write”.
    Si con eso desaparece el error, confirmado: era el modelo, no OpenClaw.

(Esto encaja con el FAQ cuando el modelo emite tool blocks malformados o el historial queda raro: https://docs.openclaw.ai/help/faq#why-am-i-seeing-llm-request-rejected-messagescontenttool_useinput-field-required)

#

Si quieres insistir con Kimi/MiniMax (mitigación)

Pon en tu AGENTS.md reglas tipo:

## File tools: hard rules
- NO llames read/write/edit si no tienes un path explícito (confirmado por el usuario).
- Para write SIEMPRE incluye { path, content }.
- Si falta path, pregunta “¿qué archivo exacto?” y no llames la tool.

Pero de nuevo: esto reduce fallos, no los elimina al 100%.

Para afinar el diagnóstico

Pásame:

  • openclaw --version
  • y dime qué estabas intentando hacer justo antes del error (ej: “leer AGENTS.md”, “guardar config”, etc.)