Compatible con OpenAI

Usa OpenClaw con IteraCompute

Crea flujos de texto y herramientas de solo lectura.

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

Añade un proveedor iteracompute con openai-completions y un SecretRef de entorno. En OpenClaw, usa la referencia provider/model completa.

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

Instala OpenClaw 2026.11.1 en un directorio separado. Las pruebas conservadas usaron Bun 1.4.4; aísla la configuración y el estado.

Bash / macOS / Linux / WSL
# Node: >=24.16.0 <25 or >=26.1.0; npm <=11.15
node --version
npm --version
umask 077
mkdir -p itera-openclaw-demo
cd itera-openclaw-demo
export ITERA_RUNTIME="$PWD/runtime"
npm install --prefix "$ITERA_RUNTIME" openclaw@2026.11.1 bun@1.4.4 \
  --no-audit --no-fund
export BUN="$ITERA_RUNTIME/node_modules/.bin/bun"
export OPENCLAW_ENTRY="$ITERA_RUNTIME/node_modules/openclaw/openclaw.mjs"
"$BUN" --version
"$BUN" "$OPENCLAW_ENTRY" --version
mkdir -p workspace state home
export OPENCLAW_HOME="$PWD/home"
export OPENCLAW_STATE_DIR="$PWD/state"
export OPENCLAW_CONFIG_PATH="$PWD/openclaw.iteracompute.json"
export OPENCLAW_OFFLINE=1
Bash · Clave en la terminal actual
umask 077
read -rsp 'IteraCompute API key: ' ITERACOMPUTE_API_KEY
printf '\n'
export ITERACOMPUTE_API_KEY

La instalación usa npm 11.15 o anterior; npm 11.16+ / 12 requiere --allow-scripts=openclaw según la documentación oficial. La entrada Bun explícita corresponde al entorno exitoso conservado. OPENCLAW_OFFLINE impide descargas auxiliares, no llamadas API. No requiere daemon ni cuenta de mensajería.

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.

openclaw.iteracompute.json
{
  "models": {
    "mode": "replace",
    "providers": {
      "iteracompute": {
        "baseUrl": "https://api.iteracompute.com/v1",
        "api": "openai-completions",
        "apiKey": {
          "source": "env",
          "provider": "default",
          "id": "ITERACOMPUTE_API_KEY"
        },
        "timeoutSeconds": 180,
        "models": [
          {
            "id": "deepseek/deepseek-v4.1-flash-1017",
            "name": "DeepSeek V4.1 Flash 1017",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1048576,
            "contextTokens": 110000,
            "maxTokens": 512,
            "compat": {
              "maxTokensField": "max_tokens",
              "supportsReasoningEffort": false,
              "supportsUsageInStreaming": true
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "iteracompute/deepseek/deepseek-v4.1-flash-1017",
        "fallbacks": []
      },
      "modelPolicy": {
        "allow": [
          "iteracompute/deepseek/deepseek-v4.1-flash-1017"
        ]
      },
      "models": {
        "iteracompute/deepseek/deepseek-v4.1-flash-1017": {
          "alias": "itera-model",
          "params": {
            "maxTokens": 512,
            "extraBody": {}
          }
        }
      },
      "thinkingDefault": "off",
      "skipBootstrap": true,
      "contextInjection": "never"
    }
  },
  "tools": {
    "deny": [
      "*"
    ],
    "toolSearch": false
  },
  "plugins": {
    "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
"$BUN" "$OPENCLAW_ENTRY" config validate --json
"$BUN" "$OPENCLAW_ENTRY" models list --provider iteracompute --json
"$BUN" "$OPENCLAW_ENTRY" agent exec \
  'Reply with exactly OPENCLAW_ITERACOMPUTE_TEXT_OK. Do not use tools.' \
  --config "$OPENCLAW_CONFIG_PATH" --cwd "$PWD/workspace" \
  --model iteracompute/deepseek/deepseek-v4.1-flash-1017 --code-mode direct \
  --thinking off --timeout 360 --json > text-result.private.json

python3 - <<'PY'
import json
from pathlib import Path
r = json.loads(Path('text-result.private.json').read_text(encoding='utf-8'))
if not (r.get('ok') is True and r.get('provider') == 'iteracompute'
        and r.get('model') == 'deepseek/deepseek-v4.1-flash-1017'
        and (r.get('final') or '').strip() == 'OPENCLAW_ITERACOMPUTE_TEXT_OK'):
    raise SystemExit('FAIL: inspect redacted details privately')
print('OpenClaw text invocation passed')
PY

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

Tras validar texto, el script copia la configuración y sustituye toda la política tools por read limitado al espacio de trabajo. Elimina deny: ["*"] porque deny prevalece sobre allow. El marcador aleatorio solo se escribe en el archivo, nunca en el prompt.

Bash · Herramienta read y comprobaciones
python3 - <<'PY'
import json
import secrets
from pathlib import Path
config = json.loads(Path('openclaw.iteracompute.json').read_text(encoding='utf-8'))
config['tools'] = {
    'allow': ['read'], 'fs': {'workspaceOnly': True}, 'toolSearch': False,
}
Path('openclaw.iteracompute.tools.json').write_text(json.dumps(config), encoding='utf-8')
Path('workspace/integration-marker.txt').write_text(
    'OPENCLAW_ITERACOMPUTE_TOOL_' + secrets.token_hex(8) + '\n', encoding='utf-8')
PY

"$BUN" "$OPENCLAW_ENTRY" agent exec \
  'Use read to read integration-marker.txt, then reply with exactly the marker in that file. Do not guess or use other tools.' \
  --config "$PWD/openclaw.iteracompute.tools.json" --cwd "$PWD/workspace" \
  --model iteracompute/deepseek/deepseek-v4.1-flash-1017 --code-mode direct \
  --thinking off --timeout 600 --json > tool-result.private.json

python3 - <<'PY'
import json
from pathlib import Path
r = json.loads(Path('tool-result.private.json').read_text(encoding='utf-8'))
expected = Path('workspace/integration-marker.txt').read_text(encoding='utf-8').strip()
tools = r.get('toolSummary') or {}
checks = [r.get('ok') is True, r.get('provider') == 'iteracompute',
          r.get('model') == 'deepseek/deepseek-v4.1-flash-1017', tools.get('calls') == 1,
          tools.get('tools') == ['read'], tools.get('failures') == 0,
          r.get('assistantTurns') == 2, (r.get('final') or '').strip() == expected]
if not all(checks):
    raise SystemExit('FAIL: inspect redacted details privately')
print('OpenClaw read tool loop passed')
PY

Criterio de éxito: provider/model correcto, exactamente una llamada read exitosa, dos turnos del asistente y respuesta final idéntica al marcador del archivo. No basta con que el modelo diga que lo leyó.

Versión y verificación

Versión probada
OpenClaw 2026.11.1 · Bun 1.4.4
Resultado
Texto y herramientas de solo lectura aprobados.

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 OpenClaw →

Empieza a crear con OpenClaw.

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