Compatible con OpenAI

Usa Hermes Agent con IteraCompute

Conecta un agente de terminal a IteraCompute.

Conéctate en tres pasos

1. Cree una clave API

Cree o inicie sesión en su cuenta IteraCompute, luego cree una clave en la consola.

2. Configurar la URL base

Configura un proveedor personalizado con nombre y chat_completions. Python AIAgent y CLI usan perfiles independientes.

3. Selecciona el modelo

Utilice el ID de modelo API exacto para el modelo elegido.Verifique su contexto y capacidades antes de habilitar las funciones de agente o visión.

Elige tu modelo

DeepSeek V4.1 Flash 1017 es el modelo de referencia de pago. Puedes sustituirlo por un modelo de conversación publicado que permita tu clave. Revisa permisos, precios, contexto y herramientas al cambiar. Los ejemplos siguen tu selección; los resultados conservados siguen correspondiendo a Qwen.

Prepara un entorno aislado

Usa un checkout aislado de Hermes Agent v0.23.0 y HERMES_HOME. Exporta ITERACOMPUTE_API_KEY en la terminal de inicio.

Bash / macOS / Linux / WSL
git clone --branch v0.23.0 --depth 1 \
  https://github.com/NousResearch/hermes-agent.git hermes-agent-v0.23.0
cd hermes-agent-v0.23.0
test "$(git rev-parse HEAD)" = \
  "2bd378ed1b8d6bf2192cb26e0a55ff3091e6bd19"
export HERMES_HOME="$PWD/.hermes-iteracompute-cli"
export HERMES_RUNTIME_DIR="$HERMES_HOME/tools"
umask 077
mkdir -p "$HERMES_HOME"
source ./activate
hermes --version
hermes pm doctor
Bash · Clave en la terminal actual
umask 077
read -rsp 'IteraCompute API key: ' ITERACOMPUTE_API_KEY
printf '\n'
export ITERACOMPUTE_API_KEY

Hermes CLI puede añadir reasoning_effort=medium para un modelo personalizado desconocido. Comprueba la solicitud real frente a los parámetros del modelo elegido. reasoning_config={} es una opción del constructor Python, no un ajuste YAML ni prueba de que CLI desactive el razonamiento.

Configuración de ejemplo

Mantenga las claves API en su entorno de servidor o almacén de credenciales de herramientas.Reemplace el campo clave de ejemplo con su propia clave cuando corresponda.

CLI · $HERMES_HOME/config.yaml
providers:
  iteracompute:
    api: https://api.iteracompute.com/v1
    key_env: ITERACOMPUTE_API_KEY
    transport: chat_completions
    default_model: deepseek/deepseek-v4.1-flash-1017
    context_length: 1048576
    discover_models: false
    extra_body:
      max_tokens: 512
model:
  provider: custom:iteracompute
  default: deepseek/deepseek-v4.1-flash-1017
  context_length: 1048576
  streaming: false
agent:
  max_turns: 3
  api_max_retries: 0
  auto_recovery_cycles: 0
fallback_providers: []
toolsets: [todo]
tools:
  tool_search:
    enabled: off
approvals:
  mode: manual
compression:
  enabled: false
auxiliary:
  title_generation:
    enabled: false
    model_upgrade_enabled: false

Guarda la configuración solo en el perfil aislado. Los ejemplos de Chat Completions empiezan con 512 tokens de salida y sin fallback. Los metadatos de contexto no conceden derechos de cuenta; OpenClaw usa un presupuesto de entrada menor y Qwen un contexto de cuenta de 128K. El razonamiento varía por modelo: Python y OpenClaw solo añaden reasoning: false para Qwen; no lo copies a otros modelos.

Verifica primero la API directa

