Skip to content

Document TweetClaw as an OpenClaw Twitter option#8

Open
kriptoburak wants to merge 2 commits into
EthanAlgoX:mainfrom
kriptoburak:codex/add-tweetclaw-twitter-option
Open

Document TweetClaw as an OpenClaw Twitter option#8
kriptoburak wants to merge 2 commits into
EthanAlgoX:mainfrom
kriptoburak:codex/add-tweetclaw-twitter-option

Conversation

@kriptoburak
Copy link
Copy Markdown

@kriptoburak kriptoburak commented May 18, 2026

Summary

  • Add a bilingual optional TweetClaw section beside the existing Twitter CLI integration.
  • Explain when MarketBot users may prefer the OpenClaw plugin path for scraping tweets, searching tweet replies, follower export, media workflows, monitors, webhooks, giveaway draws, and reviewed posting.
  • Replace the stale OpenClaw skills archive link with the live skills.sh OpenClaw directory.
  • Address Gemini review wording for parallel phrasing in the new docs.

Validation

  • diff whitespace check passed
  • added-line dash scan passed
  • added-line sensitive-string scan passed
  • edited-doc link sweep checked 10 external links with 10 OK
  • npm metadata readback returned @xquik/tweetclaw 1.6.31

Tests were not run because this is a docs-only change.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces documentation for the TweetClaw plugin in the main README (both English and Chinese versions) and the skills README, providing an API-key-based alternative for Twitter/X workflows. It also updates a URL for external skill suggestions. Review feedback focused on improving grammatical consistency and phrasing within the new documentation, specifically suggesting the use of gerunds for feature lists and more idiomatic terms for manually reviewed actions.

Comment thread marketbot/skills/README.md Outdated
Comment on lines +13 to +16
`openclaw plugins install @xquik/tweetclaw`. It covers scrape tweets, search
tweets, search tweet replies, follower export, user lookup, media workflows,
monitor tweets, webhooks, giveaway draws, and approval-reviewed post or reply
actions.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The list of features in this paragraph is grammatically inconsistent, mixing verb phrases (e.g., "scrape tweets") with noun phrases (e.g., "follower export"). Additionally, "It covers scrape tweets" is grammatically incorrect. Using gerunds (e.g., "scraping") for actions would improve parallelism and readability.

Suggested change
`openclaw plugins install @xquik/tweetclaw`. It covers scrape tweets, search
tweets, search tweet replies, follower export, user lookup, media workflows,
monitor tweets, webhooks, giveaway draws, and approval-reviewed post or reply
actions.
`openclaw plugins install @xquik/tweetclaw`. It supports scraping tweets, searching
tweets, searching tweet replies, follower export, user lookup, media workflows,
monitoring tweets, webhooks, giveaway draws, and manually reviewed post or reply
actions.

Comment thread README_en.md Outdated
- scrape tweets, search tweets, and search tweet replies
- follower export, user lookup, media upload, and media download
- monitor tweets, webhooks, and giveaway draws
- approval-reviewed post tweets and post tweet replies
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The phrase "approval-reviewed post tweets" is awkward and grammatically non-standard. Based on the Chinese version ("需要人工确认的"), "manually reviewed" or "approval-gated" would be clearer and more idiomatic.

Suggested change
- approval-reviewed post tweets and post tweet replies
- manually reviewed posting of tweets and replies

Comment thread README.md Outdated

将 Xquik API key 放在 OpenClaw 或 MarketBot 的本地配置里,不要提交到仓库。
`twitter-cli` 仍适合本机 cookie 驱动的轻量读取;TweetClaw 更适合需要
OpenClaw plugin 安装、结构化返回数据和可复用 agent tool 的场景。
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The term "agent tool" should be pluralized to "agent tools" to maintain consistency with the English version of the README and to more accurately reflect the multiple tool capabilities provided by the plugin.

Suggested change
OpenClaw plugin 安装、结构化返回数据和可复用 agent tool 的场景。
OpenClaw plugin 安装、结构化返回数据和可复用 agent tools 的场景。

@kriptoburak
Copy link
Copy Markdown
Author

Pushed 5e34331 to address the Gemini wording feedback and updated the PR body validation notes.

I also checked the failing label workflow log. It fails before labeling with Input required and not supplied: private-key from actions/create-github-app-token, so this appears to be target workflow secret availability on a fork PR rather than a docs failure.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant