Poly Monitor

██████╗  ██████╗ ██╗  ██╗   ██╗    ███╗   ███╗ ██████╗ ███╗   ██╗██╗████████╗ ██████╗ ██████╗
██╔══██╗██╔═══██╗██║  ╚██╗ ██╔╝    ████╗ ████║██╔═══██╗████╗  ██║██║╚══██╔══╝██╔═══██╗██╔══██╗
██████╔╝██║   ██║██║   ╚████╔╝     ██╔████╔██║██║   ██║██╔██╗ ██║██║   ██║   ██║   ██║██████╔╝
██╔═══╝ ██║   ██║██║    ╚██╔╝      ██║╚██╔╝██║██║   ██║██║╚██╗██║██║   ██║   ██║   ██║██╔══██╗
██║     ╚██████╔╝███████╗██║       ██║ ╚═╝ ██║╚██████╔╝██║ ╚████║██║   ██║   ╚██████╔╝██║  ██║
╚═╝      ╚═════╝ ╚══════╝╚═╝       ╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝

“Facts do not cease to exist because they are ignored.” — Aldous Huxley

English | 中文

Quick Start (recommend in tmux)

For long-running monitoring, use a global command in your shell session and run inside tmux.

sudo apt update
sudo apt install tmux -y
tmux

python3 -m venv .venv
source .venv/bin/activate
pip install --no-cache-dir "git+https://github.com/pothitos/twikit.git@patch-1"
pip install -e .
poly-monitor new
poly-monitor run --task <task_name>   # test mode: print all outputs
poly-monitor start --task <task_name> # production mode: background worker + terminal dashboard

twikit from PyPI is no longer reliable here; install the patch-1 GitHub build first.

Recommended: run poly-monitor start --task xxx and other operations in tmux so the session can stay alive.

Steps for Configuration

• You can copy your Twitter auth_token and ct0 from the browser console to connect to your Twitter account without direct login or any web scraping. Then configure your list of monitored users—provided that you are already following them on Twitter—so that poly-monitor can continuously track updates based on twikit！
• Enter your decentralized wallet private key locally (MetaMask, Phantom, Coinbase, etc.—MetaMask is recommended). Please pay attention to wallet security; it is recommended to use a small test wallet private key first. Poly-monitor runs locally, so there is no need to log in to a Polymarket account or upload any wallet information.
• You can also edit WATCH_USERS manually in tasks/<task_name>/task_config.py to add users you want to monitor or just call your openclaw to do it for you!

Steps for Configuration

poly-monitor start --task <your task name>: Just enjoy and see whether your information sources can actually help OpenClaw make some lucky shots！ poly-monitor start --task <your task name> starts the background worker plus dashboard.

Unified Architecture + User Guide

Runtime flow

1. poly-monitor new creates task config (tasks/<task>/task_config.py).
2. Market pipeline fetches from Gamma API and filters active markets.
3. RAG builds vectors from real market questions; if no child market exists, it falls back to event title.
4. Twitter watcher polls watched users.
5. If score reaches threshold, decision prompt is synthesized and sent to OpenClaw.
6. Trade response and matched news are persisted into task logs.

CLI modes

• run: testing mode, keeps printing outputs in foreground.
• start: production mode, starts worker in background and shows a terminal dashboard refreshed every minute.

Start-mode dashboard

The start dashboard shows exactly three terminal blocks:

• Top status banner: version, init time, current UTC time, heartbeat, transactions / triggered news counts.
• Portfolio block: EOA / proxy wallet, portfolio value summary, recent activity, open positions.
• Rolling news block: latest entries from tasks/<task>/data/tweets.jsonl.

Private key lookup for dashboard and runtime: POLYMARKET_PRIVATE_KEY.

task_config.py field reference

• TASK_NAME: task name.
• MAX_ASSET_USD: max reference capital per decision.
• MIN_TRADE_USDC / MAX_TRADE_USDC: trade range included in decision prompt.
• TASK_INIT_TIME: initialization time.
• MARKET_REFRESH_INTERVAL_SECONDS: refresh interval for market data + vector index.
• TWITTER_POLL_INTERVAL_SECONDS: Twitter polling interval.
• WATCH_USERS: monitored accounts list.
• TOPIC_TAG_SLUG: Gamma API topic slug.
• VOLUME_MIN: minimum volume threshold for market filtering.
• RAG_SCORE_THRESHOLD: trigger threshold for decision synthesis.
• DECISION_ENABLED: whether to call OpenClaw.
• TRADING_ENABLED: whether order actions are allowed in prompt context.
• OPENCLAW_COMMAND: default command is ['openclaw','agent','--message'].
• TRUSTED_MEDIA: media context list for prompt construction.
• TWITTER_AUTH_TOKEN / TWITTER_CT0: twikit login cookies.

Core command

openclaw agent --message "<decision prompt>"

Key logs

• tasks/<task>/data/tweets.jsonl: fetched tweets.
• tasks/<task>/logs/runtime_events.jsonl: news, threshold triggers, synthesized prompts, trade responses.
• tasks/<task>/logs/task_runtime.log: background worker runtime log.
• tasks/<task>/test/decision_records.jsonl: detailed trigger debug records.

Common task operations

poly-monitor list
poly-monitor stop --task <task_name>

TODO

• Interactive UI version.
• Extend to custom sources beyond Twitter.
• Support sell, split, merge, redeem.
• Support strategies and limit orders.

License

MIT