openclaw - ✅(Solved) Fix Proposal: xmaster — X/Twitter skill for OpenClaw [1 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#56762Fetched 2026-04-08 01:48:05
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
0
Participants
Timeline (top)
cross-referenced ×1referenced ×1

Fix Action

Fixed

PR fix notes

PR #56764: feat: add xmaster X/Twitter skill

Description (problem / solution / changelog)

Summary

  • Adds skills/xmaster/ — an X/Twitter skill powered by the xmaster Rust CLI
  • Covers posting, replying, threading, search (X API v2 + xAI/Grok), DMs, bookmarks, scheduling, pre-flight post analysis, metrics, and engagement tracking
  • Agent-friendly: JSON output, semantic exit codes (0-4), agent-info for capability discovery
  • Install via Homebrew (199-biotechnologies/tap) or cargo install xmaster

Setup requirements

  • X API v2 credentials (Free tier works) — API key, secret, access token, access token secret
  • Optional: xAI API key for AI-powered semantic search
  • Optional: OAuth 2.0 PKCE for bookmarks (xmaster config auth)
  • Optional: Browser cookie capture for reply fallback (xmaster config web-login)

All documented in the SKILL.md with step-by-step setup.

Context

Issue: #56762

Tested in production daily by 199 Biotechnologies. Feedback, issues, and stars welcome on the xmaster repo. MIT licensed.

Test plan

  • Verify xmaster installs via brew tap 199-biotechnologies/tap && brew install xmaster
  • Verify xmaster config check validates credentials
  • Verify xmaster agent-info --json returns structured capabilities
  • Verify skill triggers correctly when user asks to post/search/reply on X

Changed files

  • skills/xmaster/SKILL.md (added, +305/-0)
RAW_BUFFERClick to expand / collapse

What

xmaster is an X/Twitter CLI built in Rust. Single binary, ~8MB, JSON output, structured exit codes. It handles posting, replying, threading, search (X API v2 + xAI/Grok), DMs, scheduling, bookmarks, and pre-flight post analysis with real algorithm weights from the open-source X ranking code.

Proposing it as a bundled skill under `skills/xmaster/`. PR: #56764

Why

X/Twitter is a missing channel in OpenClaw. There's no built-in way to post, reply, search, or track engagement. xmaster was built agent-first — `--json` output, semantic exit codes (0/1/2/3/4), and `agent-info` for machine-readable capability discovery.

Already works as a Claude Code skill. The agent shells out to xmaster and gets structured data back.

What it covers

  • Post, reply, thread, quote, delete
  • Search (X API v2 + xAI semantic search)
  • DMs (send, inbox, threads)
  • Bookmarks (sync, search, export, digest)
  • Scheduling (with launchd daemon)
  • Pre-flight analysis (scores posts, catches weak hooks, link penalties, engagement bait)
  • Engagement (like, retweet, follow, block, mute)
  • Metrics and reporting (daily/weekly digests, timing heatmaps)
  • Writing style persistence (agent drafts in your voice)

Install

```bash brew tap 199-biotechnologies/tap && brew install xmaster

or

cargo install xmaster

or

curl -fsSL https://raw.githubusercontent.com/199-biotechnologies/xmaster/master/install.sh | sh ```

Credentials required

CredentialSourceRequired forRequired?
X API Key + Secrethttps://developer.x.com (Free tier)Posting, reading, search, likes, DMsYes
X Access Token + SecretSame developer portalUser-context actions (post, like, DM)Yes
xAI API Keyhttps://console.x.aiAI-powered semantic search (`search-ai`)Optional
OAuth 2.0 PKCE`xmaster config auth` (opens browser once)Bookmarks sync/search/exportOptional
Browser cookies`xmaster config web-login` (captures from browser)Reply fallback to non-followers (X blocks API replies to strangers)Optional

Setup:

```bash

Required — X API v2 credentials

xmaster config set keys.api_key YOUR_X_API_KEY xmaster config set keys.api_secret YOUR_X_API_SECRET xmaster config set keys.access_token YOUR_ACCESS_TOKEN xmaster config set keys.access_token_secret YOUR_ACCESS_TOKEN_SECRET

Optional — AI search

xmaster config set keys.xai YOUR_XAI_KEY

Optional — Bookmarks (one-time browser auth)

xmaster config auth

Optional — Reply fallback for non-followers

xmaster config web-login

Verify everything

xmaster config check ```

Skill format

```yaml

name: xmaster description: "X/Twitter operations via xmaster CLI: post, reply, thread, search, analyze, schedule, DMs, bookmarks, metrics." metadata: openclaw: emoji: "𝕏" requires: bins: ["xmaster"] install: - id: brew kind: brew formula: xmaster tap: "199-biotechnologies/tap" bins: ["xmaster"] label: "Install xmaster (Homebrew)" - id: cargo kind: cargo crate: xmaster bins: ["xmaster"] label: "Install xmaster (cargo)"

```

Links

Tested in production daily by 199 Biotechnologies. Feedback, issues, and stars welcome on the repo.

extent analysis

Fix Plan

To integrate xmaster into OpenClaw, follow these steps:

  • Install xmaster using one of the methods:
    • brew tap 199-biotechnologies/tap && brew install xmaster
    • cargo install xmaster
    • curl -fsSL https://raw.githubusercontent.com/199-biotechnologies/xmaster/master/install.sh | sh
  • Set up required credentials:
    • X API Key and Secret
    • X Access Token and Secret
  • Configure xmaster:
    • xmaster config set keys.api_key YOUR_X_API_KEY
    • xmaster config set keys.api_secret YOUR_X_API_SECRET
    • xmaster config set keys.access_token YOUR_ACCESS_TOKEN
    • xmaster config set keys.access_token_secret YOUR_ACCESS_TOKEN_SECRET
  • Verify configuration:
    • xmaster config check

Example code for setting up xmaster in OpenClaw:

---
name: xmaster
description: "X/Twitter operations via xmaster CLI: post, reply, thread, search, analyze, schedule, DMs, bookmarks, metrics."
metadata:
  openclaw:
    emoji: "𝕏"
    requires:
      bins: ["xmaster"]
    install:
      - id: brew
        kind: brew
        formula: xmaster
        tap: "199-biotechnologies/tap"
        bins: ["xmaster"]
        label: "Install xmaster (Homebrew)"
      - id: cargo
        kind: cargo
        crate: xmaster
        bins: ["xmaster"]
        label: "Install xmaster (cargo)"
---

Verification

To verify that xmaster is working correctly, run the following commands:

  • xmaster config check
  • xmaster post --help
  • xmaster search --help

Extra Tips

  • Make sure to replace YOUR_X_API_KEY, YOUR_X_API_SECRET, YOUR_ACCESS_TOKEN, and YOUR_ACCESS_TOKEN_SECRET with your actual X API credentials.
  • For optional features like AI-powered semantic search and bookmarks sync, follow the additional setup instructions in the xmaster documentation.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING