Skip to content

Getting Started

Four steps, about five minutes.

1. Sign in

Open StockClaw and click Sign in with Google, or enter your email to receive a magic-link sign-in.

Your personal space is created automatically on first login — an empty "My watchlist", default settings, no shared state with anyone else. StockClaw uses PostgreSQL row-level security so every query is filtered to your user id at the database layer; you cannot see another user's signals and they cannot see yours.

2. Add tickers

Go to Watchlist and click + Add ticker. Type any symbol StockClaw's data source recognises — NYSE, NASDAQ, TWSE (2330.TW), KRX (005930.KS), HKEX, LSE, etc.

When you add a ticker we:

  • Query Yahoo Finance to resolve the company name and generate search aliases (e.g. LITE → Lumentum, Lumentum Holdings)
  • Trigger an immediate crawl so the first signals for that ticker can appear within a few minutes instead of waiting for the next 20-minute Beat cycle

You can add up to several dozen tickers. The pipeline runs a per-user fanout: ingestion happens once globally, but synthesis runs individually against your watchlist so the scoring reflects your specific context.

From Settings → Telegram integration:

  1. Open Telegram and click @stockclaw_notify_bot, then hit Start. This is required — Telegram does not allow bots to DM users who haven't started the conversation.
  2. Open @userinfobot and send /start; it replies with Id: 123456789.
  3. Copy the number, paste into StockClaw's chat_id field, optionally add your @username, click Link.

FLASH and ALERT signals will now be delivered as grouped Telegram messages — at most two per pipeline run.

4. Enable browser notifications (optional)

Settings → Browser notifications → Enable. StockClaw asks permission, then sends system-level alerts the moment a FLASH or ALERT signal lands. Clicking the notification deep-links back into the dashboard and scrolls to that specific signal card.

Works on:

  • Desktop Chrome, Firefox, Edge, Safari
  • Android Chrome and other modern browsers
  • iOS Safari, but only after you install StockClaw as a PWA (Share → Add to Home Screen) — iOS 16.4+

That's it

Your first signals should start appearing on the dashboard within one to three minutes of adding tickers. Each card shows:

  • Urgency (FLASH / ALERT / DIGEST / FYI) and signal type
  • A short English + Chinese summary side-by-side
  • Per-ticker impact bars with relevance tier (direct / sector / mentioned)
  • Impact and confidence scores, plus a collapsible 5-agent breakdown
  • The original source article with a visual preview card

Ready to go deeper? See How it works.