كيفية توصيل FXMacroData إلى مساعد OpenClaw AI

تخيل أن تسأل مساعد الذكاء الاصطناعي من WhatsApp أو Telegram أو Discord "ماذا فعل بنك الاحتياطي المركزي مع الأسعار هذا الشهر؟" وتحصل على إجابة فورية ودقيقة مستمدة مباشرة من الإصدارات الرسمية للبنك المركزي. هذا ما يبني هذا الدليل. بحلول النهاية، سيكون لعامل OpenClaw الخاص بك إمكانية الوصول مباشرة إلى بيانات الإعلان الاقتصادي الكلي عبر 18 عملة، تقويمات الإصلاح، وضع COT، السلع، وأسعار الفوركس كل ذلك من خلال اتصال واحد.

الطريق أ الاتصال عبر MCP أوصى

بروتوكول السياق النموذجي (MCP) هي أسرع طريقة لإعطاء OpenClaw إمكانية الوصول إلى FXMacroData. كتلة تكوين واحدة وأنتِ جاهزة لا مهارة JSON، لا نقطة نهاية، لا تعريفات مخطط يدوي. يكتشف OpenClow تلقائيًا كل أداة يعرضها الخادم ويجعلها متاحة كأدوات وكيل أصلية.

الخطوة 1 إضافة خادم MCP إلى OpenClaw الخاص بك

افتح ملف تكوين OpenClaw الخاص بك (~/.openclaw/openclaw.json أو إعدادات واجهة المستخدم) وإضافة خادم FXMacroData MCP. هناك خياران اعتمادا على ما إذا كنت تريد الخادم المستضيف أو حزمة بايثون المحلية:

الخيار A: نقطة نهاية MCP المستضافة (أبسط تثبيت صفر)

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

هذا يتصل مباشرة بخادم FXMacroData MCP الإنتاج عبر HTTP قابل للتدفق. تعمل بيانات الدولار الأمريكي على الفور دون مفتاح API. للعملات غير الدولار، قم بإضافة مفتاحها إلى عنوان URL:

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

الخيار ب: خادم MCP المحلي عبر uvx

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

هذا يبدأ عملية خادم MCP المحلي من mcp-server-fxmacrodata حزمة PyPI باستخدام نقل stdio. استخدم هذا للعملاء MCP الذين لا يدعمون اتصالات HTTP عن بعد (Claude Desktop، Cursor، Windsurf، الخ).

الخطوة 2 استكشاف الأدوات المتاحة

بمجرد الاتصال، سجل OpenClaw تلقائيًا جميع الأدوات التي يعرضها خادم MCP. إليك ما يمكنك الوصول إليه:

يقوم وكيلك بحل أي أداة للاتصال بها من اللغة الطبيعية. أنت لا تحتاج إلى حفظ أسماء الأدوات أو المعلمات فقط طرح الأسئلة.

الخطوة 3 اختبار الاتصال

افتح أي قناة دردشة OpenClaw (Discord، Telegram، WhatsApp، أو واجهة الويب) واطرح سؤالاً. ابدأ بسيطاً:

What is the current AUD policy rate?

تحت الغطاء، يطلق OpenClaw نداء أداة MCP:

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

يعيد الخادم سلسلة الإعلانات الكاملة ويقوم وكيلك بإيجاز أحدث قيمة وتاريخ الإعلام واتجاه التغيير بلغة بسيطة. حاول المزيد من التأكيد على أعمال السطح الكامل:

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?

كل من هذه الخرائط إلى أداة MCP مختلفة، و OpenClaw يوجهها تلقائيًا. تحقق من صفحات مرجعية النقطة النهائية لمزيد من خفافيش المؤشر التضخم بالدولار- لا سعر سعر العملة الأسترالية- لا الناتج المحلي الإجماليو عشرات آخرين تحت مركز API docs.

الطريق ب الاتصال عبر مهارة REST API البديل

إذا لم تدعم OpenClaw build MCP، أو إذا كنت تفضل التحكم الصريح في مسارات HTTP التي يمكن للعميل استدعائها بالضبط، يمكنك إرسال FXMacroData كمهارة HTTP مخصصة بدلاً من ذلك. يعمل هذا النهج مع كل إصدار من OpenClow.

الخطوة 1 تخزين مفتاح API الخاص بك

