A comprehensive AI finance assistant providing real-time market data, technical analysis, and portfolio tracking across stocks, crypto, and forex.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install finclaw
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 finclaw 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 FinClaw?
FinClaw is a robust financial intelligence suite designed for Openclaw Skills that empowers AI agents to perform complex market analysis and portfolio management. It bridges the gap between raw market data and actionable insights by supporting US equities, the Turkish stock market (BIST), global cryptocurrencies via Binance, and international forex pairs.
This skill is built for developers who need a reliable, local-first financial toolkit. It leverages powerful Python libraries like pandas and matplotlib to generate technical indicators and professional-grade charts without relying solely on expensive third-party subscriptions. With FinClaw, your AI agent becomes a personal quantitative analyst capable of tracking PnL, monitoring sentiment, and delivering scheduled market briefings.
FinClaw Use Cases
- Tracking real-time price quotes and market movements for diversified portfolios including US and BIST stocks.
- Generating visual candlestick and line charts with technical overlays like SMA, EMA, and Bollinger Bands.
- Automating price alerts and volatility monitoring for crypto and forex trading.
- Conducting deep research on company earnings, macro-economic indicators, and news sentiment.
- Managing investment positions with detailed profit and loss (PnL) reporting and fee tracking.
How FinClaw Works
- The user or agent triggers a specific financial command through Openclaw Skills, such as fetching a quote or generating a chart.
- The skill's symbol detection logic automatically identifies the asset class (e.g., identifying .IS for BIST stocks or slash-pairs for Forex).
- Data is fetched from optimized sources including Finnhub, yfinance, and Binance, utilizing a 60-second cache to ensure high performance.
- For technical analysis and charting, the skill processes raw data locally using a dedicated Python virtual environment to ensure privacy and speed.
- The output is delivered as formatted text, structured JSON, or image paths for visual representation within the chat interface.
FinClaw Setup
To initialize the environment and database, run the following command within the skill directory:
python3 {baseDir}/scripts/setup.py
Next, configure your openclaw.json with the necessary environment variables. Note that core features like quotes and charts work without keys, but advanced intelligence requires specific APIs:
"finclaw": {
"env": {
"FINNHUB_API_KEY": "your_key",
"FRED_API_KEY": "your_key",
"ALPHA_VANTAGE_API_KEY": "your_key",
"EXCHANGE_RATE_API_KEY": "your_key"
}
}
FinClaw Data Schema & Taxonomy
FinClaw organizes its operations across several data structures to maintain state and provide historical context:
| Module | Data Type | Description |
|---|---|---|
| Portfolio | Position Ledger | Tracks symbols, shares, purchase prices, fees, and custom notes. |
| Alerts | Condition Logic | Stores price targets, volume triggers, and alert statuses (active/snoozed). |
| Watchlist | Grouped Assets | Organizes symbols into named collections for quick batch pricing. |
| Analytics | Technical Metadata | Computes and returns RSI, MACD, and signal data in JSON format. |
| Media | Image Assets | Generates PNG files for charts stored in the local project directory. |
FinClaw Advanced Features
- Multi-market support covering US, BIST, Crypto (Binance), and Forex via ExchangeRate-API.
- Automated market briefings (Morning, Close, Weekend) for high-level summaries using Openclaw Skills intelligence.
- Sophisticated technical analysis engine with buy/sell signal generation based on momentum indicators.
- Macro-economic dashboard integration via FRED (Federal Reserve Economic Data).
- Deep research module that synthesizes news sentiment, earnings calendars, and historical performance.
SKILL.md
Loading
Related Openclaw Skills
Finance Tracker v2.0
A robust command-line personal finance manager featuring multi-currency support, automated subscription tracking, and AI-driven spending insights.
PeonPing Alerts
An automated configuration skill for PeonPing that adds instant audio alerts and voice notifications to your coding workflows.
Diddy Party Persona
A theatrical hip-hop party-host persona that rebrands the assistant experience with specialized crew member aliases and high-energy slang.
Gold Investment Analyst
A comprehensive AI agent providing structured real-time gold market analysis, price tracking, and strategic investment advice.
OpenClaw Documentation Expert
A specialized skill for navigating, searching, and validating OpenClaw documentation and configurations with built-in errata tracking.
Poidh Bounty Agent Skill
An automated agent skill for managing on-chain "pics or it didn't happen" bounties and claims on Arbitrum, Base, and Degen Chain.
METADATA
Featured*
