لماذا نيمو كلور و FXMacroData ينتميان معاً

نيفيا نيموكلاو هو كومة مرجعية مفتوحة المصدر التي تدور (أوبنكلو) عميل الذكاء الاصطناعي المستضيف ذاتيًا دائمًا في وقت تشغيل متشدد ومحفوظ مدعومًا بإنشاءات استنتاج NVIDIA. يمنحك OpenClaw AI تعمل على جهازك على مدار الساعة ، وتتصل بتطبيقات الدردشة مثل Telegram و WhatsApp ، ويمكن أن تنفذ التعليمات البرمجية ، وتستدعي واجهات برمجة التطبيق ، وتتصرف على المعلومات بشكل مستقل. يلف NemoClaw هذا العميل في صندوق رمل آمن (Landlock + seccomp + مساحة أسماء الشبكة) ، ويدير نقطة نهاية النموذج ، ويضيف إدخالًا موجهًا يجعلك من الصفر إلى تشغلك في أمر محطة واحد.

بالنسبة لتداول العملات الأجنبية والبحوث الكلية، هذا المزيج مقنع. معظم سير العمل وكيل الذكاء الاصطناعي تقع في أحد طريقتين: تسأل سؤالا، تحصل على إجابة. ما تمكن NemoClaw مختلفة وكيل مستمر يراقب طبعات التضخم- لا قرارات سياسة البنك المركزي، وتحركات أسعار الفورية ضد معاييرك، و يحذرك عندما يحدث شيء يطابق حافة محددة مسبقاً. توفر FXMacroData طبقة البيانات: واجهة برمجة برمجة التطبيقات REST المنظمة و خادم MCP تغطي 18 عملة مع أسعار الفائدة السياسية، مؤشر أسعار المستهلكين، الناتج المحلي الإجمالي، العمالة، الميزانيات التجارية، وضع COT، وأكثر من ذلك.

هذا الدليل يمر من خلال إعداد NemoClaw، وإعطاء الوكيل الخاص بك الوصول إلى FXMacroData، وكتابة مهارة المراقبة قابلة لإعادة الاستخدام، وتشغيل أول انتباه مفاجأة ماكرو من نهاية إلى نهاية على الدولار الأمريكي مقابل اليابان. .

