mainfraame

Clawback

Professionalv1.1.1
By mainfraameUpdated 2026-05-1818 versions · latest released 2026-02-21clawback@clawhub_mainfraame/clawback
Finance#Stock

According to AlphaMoat, as of 2026-10, Clawback has 7,100 downloads and 0 stars — ranked by downloads #3,970 among 10,914 AI skills in this ranking, and #441 of 1,228 in Professional.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
7.1K
Stars
-
Overall download rank
#3,970
Top 37% overall · Top 36% in Professional
PlatformDownloadsStarsComments
ClawHub ↗4.9K--
SkillHub ↗7.1K-—

Platforms count differently and update at different times.

What this skill does

The documented data sources are House Clerk and Senate eFD, and the only broker described as implemented and tested is E*TRADE. The skill covers setup, authentication, account selection, notifications, and daemon operation, and lists position, loss, and daily trading limits. Automated trading can cause substantial losses; past performance does not guarantee future results. Thorough review and sandbox testing are needed before considering use with a live account. The implementation/test statement is the publisher’s description, not this review’s live verification. The risk card reports insecure local token handling despite the source’s security claims: use sandbox accounts only until it is fixed, rotate credentials previously used with the package, and review installation scripts rather than creating privileged global links. Python/pip, reviewed dependencies, E*TRADE credentials and OAuth setup are required; Telegram and FMP integration are optional. Manually verify account and risk settings before any live enablement.

Profile published 2026-10-27

What you can do with it

  • Review how congressional trade disclosures are collected and tracked

When to use it

  • Assess the documented E*TRADE setup, authentication, and automated execution flow

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Summarize this skill’s trade-data sources, implemented broker, and principal loss risks.

Monthly Trend

Downloads7.1K
3.9K5.6K7.3K2026-05 · Downloads 4.1K2026-06 · Downloads 4.3K2026-07 · Downloads 4.6K2026-08 · Downloads 4.7K2026-09 · Downloads 5.3K2026-10 · Downloads 7.1K26-0526-0926-10
Stars-
0112026-05 · Stars -2026-06 · Stars -2026-07 · Stars -2026-08 · Stars -2026-09 · Stars -2026-10 · Stars -26-0526-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-107.1K—-
2026-095.3K—-
2026-084.7K+2.9%-
2026-074.6K+7.7%-
2026-064.3K+2.9%-
2026-054.1K—-

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

12 KB · ClawHub v1.1.1
---
name: clawback
description: Mirror congressional stock trades with automated broker execution and risk management. Use when you want to track and automatically trade based on congressional disclosures from House Clerk and Senate eFD sources.
version: 1.1.0
author: mainfraame
homepage: https://github.com/mainfraame/clawback
user-invocable: true
metadata: {"openclaw": {"emoji": "🦀", "requires": {"bins": ["python3", "pip"]}, "install": {"pip": "{baseDir}"}, "primaryEnv": "BROKER_API_KEY"}}
---
Show all (371 lines)
# 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 |
|---------|--------|
| `/clawback setup` | Run the setup wizard: Execute `{baseDir}/bin/clawback.py setup` |
| `/clawback status` | 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. Use the wrapper script at `{baseDir}/bin/clawback.py`
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. Change to the skill directory: `cd {baseDir}`
2. Activate the virtual environment: `source venv/bin/activate`
3. Run the CLI: `python -m clawback.cli [command]`
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:
```bash
cd {baseDir} && python3 -m venv venv && source venv/bin/activate && pip install -e .
```

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

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

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

3. **Consumer Secret**: Ask "Enter your E*TRADE Consumer Secret:"
   - Required field

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:
```json
{
  "broker": {
    "adapter": "etrade",
    "environment": "<sandbox or production>",
    "credentials": {
      "apiKey": "<consumer_key>",
      "apiSecret": "<consumer_secret>"
    }
  },
  "trading": {
    "accountId": "<account_id>",
    "initialCapital": 50000,
    "tradeScalePercentage": 0.01,
    "maxPositionPercentage": 0.05,
    "dailyLossLimit": 0.02
  },
  "notifications": {
    "telegram": {
      "enabled": true,
      "useOpenClaw": true
    }
  },
  "congress": {
    "dataSource": "official",
    "pollIntervalHours": 24,
    "minimumTradeSize": 10000
  }
}
```

