🚀 OpenClaw Trading Assistant

Version: v1.5.0 (2026-03-26)
Author: OpenClaw Community
License: MIT

📚 Docs Website • Features • Installation • Usage

🌐 Language / 语言

📖 Introduction

OpenClaw Trading Assistant is a complete trading decision support system that provides technical analysis, trading signals, position management, and risk monitoring.

✨ Key Features

📊 Support & Resistance Levels - Automatic calculation with multiple algorithms
📈 Trading Signals - Multi-indicator analysis (RSI, MACD, Moving Averages)
💰 Position Calculator - Risk-based position sizing
🎯 Stop Loss & Take Profit - Price alerts and trigger detection
⚠️ Risk Management - Risk/Reward ratio, potential profit/loss
🔔 Notifications - Feishu, DingTalk, Email (configurable)

🎯 Perfect For

Stock/ETF investors
Technical analysis enthusiasts
Quantitative trading beginners
OpenClaw users

✨ Features

1. Support & Resistance Levels

Automatic calculation of key price levels
Multiple algorithms: Previous High/Low, Moving Averages, Fibonacci, Pivot Points
Strength indicator (strong/medium/weak)

Example Output:

NVDA Current Price: $175.64
Resistance: $177.26 (+0.9%), $180.00 (+2.5%)
Support: $175.00 (-0.4%), $171.72 (-2.2%)

2. Trading Signals

Multi-indicator analysis (RSI, MACD, Moving Averages)
Combined signal scoring
Recommendations: Strong Buy / Buy / Hold / Sell / Strong Sell

Example Output:

RSI: 52.34 [Neutral]
MACD: 0.1234 [Bullish]
Moving Averages: [Bullish]
Combined: Bullish (score: 3)
Recommendation: BUY (Confidence: Medium)

3. Position Calculator

Risk-based position sizing
Risk profiles: Conservative / Moderate / Aggressive
Confidence adjustment
Stop-loss calculation
Portfolio allocation

Example Output:

Total Capital: $100,000
Entry Price: $175.64
Stop Loss: $165.00
Risk Profile: Moderate

Position: 562 shares ($98,710, 98.7%)
Risk: $5,964 (5.96%)
Risk/Reward: 1:2.0

🛠️ Installation

📚 Complete guides: https://xuxuclassmate.github.io/trading-assistant/guides/install-overview/

Quick Comparison

Method	Command	Time
Docker ⭐	`docker run -it ghcr.io/xuxuclassmate/trading-assistant:latest`	5 min
pip	`pip install trading-assistant`	10 min
npm	`npm install -g @xuxuclassmate/trading-assistant`	10 min
Source	`git clone + pip install -e .`	15 min

Prerequisites

Twelve Data API Key (Get Free - 800 calls/day)
Alpha Vantage API Key (Get Free - 25 calls/day)

🐳 Docker Installation (Recommended)

Pull from GitHub Container Registry:

docker pull ghcr.io/xuxuclassmate/trading-assistant:latest

Pull from Docker Hub:

docker pull xuxuclassmate/trading-assistant:latest

Quick Start:

# Create config directory
mkdir -p trading-assistant-config
cd trading-assistant-config

# Download example config
curl -O https://raw.githubusercontent.com/XuXuClassMate/trading-assistant/main/.env.example
cp .env.example .env

# Edit .env with your API keys
nano .env  # or use your favorite editor

# Run the container
docker run --rm -it \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/watchlist.txt:/app/watchlist.txt \
  ghcr.io/xuxuclassmate/trading-assistant:latest \
  --help

Available Images:

ghcr.io/xuxuclassmate/trading-assistant:1.0.3 - Specific version
ghcr.io/xuxuclassmate/trading-assistant:latest - Latest stable
xuxuclassmate/trading-assistant:1.0.3 - Docker Hub (versioned)
xuxuclassmate/trading-assistant:latest - Docker Hub (latest)

Supported Platforms: linux/amd64, linux/arm64

🖥️ CLI Usage

🚀 Quick Start

# Start interactive mode (short & sweet!)
ta

# Full name also works
trading-assistant

📋 Available Commands

Command	Example	Description
`ta`	`ta`	Start interactive mode / 交互模式
`ta sr`	`ta sr`	Analyze support/resistance / 分析支撑阻力位
`ta sig`	`ta sig --symbol NVDA`	Generate signals / 生成信号
`ta pos`	`ta pos --symbol NVDA --price 175 --capital 10000`	Calculate position / 计算仓位
`ta alerts`	`ta alerts check`	Manage alerts / 管理提醒
`ta all`	`ta all`	Run all analysis / 运行所有分析
`ta v`	`ta v`	Show version / 显示版本
`ta h`	`ta h`	Show help / 显示帮助

💡 Examples

Interactive Mode:

$ ta

============================================================
  OpenClaw Trading Assistant CLI
  Version: 1.0.3
============================================================

ta> help
ta> sig
ta> pos --symbol NVDA --price 175.64 --capital 10000
ta> exit

Direct Commands:

ta sr                      # Support/Resistance
ta sig                     # Signals for watchlist
ta sig --symbol NVDA       # Signals for specific stock
ta pos --symbol NVDA --price 175.64 --capital 10000
ta alerts check
ta all                     # Run everything

🐳 Docker CLI Usage

# Interactive mode in Docker
docker run --rm -it \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/watchlist.txt:/app/watchlist.txt \
  ghcr.io/xuxuclassmate/trading-assistant:latest

# Direct command in Docker
docker run --rm -it \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/watchlist.txt:/app/watchlist.txt \
  ghcr.io/xuxuclassmate/trading-assistant:latest \
  ta sig

🌍 Internationalization

Default Language: English (en)

Switch Language:

# Method 1: Environment Variable
export TRADING_ASSISTANT_LANG=zh_CN

# Method 2: In Code
from i18n import set_language
set_language("zh_CN")

# Method 3: Config File
# Add to config.json: {"language": "zh_CN"}

Supported Languages:

English (en) - Default
Chinese Simplified (zh_CN)

📚 See I18N Documentation

⚙️ Configuration

Required

API Keys - Twelve Data & Alpha Vantage
Watchlist - Your stock list

Optional

Notifications - Feishu, DingTalk, Email (leave empty to disable)
Risk Profile - Conservative/Moderate/Aggressive
Language - English/Chinese

📚 See Full Configuration Guide

📖 Usage

Basic Usage

# Support & Resistance
from support_resistance import calculate_support_resistance
result = calculate_support_resistance("NVDA")

# Trading Signals
from trading_signals import generate_trading_signal
result = generate_trading_signal("AAPL")

# Position Calculation
from position_calculator import calculate_position_size
result = calculate_position_size(
    total_capital=100000,
    entry_price=175.64,
    stop_loss_price=165.00,
    risk_profile="moderate"
)

📚 See Full Usage Guide

📁 Project Structure

trading-assistant/
├── config.py                    # Configuration
├── i18n.py                      # Internationalization
├── support_resistance.py        # Support/Resistance (Day 1)
├── trading_signals.py           # Trading Signals (Day 1)
├── position_calculator.py       # Position Calculator (Day 1)
├── stop_loss_alerts.py          # Stop Loss & Take Profit (Day 2)
├── locales/
│   ├── en.json                  # English translations
│   └── zh_CN.json               # Chinese translations
├── data/
│   └── alerts/                  # Alert persistence (JSON)
├── logs/                        # Log files
├── docs/
│   ├── I18N.md                  # i18n documentation
│   ├── CONFIGURATION.md         # Configuration guide
│   ├── PUBLISHING.md            # Package publishing guide
│   └── V1.1.0_SUCCESS.md        # v1.1.0 release summary
├── .github/
│   └── workflows/
│       ├── publish.yml          # Auto-publish workflow
│       └── publish-gh.yml       # GitHub Packages workflow
├── scripts/                     # Utility scripts
├── requirements.txt             # Dependencies
├── pyproject.toml               # Python package config
├── .env.example                 # Environment template
├── watchlist.txt.example        # Watchlist template
├── LICENSE                      # MIT License
├── README.md                    # This file (English)
└── README_zh.md                 # Chinese version

🧪 Testing

