{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/x-monitor",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=x-monitor",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/setup-crons.sh",
      "scripts/fetch-tweets.py",
      "config/schedule.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/x-monitor",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "X Monitor",
        "body": "Automated Twitter/X monitoring with intelligent filtering for high-value content."
      },
      {
        "title": "1. X API Credentials",
        "body": "Save your X API credentials to ~/.openclaw/workspace/x-monitor/credentials.json:\n\n{\n  \"bearer_token\": \"YOUR_BEARER_TOKEN_HERE\"\n}"
      },
      {
        "title": "2. Handles to Monitor",
        "body": "Configure accounts in ~/.openclaw/workspace/x-monitor/handles.json:\n\n{\n  \"handles\": [\n    \"naval\",\n    \"paul_graham\",\n    \"balajis\",\n    \"vitalikbuterin\"\n  ]\n}\n\nLimit: 10-20 handles recommended for API quota management."
      },
      {
        "title": "3. Schedule Configuration",
        "body": "Configure check frequency in ~/.openclaw/workspace/skills/x-monitor/config/schedule.json:\n\n{\n  \"timezone\": \"America/Los_Angeles\",\n  \"check_times\": [\"08:00\", \"12:00\", \"16:00\", \"20:00\"],\n  \"enabled\": true\n}\n\nOptions:\n\ntimezone: IANA timezone string (e.g., \"America/New_York\", \"Europe/London\", \"Asia/Tokyo\")\ncheck_times: Array of 24-hour times for daily checks (e.g., [\"09:00\", \"18:00\"] for twice daily)\nenabled: Set to false to pause scheduled checks\n\nCommon schedules:\n\n4x daily (default): [\"08:00\", \"12:00\", \"16:00\", \"20:00\"]\n3x daily: [\"09:00\", \"14:00\", \"20:00\"]\n2x daily: [\"09:00\", \"18:00\"]\n1x daily: [\"09:00\"]"
      },
      {
        "title": "4. Setup Cron Jobs",
        "body": "After configuring your schedule, ask the agent to set up the cron jobs:\n\n\"set up x monitor cron jobs\" — creates cron jobs based on your schedule.json\n\"update x monitor schedule\" — updates cron jobs after changing schedule.json"
      },
      {
        "title": "5. Noteworthy Criteria",
        "body": "Edit ~/.openclaw/workspace/x-monitor/noteworthy-criteria.md to customize what gets surfaced."
      },
      {
        "title": "Scheduled Reports",
        "body": "Reports run at the times specified in config/schedule.json. Each report includes:\n\nExecutive summary — high-level overview of noteworthy items\nFiltered tweets — chronological list with author, content, metrics"
      },
      {
        "title": "Commands",
        "body": "Manage handles:\n\n\"add @username to x monitor\" — add a new handle\n\"remove @username from x monitor\" — remove a handle\n\"show x monitor handles\" — list current handles\n\nManual check:\n\n\"check x now\" — run immediate report\n\nSchedule management:\n\n\"show x monitor schedule\" — display current schedule config\n\"set x monitor to check at 9am and 6pm\" — update check times\n\"set x monitor timezone to America/New_York\" — update timezone\n\"set up x monitor cron jobs\" — create/update cron jobs from schedule.json\n\nUpdate criteria:\n\n\"show noteworthy criteria\" — display current filter rules\n\"update noteworthy criteria\" — help edit the criteria"
      },
      {
        "title": "What Counts as Noteworthy (Default)",
        "body": "Include:\n\nInsights on technology trends, AI, crypto, product design\nFirst-person experiences building/shipping\nNovel frameworks, metaphors, or mental models\nData-driven observations with concrete examples\nContrarian but well-argued takes\n\nExclude:\n\nPolitical rage bait or partisan content\nGeneric motivational quotes\nPure engagement farming"
      },
      {
        "title": "API Details",
        "body": "Uses X API v2 tweets/search/recent endpoint:\n\nMax results: 10 per handle per check\nFields: created_at, public_metrics, author_id, lang\nExpansions: author_id for full user info\nQuery pattern: from:{handle}"
      },
      {
        "title": "Storage",
        "body": "Credentials: ~/.openclaw/workspace/x-monitor/credentials.json\nHandles: ~/.openclaw/workspace/x-monitor/handles.json\nSchedule: ~/.openclaw/workspace/skills/x-monitor/config/schedule.json\nCriteria: ~/.openclaw/workspace/x-monitor/noteworthy-criteria.md\nLast check: ~/.openclaw/workspace/x-monitor/last-check.json (timestamp tracking)"
      },
      {
        "title": "Cron Job Setup",
        "body": "When setting up cron jobs, the agent will:\n\nRead config/schedule.json for timezone and times\nCreate isolated cron jobs using agentTurn payloads\nEach job runs: fetch tweets → filter for noteworthy → deliver summary\n\nExample cron expression for 8am in America/Los_Angeles:\n\n{\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 8 * * *\", \"tz\": \"America/Los_Angeles\" },\n  \"payload\": { \"kind\": \"agentTurn\", \"message\": \"Run x-monitor check and report noteworthy tweets\" }\n}"
      },
      {
        "title": "Error Handling",
        "body": "Rate limits: Backs off and logs warning\nInvalid handles: Skips and reports\nAPI errors: Logs and continues with remaining handles"
      }
    ],
    "body": "X Monitor\n\nAutomated Twitter/X monitoring with intelligent filtering for high-value content.\n\nSetup\n1. X API Credentials\n\nSave your X API credentials to ~/.openclaw/workspace/x-monitor/credentials.json:\n\n{\n  \"bearer_token\": \"YOUR_BEARER_TOKEN_HERE\"\n}\n\n2. Handles to Monitor\n\nConfigure accounts in ~/.openclaw/workspace/x-monitor/handles.json:\n\n{\n  \"handles\": [\n    \"naval\",\n    \"paul_graham\",\n    \"balajis\",\n    \"vitalikbuterin\"\n  ]\n}\n\n\nLimit: 10-20 handles recommended for API quota management.\n\n3. Schedule Configuration\n\nConfigure check frequency in ~/.openclaw/workspace/skills/x-monitor/config/schedule.json:\n\n{\n  \"timezone\": \"America/Los_Angeles\",\n  \"check_times\": [\"08:00\", \"12:00\", \"16:00\", \"20:00\"],\n  \"enabled\": true\n}\n\n\nOptions:\n\ntimezone: IANA timezone string (e.g., \"America/New_York\", \"Europe/London\", \"Asia/Tokyo\")\ncheck_times: Array of 24-hour times for daily checks (e.g., [\"09:00\", \"18:00\"] for twice daily)\nenabled: Set to false to pause scheduled checks\n\nCommon schedules:\n\n4x daily (default): [\"08:00\", \"12:00\", \"16:00\", \"20:00\"]\n3x daily: [\"09:00\", \"14:00\", \"20:00\"]\n2x daily: [\"09:00\", \"18:00\"]\n1x daily: [\"09:00\"]\n4. Setup Cron Jobs\n\nAfter configuring your schedule, ask the agent to set up the cron jobs:\n\n\"set up x monitor cron jobs\" — creates cron jobs based on your schedule.json\n\"update x monitor schedule\" — updates cron jobs after changing schedule.json\n5. Noteworthy Criteria\n\nEdit ~/.openclaw/workspace/x-monitor/noteworthy-criteria.md to customize what gets surfaced.\n\nScheduled Reports\n\nReports run at the times specified in config/schedule.json. Each report includes:\n\nExecutive summary — high-level overview of noteworthy items\nFiltered tweets — chronological list with author, content, metrics\nCommands\n\nManage handles:\n\n\"add @username to x monitor\" — add a new handle\n\"remove @username from x monitor\" — remove a handle\n\"show x monitor handles\" — list current handles\n\nManual check:\n\n\"check x now\" — run immediate report\n\nSchedule management:\n\n\"show x monitor schedule\" — display current schedule config\n\"set x monitor to check at 9am and 6pm\" — update check times\n\"set x monitor timezone to America/New_York\" — update timezone\n\"set up x monitor cron jobs\" — create/update cron jobs from schedule.json\n\nUpdate criteria:\n\n\"show noteworthy criteria\" — display current filter rules\n\"update noteworthy criteria\" — help edit the criteria\nWhat Counts as Noteworthy (Default)\n\nInclude:\n\nInsights on technology trends, AI, crypto, product design\nFirst-person experiences building/shipping\nNovel frameworks, metaphors, or mental models\nData-driven observations with concrete examples\nContrarian but well-argued takes\n\nExclude:\n\nPolitical rage bait or partisan content\nGeneric motivational quotes\nPure engagement farming\nAPI Details\n\nUses X API v2 tweets/search/recent endpoint:\n\nMax results: 10 per handle per check\nFields: created_at, public_metrics, author_id, lang\nExpansions: author_id for full user info\nQuery pattern: from:{handle}\nStorage\nCredentials: ~/.openclaw/workspace/x-monitor/credentials.json\nHandles: ~/.openclaw/workspace/x-monitor/handles.json\nSchedule: ~/.openclaw/workspace/skills/x-monitor/config/schedule.json\nCriteria: ~/.openclaw/workspace/x-monitor/noteworthy-criteria.md\nLast check: ~/.openclaw/workspace/x-monitor/last-check.json (timestamp tracking)\nCron Job Setup\n\nWhen setting up cron jobs, the agent will:\n\nRead config/schedule.json for timezone and times\nCreate isolated cron jobs using agentTurn payloads\nEach job runs: fetch tweets → filter for noteworthy → deliver summary\n\nExample cron expression for 8am in America/Los_Angeles:\n\n{\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 8 * * *\", \"tz\": \"America/Los_Angeles\" },\n  \"payload\": { \"kind\": \"agentTurn\", \"message\": \"Run x-monitor check and report noteworthy tweets\" }\n}\n\nError Handling\nRate limits: Backs off and logs warning\nInvalid handles: Skips and reports\nAPI errors: Logs and continues with remaining handles"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/vmathur/x-monitor",
    "publisherUrl": "https://clawhub.ai/vmathur/x-monitor",
    "owner": "vmathur",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}