openclaw credentials set FXMACRODATA_API_KEY "YOUR_API_KEY"

الخطوة 2 التحقق من استجابة واجهة برمجة التطبيقات

الإعلانات عن نهاية الإنتاج تعيش في /api/v1/announcements/{currency}/{indicator}اختبره بسرعة curl.

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

ستحصل على كائن JSON مع بيانات بيانات و data صف:

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

آخر إدخال في data هي أحدث قراءة متاحة. يمكن الوصول إلى نقاط نهاية الدولار الأمريكي دون مفتاح، مما يجعلها مريحة للاختبار الأولي.

الخطوة 3 إنشاء تعريف المهارة

حفظ هذا كما ~/.openclaw/skills/fxmacrodata.json. {{FXMACRODATA_API_KEY}} يتم حل المساحة في وقت التشغيل من بيانات الاعتماد التي قمت بتخزينها أعلاه.

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

إعادة تحميل المهارات بعد حفظها:

openclaw skills reload

الخطوة 4 اختبارها

اطرح سؤال باللغة الطبيعية في أي قناة دردشة متصلة:

What is the latest AUD policy rate?

أوبنكلو يرسم هذا إلى fetch_announcements نقطة النهاية مع currency=aud و indicator=policy_rate، اتصالات النقطة النهائية لسعر الفائدة السياسية للدولار الأسترالي، ويرد ملخصاً باللغة الإنجليزية البسيطة.

سيناريوهات العالم الحقيقي

بمجرد أن يتم تشغيل الاتصال، وهنا أنواع سير العمل التي تصبح طبيعية:

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?

أتمتة إطلاع على المكتبة الكبرى خلال أيام الأسبوع

القوة الحقيقية لربط API البيانات إلى وكيل دائم هو الأتمتة. إعداد سير عمل OpenClaw المجدولة التي تقدم إطلاعًا على الكليات الصباحية قبل البدء في التداول.

إنشاء ملف سير العمل في ~/.openclaw/workflows/fx_morning_briefing.json.

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

إعدل schedule تعبير cron إلى منطقة الوقت الخاصة بك وجلسة التداول. 0 6 * * 1-5 (الساعة السادسة بالتوقيت العالمي، قبل فتح لندن مباشرة) قد يفضل تاجر نيويورك 0 12 * * 1-5 (في الساعة 12: 00 بالتوقيت العالمي / 08: 00 بالتقليدي)

إعادة تحميل سير العمل بعد حفظه:

openclaw workflows reload

كل صباح يوم أسبوعي، يجمع OpenClaw أحدث القيم، ويجمعها في إفادة موحدة مع القراءات الحالية والتغييرات الأخيرة، ويدفع الملخص إلى القناة التي تم تكوينها. إذا كنت تستخدم مسار MCP، يمكن للعميل أيضا سحب تقويم الإصدار لتعريف أي أحداث بيانات مقررة ليوم قادم.

الخطوات التالية

• توسيع نطاق تغطية المؤشرات استكشاف الكتالوج الكامل مع data_catalogue أو تصفح وثائق واجهة برمجة التطبيقاتوتشمل النقاط النهائية أسعار السياسة، التضخم، الناتج المحلي الإجمالي، البطالة، الميزان التجاري، مبيعات التجزئة، عائدات السندات لمدة 10 سنوات، وأكثر في جميع العملات المدعومة 18.
• الجمع بين مهارة التداول سلك OpenClaw إلى واجهة برمجة برمجيات الوسيط الخاص بك جنبا إلى جنب مع FXMacroData حتى يتمكن الوكيل من ظهور قراءة الكلية وسعر مباشر في نفس الاستجابة. "ما هو أحدث مؤشر أسعار المستهلك AUD وأين يتم تداول AUD / USD؟" يصبح استفسار واحد.
• إنشاء تنبيهات مشروطة تنشئ إخطارًا فقط عندما يتغير سعر الفائدة، أو عندما يتجاوز مؤشر أسعار المستهلكين عتبةً، أو عند تحويل موقع COT من صافي طويل إلى صافي قصير.
• استخدم جدول الإصدارات بشكل استباقي أن يحذرك وكيلك قبل وقوع أحداث ذات تأثير كبير حتى تتمكن من إدارة التعرض للمخاطر قبل البصمات.

فريق FXMacroData