1. Cree una clave API
Cree o inicie sesión en su cuenta IteraCompute, luego cree una clave en la consola.
Crea flujos de texto y herramientas de solo lectura.
Cree o inicie sesión en su cuenta IteraCompute, luego cree una clave en la consola.
Añade un proveedor iteracompute con openai-completions y un SecretRef de entorno. En OpenClaw, usa la referencia provider/model completa.
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.
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.
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.
# 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=1umask 077
read -rsp 'IteraCompute API key: ' ITERACOMPUTE_API_KEY
printf '\n'
export ITERACOMPUTE_API_KEYLa 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.
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.
{
"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.
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')
PYAl 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.
"$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')
PYEjecuta 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.
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.
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')
PYCriterio 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ó.
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.
# 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.
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.
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.
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.
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.
Conecte su clave, elija un modelo y envíe su primera solicitud.