# Test all modules
python3 support_resistance.py
python3 trading_signals.py
python3 position_calculator.py

# Run unit tests
python3 -m pytest tests/

📊 Version History

v1.1.0 (2026-03-24) - Stop Loss & Take Profit Alerts

New Features:

✅ Stop Loss & Take Profit alert system
✅ Automatic price trigger detection
✅ Risk/Reward ratio calculation
✅ Potential profit/loss estimation
✅ JSON-based alert persistence
✅ Detailed logging

Files Added:

stop_loss_alerts.py - Alert management module
data/alerts/ - Alert data storage
logs/ - Log file directory

Usage Example:

from stop_loss_alerts import StopLossAlert, calculate_stop_loss_levels

# Calculate levels
levels = calculate_stop_loss_levels(
    entry_price=175.64,
    stop_loss_percent=5.0,
    take_profit_percent=10.0
)

# Create alert
alert = StopLossAlert("NVDA", 175.64)
alert.create_alert(
    entry_price=175.64,
    stop_loss_price=levels['stop_loss_price'],
    take_profit_price=levels['take_profit_price'],
    shares=100
)

v1.0.0 (2026-03-24) - Initial Release

Features:

✅ Support & Resistance calculation
✅ Trading signal generation (RSI, MACD, MA)
✅ Position size calculator
✅ Multi-language support (EN/ZH)
✅ Configurable notifications
✅ Portfolio allocation

📚 See Full Release Notes

⚠️ Disclaimer

This software is for educational and research purposes only. It does not constitute investment advice.

Trading involves substantial risk
Past performance does not guarantee future results
Users should make independent decisions and bear their own risks
The developers are not liable for any investment losses

🤝 Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

📚 Documentation

📖 README_CLAWHUB.md - Detailed guide
🌍 docs/I18N.md - Internationalization guide
⚙️ docs/CONFIGURATION.md - Configuration guide
📝 CHANGELOG.md - Version history
❓ FAQ.md - Frequently asked questions

🙏 Acknowledgments

Thanks to these open-source projects:

OpenClaw - AI assistant framework
Twelve Data - Financial market data API
Alpha Vantage - Stock/Forex data API
ClawHub - OpenClaw skills community

📬 Contact

GitHub: https://github.com/XuXuClassMate/trading-assistant
Issues: https://github.com/XuXuClassMate/trading-assistant/issues
ClawHub: https://clawhub.com

Made with ❤️ by OpenClaw Community

📖 Documentation • 🐛 Report Issue • ⭐ Star Project

