Cny Rate Calculator

CNY Rate Calculator (大草原匯率計算器)

Automatically fetch Bank of Taiwan CNY exchange rates and calculate tiered pricing.

⚠️ Required Setup

You MUST configure a channel before using this skill.

This skill will auto-detect your OpenClaw system configuration if available. If auto-detection fails, you'll need to edit config.json.

Auto-Detection

This skill will automatically detect your channel from:

1. config.json - Explicit configuration (highest priority)
2. OpenClaw system config - Your existing OpenClaw channel settings
3. Environment variables - Tokens and webhooks

If auto-detection succeeds, you'll see a message like:

✅ Auto-detected Telegram channel: 123456789

Supported Channels

Quick Start

Option 1: Auto-Detect (Recommended)

If you already have OpenClaw configured with Telegram or other channels, just run:

python scripts/cny_rate.py

The skill will automatically detect and use your existing configuration.

Option 2: Manual Configuration

1. Configure channel in config.json
2. Set environment variables (if needed for your channel)
3. Run:

   python scripts/cny_rate.py
   

Or use --setup to see the full setup guide:

python scripts/cny_rate.py --setup

What It Does

1. Fetch Rates: Gets live CNY exchange rates from Bank of Taiwan
2. Calculate: Applies the Prairie Grasslands formula:
   • Mid price = (Buy + Sell) / 2
   • Base cost = Mid + 0.05
   • 10K discount = Mid + 0.03
   • 50K discount = Mid + 0.015
3. Send: Outputs to configured channel

Configuration Examples

Telegram

{
  "channel": {
    "type": "telegram",
    "target": "123456789"
  }
}

Environment: TELEGRAM_BOT_TOKEN=your_bot_token

Discord

{
  "channel": {
    "type": "discord",
    "target": "https://discord.com/api/webhooks/..."
  }
}

Slack

{
  "channel": {
    "type": "slack",
    "target": "https://hooks.slack.com/services/..."
  }
}

Signal (via OpenClaw Gateway)

{
  "channel": {
    "type": "signal",
    "target": "+886123456789"
  }
}

Environment: OPENCLAW_GATEWAY_TOKEN=your_token

WhatsApp (via OpenClaw Gateway)

{
  "channel": {
    "type": "whatsapp",
    "target": "+886123456789"
  }
}

Environment: OPENCLAW_GATEWAY_TOKEN=your_token

iMessage (macOS)

{
  "channel": {
    "type": "imessage",
    "target": "Contact Name"
  }
}

Requires macOS or OpenClaw Gateway with OPENCLAW_GATEWAY_TOKEN

IRC (via OpenClaw Gateway)

{
  "channel": {
    "type": "irc",
    "target": "#channel-name"
  }
}

Environment: OPENCLAW_GATEWAY_TOKEN=your_token

Google Chat

{
  "channel": {
    "type": "googlechat",
    "target": "https://chat.googleapis.com/v1/spaces/..."
  }
}

Generic Webhook

{
  "channel": {
    "type": "webhook",
    "target": "https://your-api.com/webhook"
  }
}

Console Only

{
  "channel": {
    "type": "console",
    "target": null
  }
}

Environment Variables

Schedule (Cron)

Windows Task Scheduler:

• Program: python
• Arguments: scripts/cny_rate.py
• Schedule: Mon-Fri 9:00-16:00 hourly

Linux/macOS Cron:

# Every hour, Mon-Fri, 9AM-4PM
0 9-16 * * 1-5 cd /path/to/skill && python scripts/cny_rate.py

Formula Details

Data Sources

• Bank of Taiwan: https://rate.bot.com.tw/xrt
• Prairie Grasslands Calculator: https://78lion.com/CNY.html

Files

• scripts/cny_rate.py - Main calculator script
• config.json - Configuration (formula, channel settings)
• scripts/run.bat - Windows runner
• scripts/run.sh - Linux/macOS runner

Troubleshooting

"Channel configuration required" error

• The skill couldn't auto-detect your channel
• Edit config.json and set a valid channel.type and channel.target
• Run python scripts/cny_rate.py --setup to see all options

Auto-detection not working

• Make sure your OpenClaw configuration is in standard locations:
  • ~/.openclaw/config.json
  • %APPDATA%/openclaw/config.json (Windows)
  • %LOCALAPPDATA%/openclaw/config.json (Windows)
• Or set environment variables directly

Telegram not working

• Verify TELEGRAM_BOT_TOKEN is set
• Make sure the bot is added to the chat and has permission to send messages

Signal/WhatsApp/iMessage/IRC not working

• These require OpenClaw Gateway
• Set OPENCLAW_GATEWAY_TOKEN environment variable
• Verify your OpenClaw Gateway is running