← Back to Skills Marketplace
xiehuapeng

FX Monitor

by xiehuapeng · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ✓ Security Clean
205
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install fx-monitor
Description
Monitor Bank of China FX rates and manage reusable GBP/HKD/JPY alert workflows. Use when the task involves checking current BOC exchange rates, comparing the...
README (SKILL.md)

Fx Monitor

Use the bundled portable checker instead of relying on host-specific scripts.

Workflow

  1. Run python3 /home/xhp/.openclaw/workspace/skills/fx-monitor/scripts/check_boc_fx.py.
  2. Parse the key-value output.
  3. Handle results by STATUS:
    • ALERT: send one concise Chinese alert message.
    • NO_ALERT: return NO_REPLY unless the user explicitly asked for a status report.
    • ERROR: report a short Chinese failure message with MESSAGE.

Output rules

For alert messages:

  • Start with 【汇率告警】.
  • Include the Bank of China page publish time.
  • Mention all triggered conditions naturally in one sentence.
  • Prefer the wording pattern 英镑现汇卖出价下跌 ... / 港币现汇买入价上涨 ... / 日元现汇卖出价下跌 ....
  • Include comparison values when available.

If the user asks for a normal status report instead of an alert-only run, include:

  • whether an alert triggered
  • current GBP spot sell
  • current HKD spot buy
  • current JPY spot sell
  • page publish time
  • whether this run wrote a new history snapshot implicitly from the returned data when relevant

Bundled files

  • Checker script: /home/xhp/.openclaw/workspace/skills/fx-monitor/scripts/check_boc_fx.py
  • Default history CSV: /home/xhp/.openclaw/workspace/skills/fx-monitor/data/boc_fx_history.csv

Notes

  • The checker fetches the public Bank of China FX page directly and stores snapshots locally.
  • The first successful run usually creates the baseline history row and returns NO_ALERT; comparison-based alerts begin once at least two snapshots exist.
  • If the task is about cron management, keep only the FX monitor cron enabled unless the user asks otherwise.
  • If a user wants custom thresholds or another history file path, pass CLI flags instead of editing the script first.
Usage Guidance
This skill appears to be what it says: a small Python checker that fetches the public Bank of China FX page, keeps a local CSV history, and emits alert/status key=value lines. Before installing or running, note the following: (1) SKILL.md tells you to run python3 at an absolute path (/home/xhp/...), which likely won't match your machine — run the included scripts/check_boc_fx.py from the skill workspace or update the path. (2) Ensure you have python3 available (not declared in metadata) and outbound HTTP(S) allowed so the script can reach https://www.boc.cn/sourcedb/whpj/. (3) The script will create/append a local CSV history file (data/boc_fx_history.csv) in the skill folder — confirm you are okay with that write. (4) If you plan to enable a cron, manage cron jobs yourself; the skill does not require or perform system-wide changes. (5) Review/modify THRESH_* values or pass CLI flags for custom thresholds or history path if needed. If you want stronger isolation, run the script in a sandbox or inspect/execute it manually before letting an agent invoke it autonomously.
Capability Analysis
Type: OpenClaw Skill Name: fx-monitor Version: 0.1.1 The fx-monitor skill bundle is designed to track Bank of China exchange rates for GBP, HKD, and JPY. The core logic in scripts/check_boc_fx.py uses standard libraries to fetch public data from boc.cn, parse it via regex, and maintain a local history in a CSV file. The instructions in SKILL.md are consistent with the stated purpose of monitoring and alerting, and no indicators of data exfiltration, malicious execution, or harmful prompt injection were identified.
Capability Assessment
ℹ Purpose & Capability
The bundled Python script fetches the Bank of China FX page, parses GBP/HKD/JPY rates, stores a local history CSV, and emits key=value alert output — this matches the skill's stated purpose. Minor mismatch: SKILL.md claims a 'portable checker' that 'should work on any user's machine' but the doc instructs running an absolute path (/home/xhp/.openclaw/...), and the package metadata does not declare a required binary; the script requires python3 but no required binaries are listed.
ℹ Instruction Scope
Runtime instructions are narrowly scoped to running the included checker and handling its key=value output. The main concern is the hard-coded absolute invocation path in SKILL.md which may not exist on other systems; otherwise the instructions do not request unrelated files, credentials, or external endpoints beyond the public BOC URL.
✓ Install Mechanism
There is no install spec (instruction-only) and the skill includes a local Python script and a small CSV. No downloads, external packages, or archive extraction are used.
✓ Credentials
The skill declares no required environment variables or credentials and the script only makes an unauthenticated HTTPS request to the public Bank of China page. It does write a local history CSV in the skill's data folder but does not access or request unrelated secrets.
✓ Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges; it writes and appends a local history CSV in its own directory (DEFAULT_HISTORY). SKILL.md references cron management advice, but the skill does not autonomously create or modify system crons in the provided files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install fx-monitor
  3. After installation, invoke the skill by name or use /fx-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Replace local host-specific workflow with portable built-in BOC fetcher and local history storage
v0.1.0
Initial publish
Metadata
Slug fx-monitor
Version 0.1.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is FX Monitor?

Monitor Bank of China FX rates and manage reusable GBP/HKD/JPY alert workflows. Use when the task involves checking current BOC exchange rates, comparing the... It is an AI Agent Skill for Claude Code / OpenClaw, with 205 downloads so far.

How do I install FX Monitor?

Run "/install fx-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is FX Monitor free?

Yes, FX Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does FX Monitor support?

FX Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created FX Monitor?

It is built and maintained by xiehuapeng (@xiehuapeng); the current version is v0.1.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463942 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259883 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200739 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191401 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190375 · by oswalpalash

💬 Comments