How to Build an FX Trading Agent with NVIDIA NemoClaw and FXMacroData

¿Por qué NemoClaw y FXMacroData pertenecen juntos?

NVIDIA NemoClaw, también conocido como NVIDia es una pila de referencia de código abierto que gira ¿ Qué pasa ? un agente de IA siempre activado y auto-alojado en un tiempo de ejecución endurecido y en una caja de arena respaldado por la infraestructura de inferencia de NVIDIA. OpenClaw le da una IA que se ejecuta las 24 horas del día, los 7 días de la semana en su máquina, se conecta a aplicaciones de chat como Telegram y WhatsApp, y puede ejecutar código, llamar API y actuar sobre información de forma autónoma. NemoClaw envuelve ese agente en una caixa de arena segura (Landlock + seccomp + espacio de nombres de red), administra el punto final del modelo y agrega incorporación guiada que lo lleva de cero a ejecutarse en un solo comando de terminal.

Para el comercio de divisas y la investigación macro, esa combinación es convincente. La mayoría de los flujos de trabajo de agentes de IA caen en uno de dos modos: usted hace una pregunta, usted obtiene una respuesta. Impresiones de inflación¿ Qué ? decisiones de política del banco central, y movimientos de los tipos al contado en contra de sus criterios, y Te alerta cuando ocurre algo que coincide con un borde predefinido. FXMacroData proporciona la capa de datos: una API REST estructurada y Servidor MCP El informe cubre 18 monedas con tipos de interés, IPC, PIB, empleo, balanzas comerciales, posicionamiento de la COT y más.

Esta guía recorre la configuración de NemoClaw, dando a su agente acceso a FXMacroData, escribiendo una habilidad de monitoreo reutilizable y ejecutando la primera alerta sorpresa macro de extremo a extremo en El valor de las pérdidas- ¿ Qué ?

Cómo encaja la pila

Antes de sumergirse en la configuración es útil entender lo que hace cada capa:

• ¿ Qué pasa ? es el propio agente un asistente de IA auto-alojado que se ejecuta continuamente, se conecta a sus canales de chat, y puede ejecutar comandos de shell, escribir y ejecutarse código, llamar APIs, y recordar el contexto a través de las sesiones.
• NemoClaw . Es el envoltorio de implementación seguro. Instala NVIDIA OpenShell, crea un contenedor de arena para OpenClaw, configura la inferencia administrada a través de la API de NVIDia (modelos de Nemotron) y proporciona el nemoclaw CLI para gestionar todo el entorno.
• FXMacroData también es el nivel de datos. Su agente llama a la API REST FXMacroData para leer el historial de anuncios macro, pronósticos, tasas de cambio al contado, datos de COT y eventos de calendario de lanzamiento. La API está estructurada, versionada y siempre devuelve datos respaldados por Firestore sin raspado, sin volatilidad de terceros en el momento de la solicitud.

El flujo típico una vez que tienes la pila en funcionamiento:

You (Telegram)  →  OpenClaw agent  →  FXMacroData API
                         ↓
               Python script inside sandbox
                         ↓
               Result / alert  →  You (Telegram)

Su agente vive en una caja de arena. Llama a FXMacroData a través de HTTPS a través del sistema de red administrado de la caja de Arena. Interactúa con él desde su teléfono o escritorio a través Telegram. La capa de seguridad NemoClaw significa que incluso si el agente está comprometido o se alimenta de un mensaje incorrecto, no puede llegar a destinos de red arbitrarios o acceder a su sistema de archivos de host solo las reglas de salida que aprobó durante la incorporación.

Los requisitos previos

• Linux, macOS (Apple Silicon) o Windows WSL2 con Docker instalado y en ejecución.
• Node.js 22.16+ y npm 10+ (el instalador NemoClaw los configura automáticamente si faltan).
• Una cuenta de Telegram (el canal más rápido para probar con un bot token toma aproximadamente dos minutos para crear a través de @BotFather) y de la Comisión).
• Una clave de API de NVIDIA de construyen.nvidia.com para la inferencia del modelo Nemotron, o una clave Anthropic/OpenAI si prefiere suministrar su propio modelo.
• Una clave de la API de FXMacroData desde el Gestión de las API Los datos en USD están disponibles en el nivel gratuito; el acceso en varias monedas requiere un plan de pago.

