360 Secure SkillHub
360 安全技能中心

Storyclaw X Manager

该工具用于管理X(原Twitter)账号,核心功能包括发布带媒体的推文、点赞/回复/转推等互动操作,以及查询时间线、搜索推文、获取用户推文;支持配置自动互动规则。需绑定X账号API凭证,通过Python脚本调用,适用于账号运营、批量互动等场景,内置限流、认证失败等错误处理逻辑。

patches429
patches429
热度 55.58
最近更新 2026-05-18 12:22:19
分类:自动化依赖:代码执行 / 第三方 API应用场景:社交媒体 / 自动化脚本 / 数据处理

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add storyclaw-x-manager
Metadata
name
storyclaw-x-manager
version
0.1.0
description
Manage X (Twitter) accounts — post tweets, like, reply, retweet, view timeline, search, auto-interact, analyze data.
metadata
{"openclaw":{"emoji":"🐦","requires":{"bins":["python3"],"env":["TWITTER_API_KEY","TWITTER_API_SECRET","TWITTER_ACCESS_TOKEN","TWITTER_ACCESS_TOKEN_SECRET","TWITTER_BEARER_TOKEN"]},"primaryEnv":"TWITTER_API_KEY"}}

X Manager - Twitter/X Account Management

Manage X (formerly Twitter) accounts: posting, engagement, timeline, and analytics.

Multi-User Architecture

Each user's credentials are stored in credentials/{USER_ID}.json:

{
  "twitter": {
    "api_key": "",
    "api_secret": "",
    "access_token": "",
    "access_token_secret": "",
    "bearer_token": ""
  }
}

If user has no Twitter credentials configured, prompt them to bind their X account first.

Or set env vars: TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_TOKEN_SECRET, TWITTER_BEARER_TOKEN.

Supported Operations

1. Post Tweet

python3 {baseDir}/scripts/post_tweet.py <USER_ID> "<tweet content>" [--media <image_path>]

Max 280 characters. Longer tweets auto-split for Premium/Enterprise accounts.

2. Engagement

Like:

python3 {baseDir}/scripts/like_tweet.py <USER_ID> <tweet_id>

Reply:

python3 {baseDir}/scripts/reply_tweet.py <USER_ID> <tweet_id> "<reply content>"

Retweet:

python3 {baseDir}/scripts/retweet.py <USER_ID> <tweet_id>

3. Data Retrieval

User tweets:

python3 {baseDir}/scripts/get_user_tweets.py <USER_ID> <twitter_handle> [--count <n>]

Timeline:

python3 {baseDir}/scripts/get_timeline.py <USER_ID> [--count <n>]

Search:

python3 {baseDir}/scripts/search_tweets.py <USER_ID> "<keywords>" [--count <n>]

Auto-Interaction Workflow

Configure in state/{USER_ID}.json:

{
  "auto_reply": {
    "enabled": true,
    "keywords": ["keyword1", "keyword2"],
    "reply_template": "Thanks {username} for {keyword}!"
  }
}

Error Handling

  • API rate limit: prompt user to wait and retry
  • Auth failure: prompt user to rebind X account
  • Tweet too long: auto-split or prompt user to shorten

Twitter API Tiers

  • Free: read only, no posting
  • Premium ($100/month): post + analytics
  • Enterprise: higher limits