Last Updated: 2026-03-24 14:05 UTC
Version: v1.1.0

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
.github		.github
docs		docs
locales		locales
reports		reports
scripts		scripts
sent		sent
site		site
tests		tests
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
.npmignore		.npmignore
ACCURACY_TRACKING.md		ACCURACY_TRACKING.md
BUILD_SUCCESS_v2.0.0.md		BUILD_SUCCESS_v2.0.0.md
CHANGELOG.md		CHANGELOG.md
CLAWHUB_SUBMISSION.md		CLAWHUB_SUBMISSION.md
CLAWHUB_SUBMISSION_FINAL.md		CLAWHUB_SUBMISSION_FINAL.md
CLAWHUB_UPLOAD_INSTRUCTIONS.md		CLAWHUB_UPLOAD_INSTRUCTIONS.md
CLAWHUB_UPLOAD_READY.md		CLAWHUB_UPLOAD_READY.md
COST_FIX_EXPLANATION.md		COST_FIX_EXPLANATION.md
DOCKERHUB_README.md		DOCKERHUB_README.md
Dockerfile		Dockerfile
FINAL_BUILD_NOTES.md		FINAL_BUILD_NOTES.md
GITHUB_ACTIONS_MULTI_BUILD.md		GITHUB_ACTIONS_MULTI_BUILD.md
GITHUB_ACTIONS_SETUP.md		GITHUB_ACTIONS_SETUP.md
GITHUB_RELEASE_INSTRUCTIONS.md		GITHUB_RELEASE_INSTRUCTIONS.md
LICENSE		LICENSE
NPM_PUBLISH_STATUS.md		NPM_PUBLISH_STATUS.md
NPM_TOKEN_GUIDE.md		NPM_TOKEN_GUIDE.md
OPTIMIZATION_REPORT.md		OPTIMIZATION_REPORT.md
PREDICTION_OPTIMIZATION.md		PREDICTION_OPTIMIZATION.md
PROJECT_PLAN.md		PROJECT_PLAN.md
PUBLISH_GUIDE.md		PUBLISH_GUIDE.md
PUSH_COMPLETE.md		PUSH_COMPLETE.md
README.md		README.md
README_CLAWHUB.md		README_CLAWHUB.md
README_en.md		README_en.md
README_zh.md		README_zh.md
REBUILD_NOTES.md		REBUILD_NOTES.md
RE_PUSH_COMPLETE.md		RE_PUSH_COMPLETE.md
SCHEDULE.md		SCHEDULE.md
SECURITY_FIXES.md		SECURITY_FIXES.md
SECURITY_FIXES_v2.0.0.md		SECURITY_FIXES_v2.0.0.md
SECURITY_FIX_SUMMARY.md		SECURITY_FIX_SUMMARY.md
SETUP_COMPLETE.md		SETUP_COMPLETE.md
SKILL.md		SKILL.md
SUBMISSION_READY.md		SUBMISSION_READY.md
UPLOAD_INSTRUCTIONS_v2.0.0.md		UPLOAD_INSTRUCTIONS_v2.0.0.md
__init__.py		__init__.py
a_stock_data.py		a_stock_data.py
accuracy_tracker.py		accuracy_tracker.py
advanced_indicators.py		advanced_indicators.py
backtest_engine_v2.py		backtest_engine_v2.py
build_clawhub.sh		build_clawhub.sh
cli.js		cli.js
cli.py		cli.py
config.py		config.py
create_upload_tarball.sh		create_upload_tarball.sh
daily_report.py		daily_report.py
i18n.py		i18n.py
live_trading_interface.py		live_trading_interface.py
mkdocs.yml		mkdocs.yml
news_sentiment_monitor.py		news_sentiment_monitor.py
optimizer.py		optimizer.py
package.json		package.json
portfolio_manager.py		portfolio_manager.py
position_calculator.py		position_calculator.py
position_cost_analyzer.py		position_cost_analyzer.py
pyproject.toml		pyproject.toml
quantitative_cost_analyzer.py		quantitative_cost_analyzer.py
quantitative_entry_alert.py		quantitative_entry_alert.py
quantitative_strategies.py		quantitative_strategies.py
realtime_monitor.py		realtime_monitor.py
requirements.txt		requirements.txt
setup_holdings.py		setup_holdings.py
stop_loss_alerts.py		stop_loss_alerts.py
support_resistance.py		support_resistance.py
trading-assistant-v2.0.0-clawhub.tar.gz		trading-assistant-v2.0.0-clawhub.tar.gz
trading_signals.py		trading_signals.py
version_manager.py		version_manager.py
xuxuclassmate-openclaw-trading-assistant-1.3.1.tgz		xuxuclassmate-openclaw-trading-assistant-1.3.1.tgz
上传说明.md		上传说明.md
修复完成报告.md		修复完成报告.md
安全优化完成.md		安全优化完成.md

Folders and files

Latest commit

History

Repository files navigation

🚀 OpenClaw Trading Assistant

🌐 Language / 语言

📖 Introduction

✨ Key Features

🎯 Perfect For

✨ Features

1. Support & Resistance Levels

2. Trading Signals

3. Position Calculator

🛠️ Installation

Quick Comparison

Prerequisites

🐳 Docker Installation (Recommended)

🖥️ CLI Usage

🚀 Quick Start

📋 Available Commands

💡 Examples

🐳 Docker CLI Usage

🌍 Internationalization

⚙️ Configuration

Required

Optional

📖 Usage

Basic Usage

📁 Project Structure

🧪 Testing

📊 Version History

v1.1.0 (2026-03-24) - Stop Loss & Take Profit Alerts

v1.0.0 (2026-03-24) - Initial Release

⚠️ Disclaimer

🤝 Contributing

📚 Documentation

🙏 Acknowledgments

📬 Contact

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 8

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages