Cara Membangun Agen Perdagangan FX dengan NVIDIA NemoClaw dan FXMacroData

Mengapa NemoClaw dan FXMacroData harus bersama

NVIDIA NemoClaw adalah open-source referensi tumpukan yang berputar OpenClaw agen AI yang selalu aktif, di-host sendiri ke dalam runtime yang keras, sandboxed yang didukung oleh infrastruktur inferensi NVIDIA. OpenClaw memberi Anda AI yang berjalan 24/7 di mesin Anda, terhubung ke aplikasi obrolan seperti Telegram dan WhatsApp, dan dapat mengeksekusi kode, memanggil API, dan bertindak atas informasi secara otonom. NemoClaw membungkus agen itu ke dalam sandbox yang aman (Landlock + seccomp + ruang nama jaringan), mengelola titik akhir model, dan menambahkan onboarding dipandu yang membuat Anda dari nol untuk berjalan dalam satu perintah terminal.

Untuk perdagangan FX dan penelitian makro, kombinasi itu menarik. Sebagian besar alur kerja agen AI jatuh ke dalam salah satu dari dua mode: Anda mengajukan pertanyaan, Anda mendapatkan jawaban. Apa yang dimungkinkan NemoClaw berbeda agen persisten yang memantau cetakan inflasiAku akan pergi. keputusan kebijakan bank sentral, dan pergerakan harga spot terhadap kriteria Anda, dan memperingatkan Anda FXMacroData menyediakan lapisan data: API REST terstruktur dan Server MCP mencakup 18 mata uang dengan suku bunga kebijakan, CPI, PDB, pekerjaan, neraca perdagangan, posisi COT, dan banyak lagi.

Panduan ini berjalan melalui pengaturan NemoClaw, memberikan akses agen Anda ke FXMacroData, menulis keterampilan pemantauan yang dapat digunakan kembali, dan menjalankan peringatan kejutan makro akhir ke akhir pertama pada USD/JPYAku tidak tahu.

Bagaimana tumpukan cocok bersama-sama

Sebelum menyelam ke dalam pengaturan membantu untuk memahami apa yang dilakukan setiap lapisan:

• OpenClaw is the agent itself — a self-hosted AI assistant that runs continuously, connects to your chat channels, and can execute shell commands, write and run code, call APIs, and remember context across sessions. It uses Claude, GPT-4, or local models as its LLM backend.
• NemoClaw adalah pengelupasan penyebaran yang aman. Ini menginstal NVIDIA OpenShell, membuat sandboxed container untuk OpenClaw, mengkonfigurasi inferensi yang dikelola melalui API NVIDia (model Nemotron), dan menyediakan nemoclaw CLI untuk mengelola seluruh lingkungan.
• FXMacroData adalah tingkat data. Agen Anda memanggil FXMacroData REST API untuk membaca riwayat pengumuman makro, perkiraan, spot FX rate, data COT, dan acara kalender rilis. API terstruktur, versi, dan selalu mengembalikan data yang didukung Firestore tidak ada scraping, tidak ada volatilitas pihak ketiga pada saat permintaan.

Aliran yang khas setelah Anda memiliki tumpukan berjalan:

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

Agen Anda tinggal di kotak pasir. Ini memanggil FXMacroData melalui HTTPS melalui kebijakan jaringan yang dikelola kotak pasir . Anda berinteraksi dengannya dari ponsel atau desktop Anda melalui Telegram. Lapisan keamanan NemoClaw berarti bahwa bahkan jika agen dikompromikan atau diberi prompt yang buruk, ia tidak dapat mencapai tujuan jaringan sewenang-wenang atau mengakses sistem file host Anda hanya aturan keluar yang Anda setujui selama onboarding.

Persyaratan

• Linux, macOS (Apple Silicon), atau Windows WSL2 dengan Docker terinstal dan berjalan.
• Node.js 22.16+ dan npm 10+ (pemasang NemoClaw mengatur ini secara otomatis jika hilang).
• Sebuah akun Telegram (saluran tercepat untuk diuji dengan bot token membutuhkan waktu sekitar dua menit untuk membuat melalui @BotFather)).
• Kunci API NVIDIA dari build.nvidia.com untuk model Nemotron kesimpulan, atau kunci Anthropic / OpenAI jika Anda lebih suka untuk menyediakan model Anda sendiri.
• Kunci API FXMacroData dari Manajemen API data USD tersedia di tingkat gratis; akses multi-mata uang membutuhkan rencana berbayar.

Langkah 1: Instal NemoClaw dan onboard OpenClaw

Jalankan instalator NemoClaw. Ini menarik Node.js melalui nvm jika Anda tidak memilikinya, menginstal NemoCrow CLI, dan meluncurkan wizard interaktif onboard:

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

Pembantu meminta Anda untuk memberi nama asisten Anda, memilih penyedia kesimpulan (pilih NVIDIA Endpoints for Nemotron), dan tempelkan kunci API NVIDia Anda.

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

Hubungkan ke sandbox untuk memverifikasi agen sedang berjalan:

nemoclaw fx-agent connect

Di dalam kotak pasir, buka UI terminal OpenClaw dan kirim salam cepat:

openclaw tui

Langkah 2: Hubungkan saluran Telegram

Tetap di dalam shell sandbox, konfigurasi Telegram sehingga Anda dapat mengirim pesan kepada agen dari ponsel Anda. @BotFather di Telegram, maka:

# Inside the nemoclaw sandbox shell
openclaw channel add telegram

Ikuti petunjuk untuk menempelkan token bot Anda dan ID pengguna Telegram pribadi Anda (agen membatasi pesan masuk ke daftar izin yang Anda berikan). hello ke bot dari Telegram Anda harus mendapatkan tanggapan dari agen dalam beberapa detik.

Langkah 3: Ekspose FXMacroData ke agen

Sandbox memiliki akses jaringan keluar secara default ke HTTPS pada port 443. https://fxmacrodata.com/api/v1, jadi tidak ada kebijakan keluar tambahan yang diperlukan. Apa yang Anda butuhkan adalah untuk membuat kunci API Anda tersedia di dalam sandbox tanpa muncul dalam skrip diperiksa ke kontrol versi.

Dari luar kotak pasir, mengatur rahasia menggunakan NemoClaw manajer rahasia:

nemoclaw fx-agent secret set FXMD_API_KEY your_api_key_here

Sandbox menyuntikkan ini sebagai variabel lingkungan pada saat startup. Setiap skrip yang dijalankan agen di dalam wadah dapat membacanya dengan os.environ["FXMD_API_KEY"], dan tidak pernah ditulis ke disk atau di log.

Untuk memastikan kunci terkoneksi dengan benar, tanyakan kepada agen dari 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.

Agen akan menulis naskah, mengeksekusi di dalam kotak pasir, dan kembali terbaru US CPI pembacaan mengkonfirmasi konektivitas end-to-end.

Langkah 4: Tulis keterampilan pemantauan FX

Sistem keterampilan OpenClaw memungkinkan Anda mengemas kemampuan agen yang dapat digunakan kembali sebagai file YAML. Keterampilan adalah deskripsi yang dibaca agen pada saat startup; ketika Anda memintanya untuk melakukan sesuatu yang sesuai dengan keterampilan, ia tahu bagaimana melanjutkan tanpa Anda menjelaskan kembali alur kerja setiap kali.

Buat file keterampilan baru di dalam sandbox.

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

Agen membaca semua file keterampilan di ~/.openclaw/skills/ Setelah menambahkan file, mulai ulang sesi di dalam kotak pasir:

openclaw session restart

Langkah 5: Buat dan jalankan scan kejutan inflasi

Sekarang uji kemampuan dari ujung ke ujung.

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.

Agen akan menulis dan menjalankan skrip Python di dalam sandbox.

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

Agen menjalankan ini, membaca output, dan mengirim Anda ringkasan berformat melalui Telegram tidak ada pengumpulan data manual, tidak ada spreadsheet.

Langkah 6: Jadwalkan briefing makro harian

Salah satu penggunaan yang paling praktis dari agen NemoClaw yang selalu aktif adalah briefing harian yang dijadwalkan.

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.

Agen akan menulis kode penjadwalan ke dalam keterampilan / konfigurasi sendiri dan mengkonfirmasi pengaturan. dari titik itu berjalan secara otonom Anda bangun untuk pembukaan kalender terstruktur menunjukkan mendatang EUR CPIAku akan pergi. Pengangguran Inggris, dan setiap peristiwa tier-1 lainnya yang akan terjadi pada hari itu, dengan nilai sebelumnya dan perkiraan konsensus yang sudah dipenuhi.

Contoh output briefing dari agen:

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

Langkah 7: Buat monitor posisi langsung

Pola yang lebih maju adalah memberi agen serangkaian posisi berjalan dan meminta itu memperingatkan Anda ketika data makro menggeser 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.