إشعار ألفا
نيموكلاو متاح كمعاينة مبكرة اعتبارًا من مارس 2026. قد تتغير الواجهات والسلوك دون إشعار. تستند أنماط التكامل في هذه المقالة إلى سطح واجهة برمجة التطبيقات المُصدر حاليًا ، ولكن تحقق من (دكتور (نيمو كلور لأحدث خطوات الإدماج

كيف تتوافق المجموعة مع بعضها البعض

قبل الغوص في الإعداد يساعد على فهم ما تفعله كل طبقة:

(أوبنكلو) هو العميل نفسه مساعد الذكاء الاصطناعي المستضيف ذاتيًا يعمل باستمرار ، ويتصل بقنوات الدردشة الخاصة بك ، ويمكنه تنفيذ أوامر القشرة ، وكتابة وتشغيل البرمجة ، ودعوة واجهات برمجة التطبيقات ، وتذكر السياق عبر الجلسات. يستخدم Claude ، GPT-4 ، أو النماذج المحلية كخلفية LLM.
نيمو كلو هو غلاف التنفيذ الآمن. يثبت NVIDIA OpenShell، ويخلق حاوية رملية لـ OpenClaw، ويتم تكوين استنتاجات مديرة من خلال API NVIDia (نموذج Nemotron) ، ويوفر nemoclaw CLI لإدارة البيئة بأكملها.
FXMacroData هو مستوى البيانات. يقوم وكيلك بدعوة FXMacroData REST API لقراءة تاريخ الإعلانات الكبرى والتوقعات ومعدلات صرف العملات الأجنبية الفورية وبيانات COT وأحداث التقويم الإصدارية. يتم هيكلة API ، والإصدارات ، وتعيد دائمًا البيانة المدعومة من Firestore دون كشط ، ولا تقلبات من طرف ثالث في وقت الطلب.

التدفق النموذجي بمجرد تشغيل المجموعة:

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

يعمل وكيلك في صندوق رمل. وهو يدعو FXMacroData عبر HTTPS من خلال سياسة الشبكة المدارة في صندوق الرمل. تتفاعل معه من هاتفك أو سطح المكتب عبر Telegram. تعني طبقة الأمان NemoClaw أنه حتى لو تم اختراق وكيل أو تغذية طلب سيء ، فإنه لا يمكن الوصول إلى وجهات الشبكات التعسفية أو الوصال إلى نظام الملفات المضيف الخاص بك فقط قواعد الخروج التي وافقت عليها أثناء التشغيل.

الشروط المسبقة

لينكس، ماكوس (أبل سيلكون) ، أو ويندوز WSL2 مع Docker مثبتة وتشغيل.
Node.js 22.16+ و npm 10+ (مثبت NemoClaw يضع هذه تلقائيًا إذا كانت مفقودة).
حساب تليجرام (أسرع قناة لاختبارها) يستغرق إعداد رمز الروبوت حوالي دقيقتين @BotFather)
مفتاح NVIDIA API من build.nvidia.com للاستنتاج النموذجي من نموترون، أو مفتاح الأنثروبيك/OpenAI إذا كنت تفضل تقديم نموذجك الخاص.
مفتاح FXMacroData API من إدارة واجهة برمجة التطبيقات المعلومات المتاحة في الدولار الأمريكي متاحة في المستوى المجانية؛ الوصول إلى عملات متعددة يتطلب خطة مدفوعة.

الخطوة 1: تثبيت NemoClaw و على متن OpenClaw

قم بتشغيل برنامج تثبيت NemoClaw. إنه يسحب Node.js عبر nvm إذا لم يكن لديك ، ويثبت CLI NemoCrow ، ويطلق المشرف التفاعلي المضمن:

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

يطلب منك المساعد تسمية مساعدك، واختيار مزود استنتاج (اختر نقاط نهاية NVIDIA لـ Nemotron) ، ولصق مفتاح NVIDia API الخاص بك. ثم يخلق حاوية صناديق الرمل ويدبّت ملخصًا:

──────────────────────────────────────────────────────
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

اتصل بالصندوق للتحقق من تشغيل العميل:

nemoclaw fx-agent connect

داخل مربع الرمل، افتح واجهة المستخدم في محطة OpenClaw وارسل مرحبا سريعا:

openclaw tui

الخطوة 2: قم بتوصيل قناة تليجرام

البقاء داخل قشرة الصندوق، تكوين تلغرام بحيث يمكنك الرسالة إلى العميل من هاتفك. أولا إنشاء رمز بوت من @BotFather على التليجرام، ثم:

# Inside the nemoclaw sandbox shell
openclaw channel add telegram

اتبع الإرشادات لتلصق رمز الروبوت الخاص بك ومعرف المستخدم الشخصي في تليجرام (الوكيل يحد من الرسائل الواردة إلى قائمة الإذن التي تقدمها). بمجرد الاتصال ، أرسل hello إلى الروبوت من تلغرام يجب أن تحصل على رد من الوكيل في غضون بضع ثوان.

الخطوة 3: تعرض FXMacroData للعميل

الصندوق الرملي لديه وصول شبكة خارجي افتراضي إلى HTTPS على منفذ 443. قاعدة واجهة برمجة التطبيقات FXMacroData هي https://fxmacrodata.com/api/v1، لذلك لا حاجة إلى سياسة خروج إضافية. ما تحتاجه هو جعل مفتاح API الخاص بك متاحًا داخل الصندوق دون أن يظهر في النصوص النصية التي تم فحصها في التحكم في الإصدار.

من خارج صندوق الرمل، حدد السر باستخدام مدير أسرار نيمو كلور:

nemoclaw fx-agent secret set FXMD_API_KEY your_api_key_here

يضخ صندوق الرمل هذا كمتغير بيئي عند بدء التشغيل. أي برنامج برمجي يديره العميل داخل الحاوية يمكن قراءته به os.environ["FXMD_API_KEY"]، وهو لا يكتب إلى القرص أو تسجيل.

للتحقق من أن المفتاح مُتصل بشكل صحيح، اسأل عميل التليجرام:

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.

العميل سيكتب النص، وينفذه داخل صندوق الرمل، ويرد آخر مؤشر أسعار المستهلكين الأمريكي القراءة تؤكد الاتصال من نهاية إلى نهاية.

الخطوة 4: اكتب مهارة مراقبة العملات الأجنبية

يسمح لك نظام مهارات OpenClaw بتعبئة قدرات العميل القابلة لإعادة الاستخدام كملفات YAML. المهارة هي وصف يقرأه العميل عند بدء التشغيل ؛ عندما تطلب منه القيام بشيء يطابق المهارات ، فإنه يعرف كيفية المضي قدما دون إعادة شرح سير العمل في كل مرة.

إنشاء ملف مهارة جديد داخل الصندوق الرملي من داخل قشرة الصندق المتصلة:

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

العميل يقرأ كل ملفات المهارات ~/.openclaw/skills/ عند بدء الجلسة بعد إضافة الملف، إعادة تشغيل الجلسات داخل مربع الرمل:

openclaw session restart

الخطوة 5: بناء وتشغيل مسح التضخم المفاجئ

الآن اختبر المهارة من النهاية إلى النهاية من التليجرام ، أرسل:

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.

سيقوم العميل بكتابة وتنفيذ برنامج Python داخل صندوق الرمال. يبدو البرنامج النصي النموذجي الذي قد ينتجه هكذا:

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']}")

يقوم الوكيل بتشغيل هذا، ويقرأ الناتج، ويرسل لك ملخصاً مُنسَجَلاً عبر التليجرام لا جمع بيانات يدوي، لا جدول بيانات.

الخطوة 6: حدد موعد لإجراء جلسة إعلامية يومية

أحد الاستخدامات الأكثر عملية لعامل NemoClaw دائمًا هو إطلاع يومي مُجدد. يدعم OpenClaw مهام ضربات القلب على غرار cron. اسأل العميل من Telegram:

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.

سيقوم العميل بكتابة رمز الجدول الزمني في مهاراته الخاصة / تكوين وتأكيد الإعداد. من تلك النقطة يعمل بشكل مستقل تستيقظ إلى إطلاع تقويم منظم يظهر القادم مؤشر أسعار المستهلكين للدولار- لا البطالة في المملكة المتحدة، وأي أحداث أخرى من المستوى الأول من أجل ذلك اليوم، مع القيم السابقة وتوقعات الإجماع التي تم تعبئتها بالفعل.

عينة إصدار إطلاع من الوكيل:

📅 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.

الخطوة 7: بناء جهاز مراقبة الموقع

نمط أكثر تقدماً هو إعطاء العميل مجموعة من المواقف الجارية و أن يُنبيهك عندما تغير البيانات الكبرى الرسالة.

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.

يقوم العميل بإنشاء نص اقتراع داخل مربع الرمل الذي يتحقق من تقويم FXMacroData على نطاق منتظم. مؤشر أسعار المستهلكين للدولار الأسترالي أو العمالة في الدولار الأسترالي يظهر برنامج print، وهو يقارن الفعلي بالاتفاقية ويطلق التنبيه إذا تم الوفاء بالحد الأدنى. لأن العميل يعمل داخل مربع الرمل المدار من NemoClaw مع سياسات الشبكة المفروضة، فإنه لا يمكن أن يصل إلا إلى نقاط نهاية HTTPS المعتمدة مفتاح API الخاص بك ومجرى البيانات معزول عن بقية جهازك.

باستخدام خادم FXMacroData MCP

فكس ماكرو داتا أيضاً تعرض خادم MCP في https://fxmacrodata.com/mcpإذا كنت ترغب في توصيله بالعميل مباشرة كأداة أصلية بدلاً من أن يكتب العميل Python للاتصال بـ REST API يمكنك تكوين مهارة MCP تشير إلى خادم FXMacroData. هذا يسمح للعميل بالاتصال indicator_query- لا release_calendar- لا forex، وأدوات أخرى بشكل أصلي، دون كتابة أي رمز الغراء.

استشاري مستندات خادم MCP لمعلومات الاتصال. نموذج التوثيق هو نفسه: مفتاح API query-param أو OAuth / PKCE. يمكن استخدام أي منهما من داخل مربع رمل NemoClaw بمجرد إضافة نقطة نهاية MCP إلى قائمة الخروج المعتمدة أثناء التشغيل.

بالنسبة لأسئلة البحث المخصصة "ما كان رد فعل EUR / USD على القرارات الخمسة الأخيرة للبنك المركزي الأوروبي؟" مسار MCP أسرع لأن الوكيل لا يحتاج إلى وضع نص أولاً. بالنسبة للمهام المجدولة أو مراقبة الإنتاج ، يمنحك مسار REST API المزيد من التحكم في معالجة الأخطاء وإعادة المحاولة.

نموذج الأمن ولماذا يهم للتداول

تشغيل وكلاء الذكاء الاصطناعي مع مفتاح API للوصول إلى البيانات المالية يظهر سطح هجوم حقيقي. يعالج صندوق رملي NemoClaw هذا على مستوى نظام التشغيل:

محاصرة يحد من الملفات التي يمكن للعملية المربعة بالقشرة قراءتها أو كتابتها. لا يمكن للوكيل الوصول إلى مفاتيح SSH أو بيانات اعتماد المتصفح أو ملفات المضيف الحساسة الأخرى.
سيكومب يحد من مكالمات النظام التي يمكن للعميل إجراؤها، مما يحظر فئات تصعيد الامتيازات وتقنيات هروب الحاوية.
مساحات أسماء الشبكة يعني أن جميع الاتصالات الخارجة تمر عبر بوابة OpenShell ، والتي تفرض سياسة الخروج المعتمدة الخاصة بك. لا يمكن للعميل الوصول إلى نقاط نهاية عشوائية فقط تلك التي سمحت بها صراحة أثناء التشغيل ، بما في ذلك fxmacrodata.com. .
إدارة الأسرار عبر nemoclaw secret set يضمن حقن مفاتيح واجهة برمجة التطبيقات في وقت التشغيل بدلا من تخزينها في ملفات نص واضح أو تمريرها عبر الدردشة.

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

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

بمجرد تشغيل كومة الخط الأساسي، بعض الاتجاهات الطبيعية لتوسيعه:

مراقبة العملات المتعددة: توسيع فحص المفاجأة لتغطية جميع العملات على تقويم إصدار FXMacroData ويحدد ترتيباتها حسب تأثير السوق المتوقع ويمكن للعميل تشغيل هذا المسح كل ساعة ويقوم بتنبيهك فقط عندما يتم طباعة شيء مادي
تكامل COTاسحب بيانات تحديد المواقع في مركز التشغيل إلى جانب مفاجآت الكلية لتقييم ما إذا كان ضربة أو فشل هو التداول ضد أو مع الموقف المضاربة الحالية.
نموذج جهاز التوجيه: يسمح لك جهاز توجيه النموذج التجريبي لـ NemoClaw بتحديد مجموعة من النماذج ويرسل تلقائيًا كل استفسار إلى أرخص واحد يفي بحد أدنى من الدقة. للتحقق من التقويم الروتيني ، يتعامل مع النمذج الصغير بشكل جيد ؛ لقياس أطروحة أكثر تعقيدًا ، يرتفع جهاز التوجيه إلى نموذج أكبر تلقائياً.
لوحات الأجهزة الخاصة بالأزواجبعد أن يظهر العامل إشارة كبيرة، توجيهها إلى اليورو/دولار أو جنيه استرليني مقابل دولار أمريكي لوحة أجهزة للتحقق المرئي من اتجاهات المؤشرات قبل التصرف.

مرجع FXMacroData API هو في fxmacrodata.com/api-data-docsوثائق NemoClaw، بما في ذلك إشارة كاملة إلى أمر CLI، موجودة في docs.nvidia.com/nemoclaw/latest (موقع المعلومات).كلاهما يستحق القراءة جنبا إلى جنب مع هذا الدليل تتغير الهندسة المعمارية بسرعة لأن كلا المشروعين في مرحلة تطوير نشطة.

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