Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 tools 的场景。

## Skill 搜索与安装

可以先搜本地 skill,不够再回退到外部 curated skill 目录:
Expand Down
23 changes: 23 additions & 0 deletions README_en.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-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;
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:
Expand Down
10 changes: 9 additions & 1 deletion marketbot/skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 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:

```bash
Expand Down
Loading