Comment connecter FXMacroData à l'assistant d'IA OpenClaw

Imaginez demander à votre assistant d'IA depuis WhatsApp, Telegram ou Discord "Que a fait la RBA avec les taux ce mois-ci?" et obtenir une réponse instantanée et précise provenant directement des communiqués officiels de la banque centrale. C'est ce que construit ce guide. À la fin, votre agent OpenClaw aura un accès en direct aux données d'annonce macroéconomique sur 18 devises, calendriers de sortie, positionnement COT, matières premières et taux de change tout cela via une seule connexion.

Le chemin A Connexion par MCP Recommandé

Protocole de contexte type (MCP) est le moyen le plus rapide de donner à OpenClaw un accès typé à FXMacroData. Un bloc de configuration et vous êtes fait pas de compétence JSON, pas de boilerplate de point final, pas d'ébauche manuelle de définitions de schéma. OpenClow découvre automatiquement chaque outil que le serveur expose et les rend disponibles comme outils d'agent natifs.

Étape 1 Ajouter le serveur MCP à votre configuration OpenClaw

Ouvrez votre fichier de configuration OpenClaw (~/.openclaw/openclaw.json Il y a deux options selon que vous voulez le serveur hébergé ou le paquet Python local:

Option A: point final MCP hébergé (le plus simple installation nulle)

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

Il se connecte directement au serveur MCP FXMacroData de production via Streamable HTTP. Les données USD fonctionnent immédiatement sans clé API. Pour les devises autres que USD, joignez votre clé API à l'URL:

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

Option B: serveur MCP local via uvx

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cela démarre un processus de serveur MCP local à partir du Le serveur de base de données PyPI utilise le transport stdio. Utilisez-le pour les clients MCP qui ne prennent pas en charge les connexions HTTP à distance (Claude Desktop, Cursor, Windsurf, etc.).

Étape 2 Évaluer les outils disponibles

Une fois connecté, OpenClaw enregistre automatiquement tous les outils exposés par le serveur MCP. Voici ce à quoi vous avez accès:

Votre agent décide quel outil appeler à partir du langage naturel. Vous n'avez jamais besoin de mémoriser les noms d'outils ou les paramètres posez simplement des questions.

Étape 3 Testez la connexion

Ouvrez n'importe quel canal de chat OpenClaw (Discord, Telegram, WhatsApp ou l'interface web) et posez une question.

What is the current AUD policy rate?

Sous le capot, OpenClaw émet un appel à l'outil MCP:

{
  "tool": "indicator_query",
  "arguments": {
    "currency": "aud",
    "indicator": "policy_rate"
  }
}

Le serveur renvoie la série d'annonces complète et votre agent résume la dernière valeur, la date d'annoncement et la direction du changement en langage clair.

Show me the latest EUR CPI reading.
What macro releases are scheduled this week for USD?
What is the COT positioning for GBP futures?
Which FX sessions are open right now?
What is the current gold price?

Chacune de ces cartes à un outil MCP différent, et OpenClaw les route automatiquement. Inflation en dollars américainsJe suis désolé . Taux directeur de l'AUDJe suis désolé . PIB en euros, et des dizaines d' autres sous le Le hub de documents de l'APIJe suis désolé .

Le chemin B Connectez-vous via la compétence REST API Autre option

Si votre version OpenClaw ne prend pas en charge MCP, ou si vous préférez un contrôle explicite sur les itinéraires HTTP que l'agent peut appeler, vous pouvez connecter FXMacroData comme une compétence HTTP personnalisée. Cette approche fonctionne avec toutes les versions OpenCrow.

Étape 1 Stockez votre clé API

openclaw credentials set FXMACRODATA_API_KEY "YOUR_API_KEY"

Étape 2 Vérifier la réponse de l'API

Les annonces de production du point de fin vivent à /api/v1/announcements/{currency}/{indicator}- Testez-le avec un coup de main . curlJe suis désolé .

curl "https://fxmacrodata.com/api/v1/announcements/usd/inflation"

Vous obtiendrez un objet JSON avec des métadonnées et un data le tableau:

{
  "currency": "USD",
  "indicator": "inflation",
  "has_official_forecast": false,
  "start_date": "2025-01-31",
  "end_date": "2026-03-27",
  "data": [
    {
      "date": "2026-03-12",
      "val": 2.83,
      "announcement_datetime": 1770989400
    }
  ]
}

La dernière entrée en data Les points d'extrémité USD sont accessibles sans clé, ce qui les rend pratiques pour les tests initiaux.

Étape 3 Créer la définition des compétences

Enregistre ceci comme ~/.openclaw/skills/fxmacrodata.json- Le ... {{FXMACRODATA_API_KEY}} placeholder est résolu à l'exécution à partir des informations d'identification que vous avez stockées ci-dessus.

{
  "skill_id": "fxmacrodata",
  "name": "FXMacroData",
  "description": "Fetch macroeconomic announcement series from FXMacroData and summarize the latest released value for an indicator and currency.",
  "base_url": "https://fxmacrodata.com/api/v1",
  "auth": {
    "type": "query_param",
    "param": "api_key",
    "credential": "FXMACRODATA_API_KEY"
  },
  "endpoints": [
    {
      "id": "fetch_announcements",
      "method": "GET",
      "path": "/announcements/{currency}/{indicator}",
      "description": "Return the historical announcement series for one currency and indicator.",
      "parameters": {
        "currency": {
          "type": "string",
          "description": "ISO currency code — e.g. aud, eur, gbp, usd, nzd, cad, chf, jpy, hkd, sgd, nok, sek, dkk, pln, brl, cny, krw, mxn",
          "required": true
        },
        "indicator": {
          "type": "string",
          "description": "Indicator slug — e.g. policy_rate, inflation, gdp, unemployment, non_farm_payrolls, retail_sales, trade_balance",
          "required": true
        }
      }
    }
  ]
}

Reload les compétences après sauvegarde:

openclaw skills reload

Étape 4 Testez-le

Posez une question en langage naturel dans n'importe quel canal de discussion connecté:

What is the latest AUD policy rate?

OpenClaw le place dans le fetch_announcements point final avec currency=aud Je suis désolé . indicator=policy_rate- Je vous appelle . le critère de référence du taux directeur de l'AUD, et renvoie un résumé en anglais clair.

Scénarios réels

Une fois la connexion en ligne, voici les types de flux de travail qui deviennent naturels:

Summarize any macro releases from the last 24 hours for USD, EUR, GBP, and JPY. Flag anything that moved more than expected.

What is the current policy rate for Australia vs New Zealand? What is the rate differential?

Is there any high-impact USD data coming out this week? I am thinking about going long EUR/USD.

What does the latest COT report say about EUR positioning? Are specs net long or short?

Automatiser une macro-information en semaine

La véritable puissance de la connexion d'une API de données à un agent toujours actif est l'automatisation. Configurez un flux de travail OpenClaw planifié qui fournit un briefing macro du matin avant de commencer à trader.

Créez un fichier de flux de travail à ~/.openclaw/workflows/fx_morning_briefing.jsonJe suis désolé .

{
  "workflow_id": "fx_morning_briefing",
  "schedule": "0 7 * * 1-5",
  "description": "Weekday morning FX macro briefing at 07:00 UTC — covers key indicators and upcoming calendar events.",
  "steps": [
    {
      "skill": "fxmacrodata",
      "endpoint": "fetch_announcements",
      "params": { "currency": "usd", "indicator": "policy_rate" },
      "label": "Fed Funds Rate"
    },
    {
      "skill": "fxmacrodata",
      "endpoint": "fetch_announcements",
      "params": { "currency": "eur", "indicator": "inflation" },
      "label": "EUR Inflation"
    },
    {
      "skill": "fxmacrodata",
      "endpoint": "fetch_announcements",
      "params": { "currency": "gbp", "indicator": "unemployment" },
      "label": "GBP Unemployment"
    },
    {
      "skill": "fxmacrodata",
      "endpoint": "fetch_announcements",
      "params": { "currency": "aud", "indicator": "policy_rate" },
      "label": "RBA Policy Rate"
    }
  ],
  "output_channel": "your-channel-id"
}

Ajustez le schedule Une session de trading à Londres peut être définie comme une session de temps. 0 6 * * 1-5 Un trader de New York pourrait préférer 0 12 * * 1-5 Il est temps de se mettre d'accord.

Recharger les flux de travail après enregistrement:

openclaw workflows reload

Chaque matin de semaine, OpenClaw récupère les dernières valeurs, les compile en une synthèse consolidée avec les lectures actuelles et les modifications récentes, et pousse le résumé vers votre canal configuré.

Les prochaines étapes

• Élargir la couverture de vos indicateurs explorez le catalogue complet avec data_catalogue ou parcourez le Documentation sur les APILes critères d'évaluation couvrent les taux d'intérêt, l'inflation, le PIB, le chômage, la balance commerciale, les ventes au détail, Rentabilité des obligations à 10 ans, et plus dans les 18 monnaies prises en charge.
• Combinez avec une compétence commerciale brancher OpenClaw à l'API de votre courtier aux côtés de FXMacroData afin que l'agent puisse afficher une lecture macro et un prix en direct dans la même réponse. "Quel est le dernier AUD CPI et où est le trading AUD/USD?" devient une seule requête.
• Créer des alertes conditionnelles déclencher une notification uniquement lorsqu'un taux directeur change, lorsque l'IPC dépasse un seuil ou lorsque le positionnement de la COT passe de long net à court net.
• Utilisez le calendrier de sortie de manière proactive demandez à votre agent de vous avertir avant les événements à fort impact afin que vous puissiez gérer l'exposition au risque avant les empreintes.

L'équipe FXMacroData