⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.0.0

x-monitor

whoisdhana@whoisdhana⭐ 0 stars· last commit 5mo ago· 0 open issues

Monitor X/Twitter accounts and topics with AI-enriched Discord alerts. Cron-powered, fully agentic.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

β€”/10

// RATINGS

⭐GitHub Stars
⭐ 0 on GitHubGitHub β†—

New / niche

🟒ProSkills Score
β€”
πŸ“

Not yet listed on ClawHub or SkillsMP

// README

🐦 X Monitor

An OpenClaw skill β€” Monitor X/Twitter accounts and topics with AI-enriched Discord alerts. Fully agentic, cron-powered, self-healing.

MIT-0 License OpenClaw Skill


What It Does

X Monitor watches X/Twitter on your behalf and pushes rich Discord alerts in real time:

FeatureDetails
Account MonitorPolls up to N accounts every 5 min, detects new tweets, fetches thread context (first 3 replies), sends AI-summarized Discord embed
Topic ResearchSearches live X every 6h per topic, filters bots/spam, sends AI-synthesized Discord digest
Hot Trend DetectionAlerts when a topic spikes 2.5Γ— its rolling average (with 12h cooldown)
AI InsightsUses your configured OpenClaw agent to generate 1-2 sentence summaries and structured THEMES/VIBE/SIGNAL digests
Discord ButtonsInline Mute / Remove / Pause / Search buttons on every alert
Self-HealingExponential backoff on rate limits, session validation, emergency stop on combined failures

Prerequisites

RequirementNotes
OpenClawMust be installed and gateway running
bird CLI (agent-reach)X/Twitter API wrapper. Install: brew install openclaw/tap/agent-reach
Google ChromeFor session validation and thread context fetching
X.com accountYour auth cookies (auth_token + ct0)
Discord botWith a token and permissions to post in your channels
Node.js β‰₯ 18

Installation

# 1. Clone the repo
git clone https://github.com/your-username/x-monitor.git
cd x-monitor

# 2. Install dependencies
npm install

# 3. Run the setup wizard
npm run setup

The setup wizard will walk you through:

  • Entering your X.com auth_token and ct0 cookies
  • Entering your Discord bot token and channel IDs
  • Creating data/ and logs/ directories
  • (Optional) Verifying your X session
  • (Optional) Installing OpenClaw cron jobs

Getting Your Credentials

X.com auth_token + ct0

  1. Open x.com in Chrome and log in
  2. Press F12 β†’ Application tab β†’ Cookies β†’ https://x.com
  3. Find auth_token and ct0 β€” copy their values

Discord Bot Token + Channel IDs

  1. Go to discord.com/developers/applications
  2. Create a new application β†’ Bot tab β†’ copy the token
  3. Invite the bot to your server with Send Messages + Use Slash Commands permissions
  4. Right-click any channel β†’ Copy Channel ID (enable Developer Mode in Discord settings if needed)

Configuration

All config lives in .env (created by npm run setup or copy from .env.example):

# X.com API credentials
AUTH_TOKEN=your_auth_token_here
CT0=your_ct0_cookie_here

# Discord
DISCORD_BOT_TOKEN=your_bot_token
DISCORD_ACCOUNT_CHANNEL_ID=channel_id_for_account_alerts
DISCORD_RESEARCH_CHANNEL_ID=channel_id_for_topic_research
DISCORD_MAIN_CHANNEL_ID=channel_id_for_hot_trend_pings

# Optional β€” auto-detected if blank
BIRD_PATH=bird
CHROME_PATH=
CHROME_CDP_PORT=18803

# OpenClaw agent used for AI insights
OPENCLAW_AGENT=dataulu

Quick Start (After Setup)

Manage Monitored Accounts

# Add an account
npm run accounts -- add elonmusk

# Remove an account
npm run accounts -- remove elonmusk

# List all monitored accounts
npm run accounts -- list

# Show status
npm run accounts -- status

Manage Research Topics

# Add a topic
npm run topics -- add "openclaw"

# Remove a topic
npm run topics -- remove "openclaw"

# List active topics
npm run topics -- list

# Pause/resume a topic
npm run topics -- pause "openclaw"
npm run topics -- resume "openclaw"

Run Manually

# Run account monitor once
npm run monitor

# Run topic research for a topic
npm run research -- "openclaw"

# Verify X.com session
npm run session -- verify

# Reset session (re-login)
npm run session

How It Works

Every 5 min (cron)                Every 6 hours (cron)
       β”‚                                   β”‚
       β–Ό                                   β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”            β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ headless-poll.js β”‚            β”‚  topic-poll.js       β”‚
β”‚                 β”‚            β”‚                      β”‚
β”‚ bird user-tweetsβ”‚            β”‚ bird search "<topic>"β”‚
β”‚ β†’ detect new    β”‚            β”‚ β†’ 24h filter         β”‚
β”‚ β†’ thread contextβ”‚            β”‚ β†’ bot/spam filter    β”‚
β”‚ β†’ dedup SQLite  β”‚            β”‚ β†’ dedup SQLite       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜            β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
         β”‚                               β”‚
         β–Ό                               β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”            β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  ai-layer.js    β”‚            β”‚   ai-layer.js        β”‚
β”‚                 β”‚            β”‚                      β”‚
β”‚ openclaw agent  β”‚            β”‚ openclaw agent       β”‚
β”‚ β†’ 1-2 sentence  β”‚            β”‚ β†’ THEMES/VIBE/SIGNAL β”‚
β”‚   summary       β”‚            β”‚   digest             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜            β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
         β”‚                               β”‚
         β–Ό                               β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”            β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ format-alert.js β”‚            β”‚  topic-alert.js      β”‚
β”‚                 β”‚            β”‚                      β”‚
β”‚ Discord embed   β”‚            β”‚ Discord embed with   β”‚
β”‚ + Mute / Remove β”‚            β”‚ AI digest + Pause /  β”‚
β”‚   buttons       β”‚            β”‚ Search / Remove btns β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜            β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
         β”‚                               β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β–Ό
                  Discord Channel

Cron Jobs

Installed automatically by bash scripts/setup-cron.sh (or via npm run setup):

JobScheduleScript
x-account-monitorEvery 5 minscripts/run-monitor.sh
x-topic-researchEvery 6 hoursscripts/run-research.sh

To install manually:

bash scripts/setup-cron.sh

To verify:

openclaw cron list

OpenClaw Skill Integration

This project ships as an OpenClaw skill (SKILL.md). Once installed, your OpenClaw agent can respond to Discord slash commands:

/x-monitor

/x-monitor add elonmusk      β†’ Start monitoring @elonmusk
/x-monitor remove elonmusk   β†’ Stop monitoring
/x-monitor list              β†’ List all monitored accounts
/x-monitor status            β†’ Show health + last run

/x-research

/x-research add "openclaw"   β†’ Start tracking topic
/x-research remove "openclaw"
/x-research list
/x-research pause "openclaw"
/x-research resume "openclaw"
/x-research status

To install the skill in your OpenClaw workspace:

cp SKILL.md PIPELINE.md ~/.openclaw/workspace/skills/x-monitor/
# or add this repo to skills.load.extraDirs in openclaw.json

Or install directly from ClawHub:

clawhub install x-monitor

Project Structure

