Como conectar o FXMacroData ao Assistente de IA OpenClaw

Imagine perguntar ao seu assistente de IA do WhatsApp, Telegram ou Discord "O que o RBA fez com as taxas este mês?" e obter uma resposta instantânea e precisa proveniente diretamente de comunicados oficiais do banco central. É isso que este guia constrói. No final, seu agente OpenClaw terá acesso ao vivo a dados de anúncios macroeconômicos em 18 moedas, calendários de lançamento, posicionamento COT, commodities e taxas de câmbio tudo através de uma única conexão.

Caminho A Conectar através do MCP Recomendado

Protocolo de contexto modelo (MCP) é a maneira mais rápida de dar ao OpenClaw acesso digitado ao FXMacroData. Um bloco de configuração e você está pronto sem habilidade JSON, sem boilerplate de ponto final, sem definições manuais de esquema. O OpenClow descobre automaticamente todas as ferramentas expostas pelo servidor e as disponibiliza como ferramentas nativas de agente.

Passo 1 Adicionar o servidor MCP à sua configuração OpenClaw

Abra o arquivo de configuração do OpenClaw (~/.openclaw/openclaw.json ou as configurações da interface do usuário) e adicionar o servidor FXMacroData MCP. Existem duas opções dependendo se você quer o servidora hospedado ou o pacote Python local:

Opção A: Ponto final MCP hospedado (mais simples instalação zero)

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

Este conecta-se diretamente ao servidor FXMacroData MCP de produção através do Streamable HTTP. Os dados USD funcionam imediatamente sem chave API. Para moedas não USD, anexe sua chave API ao URL:

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

Opção B: servidor local MCP via uvx

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

Isto inicia um processo de servidor local do MCP a partir do mcp-server-fxmacrodata Pacote PyPI usando transporte stdio. Use-o para clientes MCP que não suportam conexões HTTP remotas (Claude Desktop, Cursor, Windsurf, etc.).

Passo 2 Explorar as ferramentas disponíveis

Uma vez conectado, o OpenClaw registra automaticamente todas as ferramentas expostas pelo servidor MCP.

O seu agente decide qual ferramenta chamar a partir da linguagem natural. Você nunca precisa memorizar nomes de ferramentas ou parâmetros apenas fazer perguntas.

Passo 3 Teste a ligação

Abra qualquer canal de chat OpenClaw (Discord, Telegram, WhatsApp ou a interface da web) e faça uma pergunta.

What is the current AUD policy rate?

Sob o capô, o OpenClaw emite uma chamada de ferramenta MCP:

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

O servidor retorna a série completa de anúncios e seu agente resume o valor mais recente, data de anuncio e direção de mudança em linguagem simples.

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?

Cada um desses mapas para uma ferramenta MCP diferente, e o OpenClaw os rota automaticamente. Inflação em USD- Não . Taxa de política do AUD- Não . EUR PIBE dezenas de outras debaixo do Hub de documentos da API- Não .

Caminho B Conectar através da habilidade REST API Alternativa

Se a sua versão OpenClaw não suporta MCP, ou se preferir um controle explícito sobre quais rotas HTTP o agente pode chamar, pode wiring FXMacroData como uma habilidade HTTP personalizada.

Passo 1 Armazenar a sua chave API

openclaw credentials set FXMACRODATA_API_KEY "YOUR_API_KEY"

Passo 2 Verificar a resposta da API

O final da produção é anunciado . /api/v1/announcements/{currency}/{indicator}Teste com uma rápida . curl- Não .

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

Você vai obter um objeto JSON com metadados e um data Arquivo:

{
  "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
    }
  ]
}

A entrada mais recente em data Os pontos finais USD são acessíveis sem uma chave, tornando-os convenientes para testes iniciais.

Passo 3 Criar a definição de competência

Guarde isto como ~/.openclaw/skills/fxmacrodata.json- O ... {{FXMACRODATA_API_KEY}} O reservatório de espaço é resolvido no tempo de execução a partir das credenciais armazenadas acima.

{
  "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
        }
      }
    }
  ]
}

Recarregar habilidades após a salvação:

openclaw skills reload

Passo 4 Teste-o

Faça uma pergunta em linguagem natural em qualquer canal de chat conectado:

What is the latest AUD policy rate?

O OpenClaw mapeia isto para o fetch_announcements ponto final com currency=aud E ... indicator=policy_rate- Chama-me . o ponto final da taxa de juro de política do AUD, e retorna um resumo em inglês simples.

Cenários do mundo real

Uma vez que a conexão está ativa, aqui estão os tipos de fluxos de trabalho que se tornam naturais:

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?

Automatizar um briefing macro no dia da semana

O verdadeiro poder de conectar uma API de dados a um agente sempre ligado é a automação. Configure um fluxo de trabalho OpenClaw agendado que forneça um briefing macro matinal antes de começar a negociar.

Crie um arquivo de fluxo de trabalho em ~/.openclaw/workflows/fx_morning_briefing.json- Não .

{
  "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"
}

Ajusta o ... schedule A expressão cron para o seu fuso horário e sessão de negociação. 0 6 * * 1-5 Um negociante de Nova Iorque pode preferir 0 12 * * 1-5 (UTC / 08: 00 ET).

Recarregar fluxos de trabalho após a sua conservação:

openclaw workflows reload

Todas as manhãs de um dia útil, o OpenClaw obtém os valores mais recentes, os compila em um briefing consolidado com leituras atuais e alterações recentes e empurra o resumo para o canal configurado.

Próximos passos

• Aumentar a cobertura dos indicadores explorar o catálogo completo com data_catalogue ou navegar no Documentação da APIOs pontos finais abrangem as taxas de juro, a inflação, o PIB, o desemprego, a balança comercial, as vendas no retalho, Rendimentos das obrigações a 10 anos, e mais em todas as 18 moedas suportadas.
• Combina com uma habilidade de negociação conecte o OpenClaw à API do seu corretor ao lado do FXMacroData para que o agente possa exibir uma leitura macro e um preço ao vivo na mesma resposta.
• Criar alertas condicionais só podem ser notificadas quando a taxa de juro de política mudar, quando o IPC ultrapassar um limiar ou quando o posicionamento da COT passar de longo líquido para curto líquido.
• Use o calendário de lançamento de forma proativa ter o seu agente avisá-lo antes de eventos de alto impacto para que possa gerir a exposição ao risco antes das impressões digitais.

A equipa FXMacroData