From 16f5e0a10536ab7fd4557f2b812857f86c660a63 Mon Sep 17 00:00:00 2001 From: kriptoburak Date: Mon, 18 May 2026 22:12:05 +0300 Subject: [PATCH 1/2] Document TweetClaw Twitter option for MarketBot --- README.md | 22 ++++++++++++++++++++++ README_en.md | 23 +++++++++++++++++++++++ marketbot/skills/README.md | 10 +++++++++- 3 files changed, 54 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index c887a4aa..874f08aa 100644 --- a/README.md +++ b/README.md @@ -914,6 +914,28 @@ marketbot agent -m "帮我总结一下 Twitter 上关于 NVDA 最新 guidance - 该 CLI 本质上依赖本机浏览器 cookie 或环境变量认证；如果 `twitter status` 不可用，先修复 CLI 登录态，不要先排查 MarketBot - Twitter/X 数据更适合做快信号和传播路径观察，不应替代公告、财报、交易所披露或正式新闻源 +### 6. 可选 OpenClaw TweetClaw 路径 + +如果你已经用 OpenClaw 管理 plugin，并希望把 Twitter/X 工作流走 API-key +配置，而不是依赖本机浏览器 cookie，可以单独安装 +[`TweetClaw`](https://github.com/Xquik-dev/tweetclaw)： + +```bash +openclaw plugins install @xquik/tweetclaw +``` + +适合把 MarketBot 的 `twitter-browser-research`、`sentiment-analysis`、 +`market-discovery` 和 `stock-watch` 工作流扩展到： + +- scrape tweets、search tweets、search tweet replies +- follower export、user lookup、media upload、media download +- monitor tweets、webhooks、giveaway draws +- 需要人工确认的 post tweets 和 post tweet replies + +将 Xquik API key 放在 OpenClaw 或 MarketBot 的本地配置里，不要提交到仓库。 +`twitter-cli` 仍适合本机 cookie 驱动的轻量读取；TweetClaw 更适合需要 +OpenClaw plugin 安装、结构化返回数据和可复用 agent tool 的场景。 + ## Skill 搜索与安装 可以先搜本地 skill，不够再回退到外部 curated skill 目录： diff --git a/README_en.md b/README_en.md index 7653b7f3..1d423bca 100644 --- a/README_en.md +++ b/README_en.md @@ -856,6 +856,29 @@ marketbot agent -m "Summarize the main Twitter discussion and overall sentiment - The CLI still depends on local browser cookies or environment-based auth; if `twitter status` fails, fix CLI authentication first instead of debugging MarketBot - Treat Twitter/X output as fast-signal context, not as a replacement for filings, exchange disclosures, or formal news sources +### 6. Optional OpenClaw TweetClaw path + +If you already manage plugins with OpenClaw and prefer an API-key Twitter/X +workflow instead of local browser cookies, install +[`TweetClaw`](https://github.com/Xquik-dev/tweetclaw) separately: + +```bash +openclaw plugins install @xquik/tweetclaw +``` + +Use it to extend MarketBot workflows such as `twitter-browser-research`, +`sentiment-analysis`, `market-discovery`, and `stock-watch` with: + +- 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 + +Keep the Xquik API key in local OpenClaw or MarketBot config, not in the repo. +`twitter-cli` remains useful for lightweight local cookie-backed reads; +TweetClaw is better when you need an OpenClaw plugin install, structured return +data, and reusable agent tools. + ## Skill Search and Install Search local skills first, then fall back to curated external catalogs: diff --git a/marketbot/skills/README.md b/marketbot/skills/README.md index 6c67f2b9..a3705017 100644 --- a/marketbot/skills/README.md +++ b/marketbot/skills/README.md @@ -4,9 +4,17 @@ This directory contains built-in skills that extend marketbot's capabilities. When no suitable local skill is selected, marketbot can also surface curated external suggestions from: -- `https://github.com/openclaw/skills` +- `https://skills.sh/openclaw` - `https://github.com/VoltAgent/awesome-openclaw-skills` +For X/Twitter workflows that need an OpenClaw plugin instead of local +browser-cookie tooling, use +[`TweetClaw`](https://github.com/Xquik-dev/tweetclaw) with +`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. + You can also search and install them with: ```bash From 5e34331e7ae06ed3b010ec4a87c2f7caca7b7ebc Mon Sep 17 00:00:00 2001 From: kriptoburak Date: Mon, 18 May 2026 22:19:37 +0300 Subject: [PATCH 2/2] Address TweetClaw docs review wording --- README.md | 2 +- README_en.md | 2 +- marketbot/skills/README.md | 8 ++++---- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 874f08aa..f7dd0d2c 100644 --- a/README.md +++ b/README.md @@ -934,7 +934,7 @@ openclaw plugins install @xquik/tweetclaw 将 Xquik API key 放在 OpenClaw 或 MarketBot 的本地配置里，不要提交到仓库。 `twitter-cli` 仍适合本机 cookie 驱动的轻量读取；TweetClaw 更适合需要 -OpenClaw plugin 安装、结构化返回数据和可复用 agent tool 的场景。 +OpenClaw plugin 安装、结构化返回数据和可复用 agent tools 的场景。 ## Skill 搜索与安装 diff --git a/README_en.md b/README_en.md index 1d423bca..1a8d9a4b 100644 --- a/README_en.md +++ b/README_en.md @@ -872,7 +872,7 @@ Use it to extend MarketBot workflows such as `twitter-browser-research`, - 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 +- approval-gated posting of tweets and replies Keep the Xquik API key in local OpenClaw or MarketBot config, not in the repo. `twitter-cli` remains useful for lightweight local cookie-backed reads; diff --git a/marketbot/skills/README.md b/marketbot/skills/README.md index a3705017..6e2702cf 100644 --- a/marketbot/skills/README.md +++ b/marketbot/skills/README.md @@ -10,10 +10,10 @@ When no suitable local skill is selected, marketbot can also surface curated ext For X/Twitter workflows that need an OpenClaw plugin instead of local browser-cookie tooling, use [`TweetClaw`](https://github.com/Xquik-dev/tweetclaw) with -`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. You can also search and install them with: