A specialized monitoring tool for the Citrea L2 network that tracks arbitrage opportunities, DEX liquidity, and wallet activity via a command-line interface.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install citrea-claw-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install citrea-claw-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Citrea Claw Skill?
The Citrea Claw Skill is a technical extension designed for Openclaw Skills users who need real-time visibility into the Citrea L2 ecosystem. It provides direct access to on-chain data, allowing users to query token prices, pool liquidity, and transaction history without relying on third-party aggregators. By interacting directly with Citrea mainnet RPCs and RedStone oracles, it ensures data integrity and low-latency updates.
This skill excels at identifying market inefficiencies between major decentralized exchanges like JuiceSwap and Satsuma. With integrated Telegram notification support, developers and traders can automate their market research and receive instant alerts when profitable arbitrage spreads or new liquidity pools appear on the network.
Citrea Claw Skill Use Cases
- Scanning for profitable arbitrage opportunities between JuiceSwap and Satsuma DEXs.
- Monitoring real-time token prices for wcBTC, ctUSD, and bridged assets on Citrea L2.
- Tracking wallet balances and recent transaction history for specific on-chain addresses.
- Identifying newly created liquidity pools to find early-stage farming or trading opportunities.
- Auditing pool depth and TVL to assess slippage before executing large swaps.
How Citrea Claw Skill Works
- The user provides a natural language prompt or specific command to the AI agent.
- The skill executes a Node.js script located in the local Openclaw Skills directory.
- The script connects to the Citrea mainnet RPC (
[https://rpc.mainnet.citrea.xyz](https://rpc.mainnet.citrea.xyz)) to fetch live blockchain data. - For price queries, the skill pulls data from RedStone push oracles deployed on-chain.
- The tool processes the raw blockchain data to calculate spreads, balances, or liquidity metrics.
- Results are returned to the user interface and, if configured, an alert is dispatched via the Telegram Bot API.
Citrea Claw Skill Setup
To install the Citrea monitoring capabilities within your Openclaw Skills environment, execute the following commands:
git clone https://github.com/jason-chew/citrea-claw-skill.git ~/.openclaw/skills/citrea-claw-skill
cd ~/.openclaw/skills/citrea-claw-skill
npm install
cp .env.example .env
After installation, configure your .env file with your TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, and preferred ARB_ALERT_THRESHOLD_BPS to enable automated notifications.
Citrea Claw Skill Data Schema & Taxonomy
The skill manages its operations using a structured environment configuration and outputs data in a standardized format:
| Feature | Data Source / Format |
|---|---|
| Network | Citrea Mainnet (RPC) |
| Oracles | RedStone Push Oracles |
| DEX Support | Uniswap V3 (JuiceSwap), Algebra (Satsuma) |
| Assets | wcBTC, ctUSD, USDC.e, USDT.e, WBTC.e, JUSD, GUSD |
| Logging | CLI Standard Output |
| Alerts | Telegram JSON Bot API |
Configuration is stored in a .env file within the skill directory, managing thresholds for basis points (BPS) and scan intervals.
Citrea Claw Skill Advanced Features
- Custom Arbitrage Thresholds: Define specific basis point (BPS) triggers to filter out low-margin trades.
- Automated Telegram Alerts: Direct integration for real-time push notifications on market movements.
- Cross-DEX Comparison: Logic to compare fee tiers (0.05%, 0.30%, 1.00%) across different protocol implementations.
- Debounce Logic: Configurable cool-down periods to prevent notification spam for the same arbitrage pair.
- Historical Analysis: Retrieve transaction and pool data for specific time windows (e.g., last 24 hours).
SKILL.md
Loading
Related Openclaw Skills
Fund Weekly Report Generator
Automatically generates comprehensive fund performance weekly reports in Word format from multi-sheet Excel data.
Obsidian
A powerful integration for managing Obsidian vaults, allowing AI agents to automate note creation, search content, and refactor Markdown structures.
Moralis OpenAPI Skill
A specialized interface for querying EVM wallet balances, history, and token intelligence through the Moralis API and the uxc CLI.
Perplexity Agent Search
A powerful research skill that leverages the Perplexity Agent API to provide AI agents with real-time web search capabilities and cited answers.
Browsh Text Browser
A sophisticated text-based browser that renders full web pages, including video and rich media, directly within your terminal using headless Firefox.
Agent Security Questions
A professional framework for collecting, analyzing, and transforming AI Agent operational issues into actionable research topics.
Featured*
