# Send Monitor X posts to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "x-monitor",
    "name": "Monitor X posts",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/vmathur/x-monitor",
    "canonicalUrl": "https://clawhub.ai/vmathur/x-monitor",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/x-monitor",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=x-monitor",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/setup-crons.sh",
      "scripts/fetch-tweets.py",
      "config/schedule.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/x-monitor"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/x-monitor",
    "downloadUrl": "https://openagent3.xyz/downloads/x-monitor",
    "agentUrl": "https://openagent3.xyz/skills/x-monitor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/x-monitor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/x-monitor/agent.md"
  }
}
```
## Documentation

### X Monitor

Automated Twitter/X monitoring with intelligent filtering for high-value content.

### 1. X API Credentials

Save your X API credentials to ~/.openclaw/workspace/x-monitor/credentials.json:

{
  "bearer_token": "YOUR_BEARER_TOKEN_HERE"
}

### 2. Handles to Monitor

Configure accounts in ~/.openclaw/workspace/x-monitor/handles.json:

{
  "handles": [
    "naval",
    "paul_graham",
    "balajis",
    "vitalikbuterin"
  ]
}

Limit: 10-20 handles recommended for API quota management.

### 3. Schedule Configuration

Configure check frequency in ~/.openclaw/workspace/skills/x-monitor/config/schedule.json:

{
  "timezone": "America/Los_Angeles",
  "check_times": ["08:00", "12:00", "16:00", "20:00"],
  "enabled": true
}

Options:

timezone: IANA timezone string (e.g., "America/New_York", "Europe/London", "Asia/Tokyo")
check_times: Array of 24-hour times for daily checks (e.g., ["09:00", "18:00"] for twice daily)
enabled: Set to false to pause scheduled checks

Common schedules:

4x daily (default): ["08:00", "12:00", "16:00", "20:00"]
3x daily: ["09:00", "14:00", "20:00"]
2x daily: ["09:00", "18:00"]
1x daily: ["09:00"]

### 4. Setup Cron Jobs

After configuring your schedule, ask the agent to set up the cron jobs:

"set up x monitor cron jobs" — creates cron jobs based on your schedule.json
"update x monitor schedule" — updates cron jobs after changing schedule.json

### 5. Noteworthy Criteria

Edit ~/.openclaw/workspace/x-monitor/noteworthy-criteria.md to customize what gets surfaced.

### Scheduled Reports

Reports run at the times specified in config/schedule.json. Each report includes:

Executive summary — high-level overview of noteworthy items
Filtered tweets — chronological list with author, content, metrics

### Commands

Manage handles:

"add @username to x monitor" — add a new handle
"remove @username from x monitor" — remove a handle
"show x monitor handles" — list current handles

Manual check:

"check x now" — run immediate report

Schedule management:

"show x monitor schedule" — display current schedule config
"set x monitor to check at 9am and 6pm" — update check times
"set x monitor timezone to America/New_York" — update timezone
"set up x monitor cron jobs" — create/update cron jobs from schedule.json

Update criteria:

"show noteworthy criteria" — display current filter rules
"update noteworthy criteria" — help edit the criteria

### What Counts as Noteworthy (Default)

Include:

Insights on technology trends, AI, crypto, product design
First-person experiences building/shipping
Novel frameworks, metaphors, or mental models
Data-driven observations with concrete examples
Contrarian but well-argued takes

Exclude:

Political rage bait or partisan content
Generic motivational quotes
Pure engagement farming

### API Details

Uses X API v2 tweets/search/recent endpoint:

Max results: 10 per handle per check
Fields: created_at, public_metrics, author_id, lang
Expansions: author_id for full user info
Query pattern: from:{handle}

### Storage

Credentials: ~/.openclaw/workspace/x-monitor/credentials.json
Handles: ~/.openclaw/workspace/x-monitor/handles.json
Schedule: ~/.openclaw/workspace/skills/x-monitor/config/schedule.json
Criteria: ~/.openclaw/workspace/x-monitor/noteworthy-criteria.md
Last check: ~/.openclaw/workspace/x-monitor/last-check.json (timestamp tracking)

### Cron Job Setup

When setting up cron jobs, the agent will:

Read config/schedule.json for timezone and times
Create isolated cron jobs using agentTurn payloads
Each job runs: fetch tweets → filter for noteworthy → deliver summary

Example cron expression for 8am in America/Los_Angeles:

{
  "schedule": { "kind": "cron", "expr": "0 8 * * *", "tz": "America/Los_Angeles" },
  "payload": { "kind": "agentTurn", "message": "Run x-monitor check and report noteworthy tweets" }
}

### Error Handling

Rate limits: Backs off and logs warning
Invalid handles: Skips and reports
API errors: Logs and continues with remaining handles
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: vmathur
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/x-monitor)
- [Send to Agent page](https://openagent3.xyz/skills/x-monitor/agent)
- [JSON manifest](https://openagent3.xyz/skills/x-monitor/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/x-monitor/agent.md)
- [Download page](https://openagent3.xyz/downloads/x-monitor)