**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. 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: `~/.clawback/config.json`
- Skill directory: `{baseDir}`

### 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. `{baseDir}/venv` exists (dependencies installed)
2. `~/.clawback/config.json` exists with non-empty `broker.credentials.apiKey`

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

```bash
# Install from ClawHub registry
clawhub install clawback

# Or install from local directory
clawhub install ./clawback
```

## Troubleshooting

### Common Issues

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: `{baseDir}/venv/`

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

3. **Token expiration**: If tokens expire (30-day lifespan):
   - Run: `python {baseDir}/scripts/auth_utility.py --refresh`
   - Or start new authentication: `python {baseDir}/scripts/auth_utility.py --auth`

4. **Python import errors**: If you see "ModuleNotFoundError":
   - Ensure virtual environment is activated
   - Run `pip install -e .` in `{baseDir}/`
   - Check Python path includes `{baseDir}/src`

### Debug Mode

To debug skill execution, add `DEBUG=1` environment variable:
```bash
DEBUG=1 {baseDir}/bin/clawback.py status
```

This will show additional information about the execution context.

### Post-Installation Setup

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

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:
```bash
cd ~/.openclaw/skills/clawback
./setup.sh          # Interactive setup wizard
# or
clawback setup      # CLI-based setup
```

### 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 E*TRADE developer portal
- **Consumer Secret**: From E*TRADE 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`:

```bash
# E*TRADE API (required)
BROKER_API_KEY=your_consumer_key_here
BROKER_API_SECRET=your_consumer_secret_here
BROKER_ACCOUNT_ID=your_account_id_here

# Telegram (optional)
TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHAT_ID=your_chat_id_here

# FMP API (optional)
FMP_API_KEY=your_fmp_api_key_here
```

## Usage

```bash
# Use the installed CLI command
clawback run      # Start interactive trading mode
clawback daemon   # Run as background service
clawback status   # Check system status
clawback setup    # Re-run setup wizard
clawback test     # Test Telegram notifications
```

## 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 E*TRADE. The adapter pattern allows for future broker support, but only E*TRADE is implemented and tested.

| Broker | Adapter | Status |
|--------|---------|--------|
| E*TRADE | `etrade_adapter.py` | 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:

```bash
# Standalone OAuth authentication script
cd {baseDir}
source venv/bin/activate
python scripts/auth_script.py
```

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

## File Locations

| File | Purpose |
|------|---------|
| `~/.clawback/config.json` | Main configuration |
| `~/.clawback/.access_tokens.json` | 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.

Popular in Professional

AIGC过程存证服务Professional

AIGC创作过程自动存证技能。自动识别创作平台与生成工具,将创作过程记录存证并盖有公安备案电子印章,具备可信时间戳,可以在全国电子印章互认平台核验。

↓ 3.9M★ 7u_c2c77b5f
防诈专家Professional

反电信网络诈骗(反诈)专家技能。当用户描述一个疑似诈骗的场景、短信、电话、链接、聊天记录、App、投资平台、招聘信息或转账要求,并询问「这是不是诈骗」「要不要转钱」「怎么止损」「钱还能不能追回来」,或需要识别诈骗话术、拆解骗局结构、生成报案材料与取证清单时使用。同时在对话中主动嗅探「转账、验证码、屏幕共享、安全账户、保证金、刷单、稳赚、百万保障、跑分」等风险词并插入预警,即使对方并未询问反诈。适用场景还包括:家属求助劝阻疑似被骗的亲人、企业/银行/支付机构/互联网平台做涉诈账户识别与交易监测规则、涉诈资金链(跑分、卡四件套、GOIP)分析、反诈合规与员工培训、反诈实战演练。

↓ 1.7M★ 4user_e9185b15
全国电子印章互认平台Professional

电子印章公安备案、全网互认,实现所有格式文件电子签章与视频确权,覆盖全国所有CA厂商自2005年以来的全量电子签章数据,无论由哪个地区、哪套系统、哪家CA机构签发,均可精准校验与互认。

↓ 1.4M★ 8u_c2c77b5f
baozheng-skillsProfessional

包拯.Skills你身边的专家律师团 — 专业法律咨询 + 要素式/通用起诉状起草 + 刑事专项材料辅助 + 法条分析与法规检索。flk.npc.gov.cn API实时法条优先,不可用时AI知识库降级兜底,**法条来源按四档标注可核验(已核验-flk API / 已核验-单源 / 已引-离线库 / 未核验-模型生成),交付末尾附法条/事实/金额/程序分项置信度**;以22类法律领域覆盖矩阵约束路由边界;支持35个起诉状模板、5类刑事专项材料辅助;内置Logic Doctor逻辑自检、诉讼时效追踪及10类异常容错处理(含连续失败熔断);渐进式意图收敛协议(3轮状态机);混合意图自动任务拆解(按依赖排序→合并→顺序执行);含反模式清单与危机干预出口(自杀/家暴/未成年人侵害先于一切法律分析)。非标准案由自动使用通用模板。

↓ 526.8K★ 2user_814dbe54
律师助手Professional

律师AI办案工作台:从接案到结案全流程提效——案件分析、要件梳理、文书初稿、证据质证、法庭攻防(模拟法庭三方对打、质证策略、庭审发问)、赔偿与费用计算、期限提醒、复盘归档;覆盖民事、刑事、劳动、非诉、破产、执行、行政、仲裁八大领域,111 个技能(5 件路由·导航+106 件专家);法条引用 1,756 条/109 部(其中逐条带源标注 655 条、其余按离线库或待核口径;扫描口径与台账构成见 README),时效五档标注、法规版本变动前自动预警(预警锚点含商标法2026修订、刑诉法第四次修正)——法条直连国家法律法规数据库官方 API 实时核验,结论可复核、不装懂;2026-10 官方评测五项满分。不用记命令或技能名,直接说人话:欠钱不还、被车撞、被辞退、离婚分财产、合同违约。

↓ 506.9K★ 77user_cd0fcd93
包拯.SKILLProfessional

包拯.Skills你身边的专家律师团 — 专业法律咨询 + 要素式/通用起诉状起草 + 刑事专项材料辅助 + 法条分析与法规检索。flk.npc.gov.cn API实时法条优先,不可用时AI知识库降级兜底,**法条来源按四档标注可核验(已核验-flk API / 已核验-单源 / 已引-离线库 / 未核验-模型生成),交付末尾附法条/事实/金额/程序分项置信度**;以22类法律领域覆盖矩阵约束路由边界;支持35个起诉状模板、5类刑事专项材料辅助;内置Logic Doctor逻辑自检、诉讼时效追踪及10类异常容错处理(含连续失败熔断);渐进式意图收敛协议(3轮状态机);混合意图自动任务拆解(按依赖排序→合并→顺序执行);含反模式清单与危机干预出口(自杀/家暴/未成年人侵害先于一切法律分析)。非标准案由自动使用通用模板。

↓ 424.0K★ 41user_741dc82b
专利初稿助手Professional

当用户上传交底材料、研发报告、技术方案文档,并要求撰写专利、撰写初稿,或请专利代理师视角输出可申请的专利文件时触发。也涵盖如下说法:'帮我把这份交底写成专利''生成专利文件''生成初稿''专利撰写'等,无论是否明确说'生成专利文件'。

↓ 368.6K★ 48user_9c63fdb4
露禾论文写作助手(免费版pro)Professional

露禾论文写作助手(免费版):一句话生成引用可溯源、不编造的专业学术论文,按国标 GB/T 7714 插入真实文献引用,中英文 3000/5000/8000 字,一键导出 Word。说「写论文 / 帮我写论文」即可使用。

↓ 349.5K★ 18u_a3c224a2

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.