ClawBack

Mirror congressional stock trades with automated broker execution

Agent Instructions

When the user invokes /clawback, execute the appropriate command based on the argument:

Commands

When the user invokes /clawback with any arguments, execute the corresponding command:

Command	Action
INLINECODE2	Run the setup wizard: Execute INLINECODE3
INLINECODE4

Check system status: Execute {baseDir}/bin/clawback.py status |
| /clawback run | Start trading bot: Execute {baseDir}/bin/clawback.py run |
| /clawback daemon | Run as background service: Execute {baseDir}/bin/clawback.py daemon |
| /clawback test | Test notifications: Execute {baseDir}/bin/clawback.py test |
| /clawback (no args) | Show help: Execute {baseDir}/bin/clawback.py --help |

How to Execute Commands

Option 1: Using the wrapper script (recommended)
When executing ClawBack commands, always:

1. 1. Use the wrapper script at INLINECODE14
2. Pass the command as an argument (e.g., {baseDir}/bin/clawback.py status)
3. Capture and display the output to the user

Option 2: Direct Python execution (if wrapper doesn't work)
If the wrapper script fails, you can run ClawBack directly:

1. 1. Change to the skill directory: INLINECODE16
2. Activate the virtual environment: INLINECODE17
3. Run the CLI: INLINECODE18
4. Capture and display the output

Important: Always check if the virtual environment exists at {baseDir}/venv. If not, you may need to run the setup first.

/clawback setup - Interactive Setup Flow

When user runs /clawback setup, follow these steps:

Step 1: Install dependencies (if needed)
Check if {baseDir}/venv exists. If not, run:
CODEBLOCK0

Step 2: Prompt for E*TRADE credentials
Ask the user for each value:

1. 1. Environment: Ask "Do you want to use sandbox (testing) or production (real money)?"

- Default: sandbox

1. 2. Consumer Key: Ask "Enter your E*TRADE Consumer Key (from developer.etrade.com):"

- Required field

1. 3. Consumer Secret: Ask "Enter your E*TRADE Consumer Secret:"

- Required field

1. 4. Account ID: Ask "Enter your E*TRADE Account ID (or leave blank to get it after OAuth):"

- Optional - can be obtained later

Step 3: Save configuration
Create/update ~/.clawback/config.json with the provided values:
CODEBLOCK1

Step 4: Confirm setup
Tell the user: "Configuration saved to ~/.clawback/config.json. Run /clawback status to verify."

Getting E*TRADE API Credentials

Direct user to: https://developer.etrade.com

1. 1. Create a developer account
2. Create a new app (sandbox first for testing)
3. Copy the Consumer Key and Consumer Secret

Configuration Location

• - Config file: INLINECODE25
• Skill directory: INLINECODE26

Reading Saved Configuration

To check if the user has configured credentials, read ~/.clawback/config.json:

• - If file doesn't exist or credentials are empty → prompt for setup
• If credentials exist → can proceed with status/run commands

The CLI automatically reads from ~/.clawback/config.json for all operations.

Checking Setup Status

Before running /clawback status or /clawback run, verify:

1. 1. {baseDir}/venv exists (dependencies installed)
2. INLINECODE32 exists with non-empty INLINECODE33

If either is missing, suggest running /clawback setup first.

---

ClawBack tracks stock trades disclosed by members of Congress (House and Senate) and executes scaled positions in your E*TRADE brokerage account. Built on the premise that congressional leaders consistently outperform the market due to informational advantages.

Default Target Politicians

ClawBack monitors these politicians by default (configurable):

Politician	Chamber	Priority
Nancy Pelosi	House	1 (highest)
Dan Crenshaw

House | 2 |
| Tommy Tuberville | Senate | 2 |
| Marjorie Taylor Greene | House | 3 |

Trading Strategy Defaults

Parameter	Default	Description
Trade Delay	3 days	Wait after disclosure before trading
Holding Period

30 days | Target hold time for positions | | Position Size | 5% | Max allocation per trade | | Stop-Loss | 8% | Per-position stop-loss | | Portfolio Drawdown | 15% | Max portfolio loss before halt | | Disclosure Checks | 10:00, 14:00, 18:00 ET | Daily check times |

Features

• - Real-time disclosure tracking from official House Clerk and Senate eFD sources
• Automated trade execution via E*TRADE API (only supported broker)
• Smart position sizing - scales trades to your account size
• Trailing stop-losses - lock in profits, limit losses
• Risk management - drawdown limits, consecutive loss protection
• Telegram notifications - get alerts for new trades and stop-losses
• Backtesting engine - test strategies on historical data

Performance (Backtest Results)

Strategy	Win Rate	Return	Sharpe
3-day delay, 30-day hold	42.9%	+6.2%	0.39
9-day delay, 90-day hold

57.1% | +4.7% | 0.22 |

Congressional leaders have outperformed the S&P 500 by 47% annually according to NBER research.

Installation via ClawHub

CODEBLOCK2

Troubleshooting

Common Issues

1. 1. Skill not executing: If /clawback doesn't work in OpenClaw:

- Check if the skill is in the correct location: {baseDir}/ - Verify the wrapper script is executable: chmod +x {baseDir}/bin/clawback.py - Check if virtual environment exists: INLINECODE38

1. 2. Authentication issues: If E*TRADE authentication fails:

- Run the authentication utility: python {baseDir}/scripts/auth_utility.py --auth - Run {baseDir}/bin/clawback.py setup to reconfigure - Check credentials in ~/.clawback/config.json - Verify E*TRADE API keys are valid

1. 3. Token expiration: If tokens expire (30-day lifespan):

- Run: python {baseDir}/scripts/auth_utility.py --refresh - Or start new authentication: INLINECODE43

1. 4. Python import errors: If you see "ModuleNotFoundError":

- Ensure virtual environment is activated - Run pip install -e . in {baseDir}/ - Check Python path includes INLINECODE46

Debug Mode

To debug skill execution, add DEBUG=1 environment variable:
CODEBLOCK3

This will show additional information about the execution context.

Post-Installation Setup

After installation via ClawHub, the install.sh script runs automatically:

1. 1. Python Environment Setup - Creates virtual environment
2. Package Installation - Installs ClawBack via pip
3. Directory Structure - Creates logs/, data/, config/ directories
4. Setup Prompt - Asks if you want to run the setup wizard

If you skip setup during installation, run it manually:
CODEBLOCK4

Improved Setup Features

• - Better input handling - Works in both interactive and non-interactive modes
• Input validation - Validates E*TRADE API key formats
• Timeout handling - Automatically uses defaults if no input
• Error recovery - Fallback to manual setup if CLI fails
• Configuration check - Detects existing config and offers options

Interactive Setup Wizard

The setup wizard guides you through configuration:

Step 1: Environment Selection

• - Sandbox (recommended for testing): No real trades, uses E*TRADE developer sandbox
• Production: Real trading with real money

Step 2: E*TRADE API Credentials

• - Consumer Key: From ETRADE developer portal
• Consumer Secret: From ETRADE developer portal

Step 3: Authentication

• - Automatic OAuth flow with E*TRADE
• Opens browser for authorization
• Returns verification code

Step 4: Account Selection

• - Lists all available E*TRADE accounts
• Choose which account to trade with

Step 5: Telegram Setup (Optional)

• - Configure notifications via Telegram bot
• Uses OpenClaw's built-in Telegram channel if available

Environment Variables

After setup, credentials are stored in .env:

CODEBLOCK5

Usage

CODEBLOCK6

Automated Trading

The clawback daemon command runs continuously with:

• - Disclosure checks at 10:00, 14:00, 18:00 ET (when filings are typically released)
• Trade execution at 9:35 AM ET (5 min after market open)
• Token refresh every 90 minutes (keeps E*TRADE session alive)
• Market hours enforcement (9:30 AM - 4:00 PM ET)

Data Sources

• - House Clerk: https://disclosures-clerk.house.gov (PDF parsing)
• Senate eFD: https://efdsearch.senate.gov (web scraping)
• Financial Modeling Prep: Enhanced financial data (optional)

Supported Brokers

ClawBack currently only supports ETRADE. The adapter pattern allows for future broker support, but only ETRADE is implemented and tested.

Broker	Adapter	Status
E*TRADE	INLINECODE51	Supported

Risk Management

• - Position limits: 5% max per symbol, 20 positions max
• Stop-losses: 8% per position, 15% portfolio drawdown
• Daily limits: 3% max daily loss
• PDT compliance: Conservative 2 trades/day limit

Authentication Helpers

For manual E*TRADE authentication outside the main CLI:

CODEBLOCK7

This generates an authorization URL, prompts for the verification code, and completes authentication.

File Locations

File	Purpose
INLINECODE52	Main configuration
INLINECODE53

E*TRADE OAuth tokens | | ~/.clawback/data/trading.db | SQLite database |

Security

• - No hardcoded credentials in source code
• Environment variable based configuration
• Encrypted token storage for E*TRADE
• Git-ignored .env file
• Optional production encryption

Support

• - Documentation: See README.md for detailed setup
• Issues: https://github.com/mainfraame/clawback/issues
• Community: https://discord.com/invite/clawd

Disclaimer

Trading involves substantial risk of loss. This software is for educational purposes only. Past congressional trading performance does not guarantee future results. Always test with E*TRADE sandbox accounts before live trading.