← Back to Skills Marketplace
265
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install storyclaw-x-manager
Description
Manage X (Twitter) accounts — post tweets, like, reply, retweet, view timeline, search, auto-interact, analyze data.
Usage Guidance
What to consider before installing:
- The code implements the advertised X/Twitter actions and talks only to api.twitter.com, but the skill is sloppy about how it expects credentials. It declares required TWITTER_* env vars in metadata but the Python scripts ignore environment variables and instead load plaintext credentials from credentials/{USER_ID}.json. That means you must store Twitter tokens locally in that credentials/ folder for each user — which is sensitive and could be read by others with file access.
- There is no install script or dependency list. The scripts import 'requests' (and optionally 'twitterv2') but the skill won't install these for you; running will fail unless those Python packages are present.
- SKILL.md mentions auto-interaction and state/{USER_ID}.json configuration, but none of the provided scripts implement that. The presence of a 'bind at storyclaw.com' message in a script is suspicious/unclear (code does not contact that domain) — ask the author to clarify whether an external service is required or used.
- If you decide to use this skill: only supply tokens you can revoke, use minimal-permission tokens where possible, store credentials with restrictive file permissions, run the skill in an isolated environment (container or VM), review and/or remove references to external services, and consider modifying the code to read environment variables if you prefer not to keep plaintext credential files. If you need absolute assurance, request an updated version that: (1) consistently uses either env vars or credential files (not both), (2) documents and installs required Python packages, and (3) removes or explains any references to external domains such as storyclaw.com.
Capability Analysis
Type: OpenClaw Skill
Name: storyclaw-x-manager
Version: 0.1.0
The skill provides standard Twitter/X management capabilities including posting, liking, retweeting, and searching via the official Twitter API v2. The implementation uses the Python requests library to interact with legitimate Twitter endpoints (api.twitter.com) and stores user-provided credentials in a local directory as described in the documentation. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The scripts implement posting, liking, replying, retweeting, timeline, user tweets, and search via api.twitter.com, which matches the stated purpose. However the metadata and SKILL.md require environment variables (TWITTER_*), while the scripts consistently load per-user credentials from credentials/{USER_ID}.json and do not read os.environ. The primaryEnv is TWITTER_API_KEY, but the code primarily uses bearer_token (and sometimes multiple credentials), so the declared primary credential does not match runtime behavior.
Instruction Scope
SKILL.md instructs storing credentials in credentials/{USER_ID}.json (which code does), and describes an auto-interaction workflow using state/{USER_ID}.json — but none of the provided scripts read or write state/* or implement auto-interaction/analysis. The scripts make only requests to api.twitter.com endpoints (no hidden endpoints), and only read the credentials files under the skill directory. The SKILL.md also mentions prompting users to bind via an external domain (storyclaw.com) even though the code never contacts that domain.
Install Mechanism
There is no install spec (instruction-only skill), so nothing is automatically downloaded or executed at install time. Scripts rely on python3 and third-party Python packages (requests, optionally 'twitterv2') but there is no mechanism to install those; this is an operational omission rather than a direct installation risk.
Credentials
The skill declares five TWITTER_* environment variables as required and marks TWITTER_API_KEY as primary, yet the code does not read environment variables and instead expects per-user JSON credential files. Requesting all five env vars may be excessive or misleading because many script calls use only bearer_token; the declared env requirements therefore do not match how credentials are accessed at runtime. Also, the skill stores sensitive tokens in plaintext JSON files under credentials/, which raises confidentiality concerns if the host/workspace is shared.
Persistence & Privilege
always is false and the skill does not request persistent system-wide modifications or cross-skill config changes. It only reads credentials from its own credentials/ directory and runs ephemeral scripts; no elevated persistence is requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install storyclaw-x-manager - After installation, invoke the skill by name or use
/storyclaw-x-manager - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of storyclaw-x-manager.
- Manage X (Twitter) accounts: post tweets (with optional media), like, reply, retweet, view timelines, search tweets, and analyze data.
- Supports multi-user credential management, prompting users to connect their X account if not configured.
- Auto-interaction feature: automatically reply to tweets matching keywords with customizable templates.
- Handles errors for rate limits, authentication failures, and tweet length.
- Compatible with Free, Premium, and Enterprise API tiers, with features adapted to each tier’s capabilities.
Metadata
Frequently Asked Questions
What is Storyclaw X Manager?
Manage X (Twitter) accounts — post tweets, like, reply, retweet, view timeline, search, auto-interact, analyze data. It is an AI Agent Skill for Claude Code / OpenClaw, with 265 downloads so far.
How do I install Storyclaw X Manager?
Run "/install storyclaw-x-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Storyclaw X Manager free?
Yes, Storyclaw X Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Storyclaw X Manager support?
Storyclaw X Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Storyclaw X Manager?
It is built and maintained by Parker (@patches429); the current version is v0.1.0.
More Skills