Paso 1: Instale NemoClaw y incluya OpenClaw

Ejecuta el instalador de NemoClaw. Se saca Node.js a través de nvm si no lo tienes, instala el CLI de Nemo Claw, y se inicia el asistente interactivo a bordo:

curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash

El asistente le pide que nombre a su asistente, elija un proveedor de inferencia (seleccione NVIDIA Endpoints for Nemotron), y pegar su clave API NVIDia.

──────────────────────────────────────────────────────
Sandbox      fx-agent (Landlock + seccomp + netns)
Model        nvidia/nemotron-3-super-120b-a12b (NVIDIA Endpoints)
──────────────────────────────────────────────────────
Run:   nemoclaw fx-agent connect
Status: nemoclaw fx-agent status
Logs:   nemoclaw fx-agent logs --follow

Conecte con el sandbox para verificar que el agente está ejecutado:

nemoclaw fx-agent connect

Dentro de la caja de arena, abre la interfaz de usuario del terminal OpenClaw y envía un saludo rápido:

openclaw tui

Paso 2: Conecta un canal de Telegram

Manteniéndose dentro de la cáscara de la caja de arena, configure Telegram para que pueda enviar mensajes al agente desde su teléfono. @BotFather en Telegram, entonces:

# Inside the nemoclaw sandbox shell
openclaw channel add telegram

Siga las instrucciones para pegar su bot token y su ID de usuario personal de Telegram (el agente restringe los mensajes entrantes a la lista de permisos que usted proporciona). Una vez conectado, envíe hello a la bot de Telegram usted debe obtener una respuesta del agente dentro de unos segundos.

Paso 3: exponer FXMacroData al agente

La caja de arena tiene acceso de red saliente por defecto a HTTPS en el puerto 443. https://fxmacrodata.com/api/v1Lo que necesitas es hacer que tu clave de API esté disponible dentro de la caja de arena sin que aparezca en los scripts revisados en el control de versiones.

Desde fuera de la caja de arena, establece el secreto usando el administrador de secretos NemoClaw:

nemoclaw fx-agent secret set FXMD_API_KEY your_api_key_here

El sandbox inyecta esto como una variable de entorno en el inicio. Cualquier script que el agente ejecute dentro del contenedor puede leerlo con os.environ["FXMD_API_KEY"], y nunca se escribe en disco o se registra.

Para verificar que la llave está conectada correctamente, pregúntele al agente de Telegram:

Write a one-liner Python command that fetches the latest USD inflation announcement
from https://fxmacrodata.com/api/v1/announcements/usd/inflation?api_key=$FXMD_API_KEY
and prints the value and date. Run it.

El agente escribirá el guión, lo ejecutará dentro de la caja de arena, y devolverá el último Indicador de precios de los Estados Unidos lectura que confirma la conectividad de extremo a extremo.

Paso 4: Escriba la habilidad de monitoreo de divisas

El sistema de habilidades de OpenClaw te permite empaquetar capacidades de agentes reutilizables como archivos YAML. Una habilidad es una descripción que el agente lee al iniciar; cuando le pides que haga algo que coincida con la habilidad, sabe cómo proceder sin que vuelvas a explicar el flujo de trabajo cada vez.

Crear un nuevo archivo de habilidades dentro de la caja de arena.

cat > ~/.openclaw/skills/fxmacrodata.md <<'EOF'
# FXMacroData — Macro Surprise Monitor

## Purpose
Query the FXMacroData API to retrieve macro announcement data, compare actuals
to consensus forecasts, and surface surprises relevant to FX trading.

## API basics
- Base URL: https://fxmacrodata.com/api/v1
- Auth: query param ?api_key=$FXMD_API_KEY (already injected as env var)
- Key endpoint families:
  /announcements/{currency}/{indicator}   — historical prints + forecasts
  /predictions/{currency}/{indicator}     — consensus and model forecasts
  /calendar/{currency}                    — upcoming release schedule
  /forex                                  — spot rates

## Supported currencies
USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD, HKD, SGD, NOK, PLN, SEK, DKK, BRL, KRW, MXN

## Workflow: Macro surprise scan
1. Fetch the last N announcements for (currency, indicator)
2. Fetch matching predictions to get the market consensus
3. Compute surprise = actual - consensus
4. Sort by abs(surprise) descending
5. Report the top surprises with their dates