Python · Verificación directa de texto
python3 - <<'PY'
import json
import os
import urllib.error
import urllib.request
payload = {
    'model': 'deepseek/deepseek-v4.1-flash-1017',
    'messages': [{'role': 'user', 'content': 'Reply with exactly: ITERACOMPUTE_API_OK'}],
    'max_tokens': 512,
    **{},
}
request = urllib.request.Request(
    'https://api.iteracompute.com/v1/chat/completions',
    data=json.dumps(payload).encode('utf-8'),
    headers={'Authorization': 'Bearer ' + os.environ['ITERACOMPUTE_API_KEY'],
             'Content-Type': 'application/json'}, method='POST',
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as exc:
    raise SystemExit(f'HTTP {exc.code}; inspect redacted details privately') from None
except (urllib.error.URLError, TimeoutError):
    raise SystemExit('Network or timeout failure; no automatic retry') from None
choice = result['choices'][0]
if ((choice.get('message', {}).get('content') or '').strip() != 'ITERACOMPUTE_API_OK'
        or choice.get('finish_reason') != 'stop'):
    raise SystemExit('FAIL: expected final marker and stop reason not returned')
print('Direct API text passed; test the agent separately')
PY

Al ejecutarlo envía una solicitud real. Confirma el marcador visible exacto y finish_reason=stop; HTTP 200 sin texto no basta. Los modelos de pago consumen saldo API. No reintentes automáticamente un resultado desconocido.

Verifica la ruta de texto del agente

Bash · Verificación de texto
hermes chat --oneshot --ignore-rules --toolsets todo --max-turns 2 \
  --format stream-json \
  -q 'Do not call tools. Reply with exactly: HERMES_ITERACOMPUTE_OK' \
  > hermes-text.private.jsonl 2> hermes-text.private.stderr

Ejecuta primero la verificación directa de API de abajo. Exige un marcador final no vacío, el provider/model previsto y la salida correcta del agente. Validar configuración o ejecutar una sonda no demuestra un flujo de agente o herramientas.

Verifica un ciclo de herramienta

El perfil CLI anterior es una referencia documental. Para Python, crea otro HERMES_HOME en el checkout activado, guarda allí config.yaml y el script como iteracompute_agent_smoke.py. No combines los perfiles.

Bash · Perfil Python independiente
export HERMES_HOME="$PWD/.hermes-iteracompute-python"
mkdir -p "$HERMES_HOME"
Perfil Python · config.yaml
model:
  provider: custom
  default: deepseek/deepseek-v4.1-flash-1017
  base_url: https://api.iteracompute.com/v1
  streaming: false
providers:
  custom:
    request_timeout_seconds: 240
    stale_timeout_seconds: 240
tools:
  tool_search:
    enabled: off
agent:
  api_max_retries: 0
  auto_recovery_cycles: 0
fallback_providers: []
compression:
  enabled: false
auxiliary:
  title_generation:
    enabled: false
    model_upgrade_enabled: false
iteracompute_agent_smoke.py
import os
from run_agent import AIAgent

agent = AIAgent(
    provider="custom",
    api_mode="chat_completions",
    base_url="https://api.iteracompute.com/v1",
    api_key=os.environ["ITERACOMPUTE_API_KEY"],
    model="deepseek/deepseek-v4.1-flash-1017",
    enabled_toolsets=["todo"],
    max_iterations=3,
    max_tokens=512,
    run_budget_seconds=600,
    reasoning_config={},
    request_overrides={"extra_body": {}},
    skip_context_files=True,
    skip_memory=True,
    skip_background_review=True,
    load_soul_identity=False,
    save_trajectories=False,
    quiet_mode=True,
    fallback_model={},
)
try:
    result = agent.run_conversation(
        "Call todo_list exactly once to write one item with id smoke-1, "
        "content API smoke test, and status completed. Then read the tool result "
        "and reply with exactly HERMES_ITERACOMPUTE_TOOL_OK. Do not use other tools."
    )
    if not (result.get("completed") is True and
            (result.get("final_response") or "").strip() == "HERMES_ITERACOMPUTE_TOOL_OK"):
        raise SystemExit("FAIL: inspect redacted details privately")
    print("Final marker passed; verify actual todo_list events separately")
finally:
    agent.close()
Bash · Ejecutar agente Python
python iteracompute_agent_smoke.py

Criterio de éxito: inspecciona una llamada real a todo_list, el elemento smoke-1 completado, el resultado de herramienta devuelto y la respuesta final HERMES_ITERACOMPUTE_TOOL_OK. El script solo comprueba el marcador final; revisa aparte los eventos de herramientas. Tres iteraciones y cero reintentos configurados no limitan estrictamente las solicitudes HTTP ni el gasto.

Versión y verificación

Versión probada
Hermes Agent v0.23.0
Resultado
Llamadas a herramientas Python sin streaming aprobadas.

Credenciales, herramientas y datos

La API del modelo es remota; no necesitas GPU local ni puerto público de Gateway. El agente sí necesita CPU, memoria y permisos locales. Mantén las claves en el entorno del proceso y los registros originales privados; activa solo las herramientas necesarias. Los servicios externos requieren configuración y costes propios.

Pruebe la conexión

cURL · Finalizaciones de chat
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-v4.1-flash-1017","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

Compruebe que choices[0].message.content contenga texto visible;HTTP 200 por sí solo es insuficiente.El razonamiento puede consumir el presupuesto de producción.Para Qwen gratis, utiliza el ejemplo de la primera llamada gratuita a la API para desactivar el pensamiento, luego envíe un mensaje dentro de su herramienta.

Capacidades del modelo seleccionado

Las capacidades describen la API de IteraCompute. Su disponibilidad también depende de la herramienta y su configuración; los controles de razonamiento varían según el modelo.

  • Finalizaciones de chatApoyado
  • Llamada de herramientasApoyado
  • RazonamientoApoyado
  • Entrada de imagenApoyado
  • TransmisiónApoyado

Solución de problemas

401 / 403 / 404

Revisa la clave del proceso, los permisos del modelo y el saldo de pago. Incluye /v1 una sola vez en la URL base. Envía el Model ID original a la API; el prefijo iteracompute/ solo corresponde al enrutamiento de OpenClaw.

400 / Respuesta vacía / 429

Revisa los parámetros de razonamiento del modelo, el presupuesto de salida y los límites de cuenta. Respeta Retry-After. No mezcles formatos de razonamiento, no deduzcas éxito de HTTP 200 ni cambies automáticamente a otro modelo de pago.

Herramienta ausente / Perfil incorrecto

Hermes: desactiva tool_search para probar todo y separa los perfiles Python y CLI. OpenClaw: sustituye deny-all por solo lectura para probar herramientas; no uses --isolated ni --auth-env-only con esta configuración.

Referencia de configuración de Hermes Agent →

Empieza a crear con Hermes Agent.

Conecte su clave, elija un modelo y envíe su primera solicitud.