x-monitor/
β”œβ”€β”€ SKILL.md                    # OpenClaw / ClawHub skill manifest
β”œβ”€β”€ PIPELINE.md                 # Agentic pipeline runbook (for the AI agent)
β”œβ”€β”€ .env.example                # Config template β€” copy to .env and fill in
β”œβ”€β”€ setup.js                    # Interactive setup wizard
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ config.js               # Central config loader (dotenv + validation)
β”‚   β”œβ”€β”€ monitor/
β”‚   β”‚   β”œβ”€β”€ headless-poll.js    # Account monitoring engine
β”‚   β”‚   └── format-alert.js     # Discord embed builder (accounts)
β”‚   β”œβ”€β”€ research/
β”‚   β”‚   β”œβ”€β”€ topic-poll.js       # Topic research engine
β”‚   β”‚   └── topic-alert.js      # Discord embed builder (topics)
β”‚   β”œβ”€β”€ shared/
β”‚   β”‚   β”œβ”€β”€ db.js               # SQLite init helper
β”‚   β”‚   β”œβ”€β”€ discord.js          # Discord REST client
β”‚   β”‚   β”œβ”€β”€ bird.js        

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md3.0 KBupstream β†—
    ---
    name: x-monitor
    description: "Monitor X/Twitter accounts and topics with AI-enriched Discord alerts. Cron-powered, fully agentic."
    version: 1.0.0
    emoji: "🐦"
    metadata:
      openclaw:
        requires:
          env:
            - AUTH_TOKEN
            - CT0
            - DISCORD_BOT_TOKEN
            - DISCORD_ACCOUNT_CHANNEL_ID
            - DISCORD_RESEARCH_CHANNEL_ID
          bins:
            - bird
          anyBins:
            - google-chrome
            - chromium
        primaryEnv: AUTH_TOKEN
        os: ["macos", "linux"]
        install:
          - kind: brew
            formula: agent-reach
            bins: [bird]
            label: "Install bird CLI (agent-reach)"
    ---
    
    # X Monitor + X Research
    
    > **For the full agentic pipeline runbook** (cron jobs, error handling, self-repair), read `PIPELINE.md`.
    > **For setup instructions**, see `README.md` or run `node setup.js`.
    
    Handle Discord slash commands for X account monitoring (`/x-monitor`) and topic research (`/x-research`).
    
    ---
    
    ## /x-monitor Commands
    
    | Action | Command |
    |--------|---------|
    | `add <username>` | Add an X account to monitoring |
    | `remove <username>` | Remove an X account from monitoring |
    | `list` | List all monitored accounts |
    | `status` | Show monitoring status |
    | `mute <username>` | Mute alerts for an account |
    
    ```bash
    node src/cli/commands.js add <username>
    node src/cli/commands.js remove <username>
    node src/cli/commands.js list
    node src/cli/commands.js status
    ```
    
    ### Response Templates
    
    **add success:** `βœ… Now monitoring @<username>`
    **add error:** `❌ Error: <message>`
    **remove success:** `βœ… Removed @<username> from monitoring`
    **list:**
    ```
    πŸ“‹ Monitoring (N accounts):
    @account1, @account2, @account3
    ```
    **status:**
    ```
    🐦 X Monitor: Active
    Monitoring N accounts
    ```
    
    ---
    
    ## /x-research Commands
    
    | Action | Command |
    |--------|---------|
    | `add <topic>` | Start tracking a topic |
    | `remove <topic>` | Stop tracking a topic |
    | `list` | List active topics |
    | `list-all` | List all topics including paused |
    | `status` | Show topic counts (active/paused/total) |
    | `pause <topic>` | Pause alerts for a topic |
    | `resume <topic>` | Resume alerts for a topic |
    
    ```bash
    node src/cli/topic-commands.js add "<topic>"
    node src/cli/topic-commands.js remove "<topic>"
    node src/cli/topic-commands.js list
    node src/cli/topic-commands.js list-all
    node src/cli/topic-commands.js status
    node src/cli/topic-commands.js pause "<topic>"
    node src/cli/topic-commands.js resume "<topic>"
    ```
    
    ### Response Templates
    
    **add success:** `βœ… Now tracking topic: "<topic>"`
    **remove success:** `βœ… Removed topic: "<topic>"`
    **pause success:** `⏸ Paused topic: "<topic>"`
    **resume success:** `▢️ Resumed topic: "<topic>"`
    **list:**
    ```
    πŸ” Tracking N topics:
    β€’ topic one
    β€’ topic two
    ```
    **status:**
    ```
    πŸ” X Research: Active
    N active topics, N paused
    ```
    
    ---
    
    ## Implementation Notes
    
    - Parse arguments to determine action, execute CLI command, send result back via `message` tool
    - Use the channel from the interaction context
    - Quote multi-word topics when passing to topic-commands.js
    - Use ephemeral responses for confirmations where appropriate
    
  • README.mdupstream β†—

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/whoisdhana-x-monitor.md

// REPO STATS

0 stars
0 open issues
Last commit: 5mo ago