## Workflow: Calendar alert
1. Fetch /calendar/{currency} to find upcoming releases in the next N days
2. For each release, note indicator, scheduled time (UTC), and prior value
3. Alert the user with a formatted summary

## Output format
Use a clean text table. Include indicator name, date, actual, consensus, surprise
in bps/pp, and direction (beat/miss). Keep it under 20 lines unless the user asks
for more.
EOF

El agente lee todos los archivos de habilidades en ~/.openclaw/skills/ Después de añadir el archivo, reinicie la sesión dentro de la caja de arena:

openclaw session restart

Paso 5: Construir y ejecutar el escaneo sorpresa de inflación

Ahora prueba la habilidad de extremo a extremo.

Run a macro surprise scan on USD inflation for the last 12 prints.
Show me the biggest surprises and tell me whether each was a beat or a miss.

El agente escribirá y ejecutará un script Python dentro de la caja de arena.

import os, requests

API  = "https://fxmacrodata.com/api/v1"
KEY  = os.environ["FXMD_API_KEY"]

def get(path, **params):
    r = requests.get(f"{API}{path}", params={"api_key": KEY, **params}, timeout=15)
    r.raise_for_status()
    return r.json()

actuals    = get("/announcements/usd/inflation")["data"][-12:]
pred_index = {
    g["announcement_id"]: g["predictions"]
    for g in get("/predictions/usd/inflation")["data"]
}

rows = []
for a in actuals:
    preds = pred_index.get(a["announcement_id"], [])
    consensus = next(
        (p["predicted_value"] for p in preds if p["prediction_type"] == "market_consensus"),
        None,
    )
    if consensus is None or a.get("value") is None:
        continue
    surprise = round(a["value"] - consensus, 2)
    rows.append({
        "date":      a["announcement_datetime"][:10],
        "actual":    a["value"],
        "consensus": consensus,
        "surprise":  surprise,
        "direction": "BEAT" if surprise > 0 else "MISS",
    })

rows.sort(key=lambda r: abs(r["surprise"]), reverse=True)
print(f"{'Date':<12} {'Actual':>8} {'Consensus':>10} {'Surprise':>10} {'Dir'}")
print("-" * 50)
for r in rows:
    print(f"{r['date']:<12} {r['actual']:>8.2f} {r['consensus']:>10.2f} {r['surprise']:>+10.2f} {r['direction']}")

El agente ejecuta esto, lee la salida, y te envía un resumen formateado a través de Telegram sin recolección manual de datos, sin hoja de cálculo.

Paso 6: Programe una sesión informativa diaria sobre las grandes empresas

Uno de los usos más prácticos de un agente NemoClaw siempre activo es una sesión informativa diaria programada.

Every weekday at 07:00 UTC, pull the FXMacroData release calendar for the next
48 hours across USD, EUR, GBP, and JPY. Format it as a morning briefing and send
it to me here on Telegram.

El agente escribirá el código de programación en sus propias habilidades / configuración y confirmará la configuración. Indicador de precios de los productos en euros¿ Qué ? Desempleo en el Reino Unido, y cualquier otro evento de nivel 1 que se produzca ese día, con valores previos y pronósticos de consenso ya completados.

Una muestra de información del agente:

📅 Macro Calendar — Thu 22 May 2026 (next 48h)

UTC 07:00  USD  Initial Jobless Claims     Prior: 228k  Consensus: 225k
UTC 08:30  USD  Philadelphia Fed Mfg       Prior: -26.4  Consensus: -10.0
UTC 09:30  EUR  ECB Meeting Minutes        (qualitative release)
UTC 12:30  GBP  Retail Sales MoM           Prior: -0.1%  Consensus: +0.4%
UTC 14:00  USD  Existing Home Sales        Prior: 4.02M  Consensus: 4.10M

Fri 23 May
UTC 08:30  CAD  Retail Sales MoM           Prior: +0.8%  Consensus: +0.3%
UTC 08:30  USD  PCE Price Index MoM        Prior: +0.0%  Consensus: +0.1%

High-impact watch: USD PCE on Fri — last three prints have missed consensus.

Paso 7: Construir un monitor de posición en vivo

