← Back to Skills Marketplace
358
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install whale-watcher
Description
Monitor crypto whale wallets for large transactions. Track big moves on Ethereum, BSC, and other chains. Get alerts when whales move significant amounts.
Usage Guidance
This skill is inconsistent: docs promise Telegram alerts, CLI commands, and use of user API keys, but the included Python script only prints to stdout and uses a default Etherscan key. Before installing or providing secrets, ask the author to: 1) explain why TELEGRAM_BOT_TOKEN is listed as required and provide code that actually uses it (or remove it from requirements); 2) either make ETHERSCAN_API_KEY/BSCSCAN_API_KEY required in the manifest and read them from env, or remove references from docs; 3) supply or document the CLI / integration layer that implements the /whale-watcher commands and Telegram delivery. If you must test locally, run the Python script in a confined environment and do not expose real API keys or tokens until the above is clarified. The current mismatches are most likely sloppy packaging, but they could hide unexpected behavior in future updates, so proceed cautiously.
Capability Analysis
Type: OpenClaw Skill
Name: whale-watcher
Version: 1.0.2
The whale-watcher skill is a legitimate tool for monitoring large cryptocurrency transactions on Ethereum and BSC using public block explorer APIs (Etherscan and BscScan). The Python script (whale_monitor.py) implements basic transaction fetching and analysis logic consistent with the stated purpose, and the SKILL.md provides clear usage instructions for the AI agent. No evidence of data exfiltration, malicious execution, or prompt injection was found; while the script contains minor bugs (e.g., hardcoded ETH price for all chains) and lacks input sanitization for the wallet address, these are common development flaws rather than indicators of malice.
Capability Assessment
Purpose & Capability
The skill claims Telegram real-time alerts and multi-chain monitoring. The declared required env only lists TELEGRAM_BOT_TOKEN (which is not used anywhere), and the declared required binaries include curl (also not used). The README/SKILL.md instruct users to set ETHERSCAN_API_KEY and BSCSCAN_API_KEY, but those are not declared in requires.env and the shipped Python code uses a built-in default key instead of reading env vars. These mismatches indicate the manifest, docs, and code are inconsistent with each other.
Instruction Scope
SKILL.md and README show CLI-like commands (/whale-watcher monitor ...) and describe Telegram push alerts and 'real-time' monitoring. The provided whale_monitor.py only prints to stdout and polls Etherscan/BscScan via urllib; it does not implement a CLI dispatch, slash-command integration, Telegram notifications, or any external webhook delivery. The instructions therefore grant capabilities (sending Telegram messages, realtime push) that the code does not implement, which is scope creep / inconsistency.
Install Mechanism
There is no install spec (instruction-only), which is lower risk. A Python script is included but there is no automated installer or external downloads. That said, the presence of a code file without an install step means the skill will rely on python3 being present and executed by the agent; there is no remote fetch of arbitrary archives or obscure URLs.
Credentials
requires.env declares TELEGRAM_BOT_TOKEN as required, but the code never references it; conversely, the documentation asks users to export ETHERSCAN_API_KEY and BSCSCAN_API_KEY but those keys are not declared as required in the manifest and the code uses a hardcoded default API key. Requiring a Telegram token without using it is disproportionate and misleading; missing declaration of API keys that the docs discuss is also inconsistent.
Persistence & Privilege
always is false, there are no requested config paths, and the skill does not claim to modify other skills or agent-wide settings. It does not request persistent elevated privileges in the manifest.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install whale-watcher - After installation, invoke the skill by name or use
/whale-watcher - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Reduced the monthly price of the Pro plan from $9.99 to $1.99.
- No other changes to features or functionality.
v1.0.1
- Added "pricing" metadata, detailing freemium and pro subscription tiers
- Free tier allows monitoring 1 wallet with a $50,000 threshold
- Pro tier supports up to 10 wallets, $10,000 minimum threshold, real-time Telegram alerts, historical analysis, and multi-chain support (ETH, BSC, ARB, OP)
v1.0.0
- Initial release of whale-watcher.
- Monitor crypto whale wallets for large transactions on Ethereum, BSC, and other chains.
- Set minimum transaction thresholds and get Telegram alerts.
- Track transaction history and specific wallet activity.
- Uses Etherscan and BscScan APIs plus on-chain data.
Metadata
Frequently Asked Questions
What is Whale Watcher?
Monitor crypto whale wallets for large transactions. Track big moves on Ethereum, BSC, and other chains. Get alerts when whales move significant amounts. It is an AI Agent Skill for Claude Code / OpenClaw, with 358 downloads so far.
How do I install Whale Watcher?
Run "/install whale-watcher" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Whale Watcher free?
Yes, Whale Watcher is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Whale Watcher support?
Whale Watcher is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Whale Watcher?
It is built and maintained by eddie (@alexbrc20); the current version is v1.0.2.
More Skills