1. Crie uma chave API
Crie ou faça login em sua conta IteraCompute e, em seguida, crie uma chave no Console.
Conecte um agente de terminal à IteraCompute.
Crie ou faça login em sua conta IteraCompute e, em seguida, crie uma chave no Console.
Configure um provedor personalizado nomeado com chat_completions. Python AIAgent e CLI usam perfis separados.
Use o ID do modelo de API exato para o modelo escolhido.Verifique seu contexto e recursos antes de ativar recursos de agente ou visão.
DeepSeek V4.1 Flash 1017 é o modelo pago de referência. Você pode substituí-lo por um modelo de conversa publicado permitido pela chave. Confira permissões, preços, contexto e ferramentas após a troca. Os exemplos acompanham a seleção; os resultados preservados continuam vinculados ao Qwen.
Use um checkout isolado do Hermes Agent v0.23.0 e HERMES_HOME. Exporte ITERACOMPUTE_API_KEY no terminal de inicialização.
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 doctorumask 077
read -rsp 'IteraCompute API key: ' ITERACOMPUTE_API_KEY
printf '\n'
export ITERACOMPUTE_API_KEYHermes CLI pode adicionar reasoning_effort=medium a um modelo personalizado desconhecido. Confira a requisição real com os parâmetros do modelo escolhido. reasoning_config={} é uma opção do construtor Python, não uma configuração YAML nem prova de raciocínio desativado na CLI.
Mantenha as chaves de API em seu ambiente de servidor ou armazenamento de credenciais de ferramentas.Substitua o campo-chave de exemplo pela sua própria chave, quando aplicável.
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: falseSalve apenas no perfil isolado criado acima. Os exemplos de Chat Completions começam com 512 tokens de saída e sem fallback. Metadados de contexto não concedem direitos à conta; OpenClaw usa um orçamento de entrada menor e Qwen um contexto de conta de 128K. O controle de raciocínio varia: Python e OpenClaw adicionam reasoning: false apenas ao Qwen; não copie a opção para outros 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')
PYAo executar, envia uma requisição real. Confirme o marcador visível exato e finish_reason=stop; HTTP 200 sem texto é incompleto. Modelos pagos consomem saldo API. Não repita automaticamente uma operação de resultado desconhecido.
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.stderrExecute primeiro a verificação direta da API abaixo. Exija um marcador final não vazio, o provider/model esperado e a saída correta do agente. Validar configuração ou executar uma sondagem não comprova um fluxo de agente ou ferramentas.
O perfil CLI acima é uma referência documental. Para Python, crie outro HERMES_HOME no checkout ativado, salve ali config.yaml e o script como iteracompute_agent_smoke.py. Não combine os perfis.
export HERMES_HOME="$PWD/.hermes-iteracompute-python"
mkdir -p "$HERMES_HOME"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: falseimport 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()python iteracompute_agent_smoke.pyCritério de sucesso: inspecione a chamada real a todo_list, o item smoke-1 concluído, o resultado retornado e a resposta final HERMES_ITERACOMPUTE_TOOL_OK. O script verifica apenas o marcador final; examine os eventos de ferramentas separadamente. Três iterações e zero tentativas configuradas não limitam estritamente requisições HTTP nem gastos.
A API do modelo é remota; não exige GPU local nem porta pública de Gateway. O agente precisa de CPU, memória e permissões locais. Mantenha as chaves no ambiente do processo e os logs originais privados; habilite apenas as ferramentas necessárias. Serviços externos têm configuração e custos próprios.
# 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}'Verifique se choices[0].message.content contém texto visível;O HTTP 200 por si só é insuficiente.O raciocínio pode consumir o orçamento de produção.Para Qwen grátis, use o exemplo da primeira chamada gratuita à API para desativar o pensamento e envie um prompt dentro de sua ferramenta.
As capacidades descrevem a API da IteraCompute. A disponibilidade também depende da ferramenta e de suas configurações; os controles de raciocínio variam por modelo.
Confira a chave do processo, a permissão do modelo e o saldo pago. Inclua /v1 uma única vez na URL base. Envie o Model ID original à API; o prefixo iteracompute/ serve apenas ao roteamento do OpenClaw.
Confira os parâmetros de raciocínio do modelo, o orçamento de saída e os limites da conta. Respeite Retry-After. Não misture formatos de raciocínio, não deduza sucesso de HTTP 200 nem alterne automaticamente para outro modelo pago.
Hermes: desative tool_search no teste de todo e separe os perfis Python e CLI. OpenClaw: substitua deny-all por somente leitura no teste de ferramentas; não use --isolated nem --auth-env-only com esta configuração.
Conecte sua chave, escolha um modelo e envie sua primeira solicitação.