Un patrón más avanzado es dar al agente un conjunto de posiciones de ejecución y hacer que le alerte cuando los datos macro cambian la tesis.

I'm long AUD/USD targeting the December RBA decision.
Monitor FXMacroData for any new AUD inflation, employment, or trade balance
prints. If the actual comes in more than 0.1 percentage points above consensus,
send me a Telegram alert with the full data and a brief note on what it means
for RBA rate expectations.

El agente crea un script de votación dentro de la caja de arena que comprueba el calendario FXMacroData en una cadencia regular. Indicador de precios por uso de la moneda de Estados Unidos ¿ Qué ? Empleo en AUD Como el agente se ejecuta dentro de la caja de arena administrada de NemoClaw con políticas de red impuestas, solo puede llegar a los puntos finales HTTPS aprobados su clave de API y la tubería de datos están aisladas del resto de su máquina.

Utilizando el servidor FXMacroData MCP

FXMacroData también expone un alojado Servidor MCP ¿ Qué ? https://fxmacrodata.com/mcpSi desea conectarlo al agente directamente como una herramienta nativa en lugar de que el agente escriba Python para llamar a la API REST, puede configurar una habilidad MCP que apunte al servidor FXMacroData. Esto permite que el agent llame. indicator_query¿ Qué ? release_calendar¿ Qué ? forex, y otras herramientas de forma nativa, sin escribir ningún código de pegamento.

Consulte el Docs del servidor MCP para los detalles de la conexión. El modelo de autenticación es el mismo: clave API de consulta-param o OAuth/PKCE. Cualquiera de los dos puede usarse desde dentro de la caja de arena NemoClaw una vez que el punto final MCP se agrega a la lista de salidas aprobada durante la incorporación.

Para las consultas de investigación ad hoc "cuál fue la reacción del EUR/USD a las últimas cinco decisiones del BCE?" la ruta MCP es más rápida porque el agente no necesita construir un script primero.

Modelo de seguridad y por qué es importante para el comercio

La ejecución de agentes de IA con acceso a claves API a los datos financieros presenta una superficie de ataque real.

• No tiene salida El agente no puede acceder a sus claves SSH, credenciales del navegador u otros archivos sensibles del host.
• el segundo limita las llamadas del sistema que el agente puede hacer, bloqueando categorías de escalada de privilegios y técnicas de escape de contenedores.
• Espacios de nombres de red significa que todas las conexiones salientes pasan por la puerta de enlace OpenShell, que hace cumplir su política de salida aprobada. fxmacrodata.com- ¿ Qué ?
• Gestión de los secretos ¿ Qué pasa ? nemoclaw secret set Asegura que las claves de API se inyectan en tiempo de ejecución en lugar de almacenarse en archivos de texto plano o pasar a través del chat.

Para los flujos de trabajo de negociación donde el agente tiene autoridad para ejecutar scripts que llaman puntos finales de datos financieros, ese límite es significativo.

Los siguientes pasos

Una vez que la pila de referencia está funcionando, algunas direcciones naturales para extenderlo:

• Monitoreo en varias monedas: ampliar el escaneo sorpresa para cubrir todas las monedas en el Calendario de lanzamiento de FXMacroData El agente puede ejecutar este escaneo cada hora y sólo alerta cuando algo material se imprime.
• Integración de las TCOTirar . Datos de posicionamiento del COT junto con las sorpresas macro para evaluar si un golpe o fallo está operando contra o con la posición especulativa actual.
• Modelo de enrutador: El router de modelo experimental de NemoClaw le permite especificar un grupo de modelos y enrutará automáticamente cada consulta a la más barata que cumpla con un umbral de precisión.
• Tableros de instrumentos específicos para pares: después de que el agente aparece una señal macro, diríjase a su El valor de la moneda de referencia ¿ Qué ? El valor de las pérdidas el panel de control para una comprobación visual de las tendencias de los indicadores antes de actuar.

La referencia de la API de FXMacroData está en El número de datos de la base de datos es el siguiente:La documentación de NemoClaw, incluyendo la referencia completa del comando CLI, se encuentra en ¿Qué es lo que está pasando?Ambos proyectos merecen ser leídos junto con esta guía la arquitectura cambia rápidamente a medida que ambos proyectos están en desarrollo activo.