Agen membuat skrip jajak pendapat di dalam kotak pasir yang memeriksa kalender FXMacroData pada rentang yang teratur. AUD CPI atau Pekerjaan AUD karena agen berjalan di dalam kotak pasir NemoClaw yang dikelola dengan kebijakan jaringan yang diberlakukan, ia hanya dapat mencapai titik akhir HTTPS yang disetujui kunci API dan pipa data Anda terisolasi dari sisa mesin Anda.

Menggunakan server FXMacroData MCP

FXMacroData juga mengekspos hosted Server MCP di https://fxmacrodata.com/mcp. Jika Anda ingin menghubungkannya ke agen secara langsung sebagai alat asli daripada memiliki agen menulis Python untuk memanggil REST API Anda dapat mengkonfigurasi keterampilan MCP menunjuk ke server FXMacroData. Ini memungkinkan agen panggilan indicator_queryAku akan pergi. release_calendarAku akan pergi. forex, dan alat lain secara native, tanpa menulis kode lem.

Konsultasikan dengan Dokumen server MCP untuk detail koneksi. Model auth adalah sama: query-param API key atau OAuth/PKCE. Baik dapat digunakan dari dalam NemoClaw sandbox setelah titik akhir MCP ditambahkan ke daftar keluar yang disetujui selama onboarding.

Untuk pertanyaan penelitian ad-hoc "apa reaksi EUR/USD terhadap lima keputusan ECB terakhir?" jalur MCP lebih cepat karena agen tidak perlu membangun skrip terlebih dahulu.

Model keamanan dan mengapa hal itu penting untuk perdagangan

Mengoperasikan agen AI dengan akses kunci API ke data keuangan menghasilkan permukaan serangan nyata.

• Blok daratan menghambat file mana yang dapat dibaca atau ditulis oleh proses sandboxed pada host Anda. Agen tidak dapat mengakses kunci SSH, kredensial browser, atau file host sensitif lainnya.
• seccomp membatasi panggilan sistem yang dapat dilakukan agen, memblokir kategori eskalasi hak istimewa dan teknik pelarian kontainer.
• Ruang nama jaringan berarti semua koneksi keluar melalui gateway OpenShell, yang menegakkan kebijakan keluar yang telah disetujui. agen tidak dapat mencapai titik akhir sewenang-wenang hanya yang Anda secara eksplisit diizinkan selama onboarding, termasuk fxmacrodata.comAku tidak tahu.
• Manajemen Rahasia lewat nemoclaw secret set memastikan kunci API disuntikkan pada saat runtime daripada disimpan dalam file plaintext atau diteruskan melalui chat.

Untuk alur kerja perdagangan di mana agen memiliki wewenang untuk mengeksekusi skrip yang memanggil titik akhir data keuangan, batas itu berarti. serangan injeksi instan di mana musuh menyematkan instruksi dalam data yang dibaca agen dibatasi oleh fakta bahwa agen hanya dapat bertindak dalam kotak pasirnya, bukan di host atau jaringan yang lebih luas.

Langkah selanjutnya

Setelah tumpukan garis dasar berjalan, beberapa arah alami untuk memperpanjangnya:

• Pemantauan multi-mata uang: memperluas scan kejutan untuk mencakup semua mata uang di Kalender rilis FXMacroData Agen dapat menjalankan scan ini setiap jam dan hanya memberi tahu ketika sesuatu yang material cetak.
• Integrasi COTTarik Data posisi COT bersama dengan kejutan makro untuk menilai apakah beat atau miss berdagang melawan atau dengan posisi spekulatif saat ini.
• Model router: Router model eksperimental NemoClaw memungkinkan Anda menentukan kumpulan model dan secara otomatis mengarahkan setiap kueri ke yang termurah yang memenuhi ambang ketepatan. Untuk pemeriksaan kalender rutin, model kecil menangani dengan baik; untuk evaluasi tesis yang lebih kompleks, router melangkah ke model yang lebih besar secara otomatis.
• Dashboard khusus pasanganSetelah agen muncul sinyal makro, mengarahkan ke EUR/USD atau GBP/USD dashboard untuk pemeriksaan silang visual dari tren indikator sebelum bertindak.

Referensi FXMacroData API adalah di fxmacrodata.com/api-data-docsDokumen NemoClaw, termasuk referensi perintah CLI lengkap, ada di Docs.nvidia.com/nemoclaw/latest. Keduanya layak dibaca bersama panduan ini arsitektur berubah dengan cepat karena kedua proyek sedang dalam pengembangan aktif.