tweetclaw

Files (5)

• BENCHMARK.md
• SKILL.md
• evals.json · evals/
• skill-card.md
• skillspector-report.md

SKILL.md (first lines)

# TweetClaw

Use TweetClaw as the Twitter bot plugin for OpenClaw. It posts, replies,
searches tweets, exports followers & monitors accounts through Xquik.

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.

## Install

```bash
openclaw plugins install clawhub:@xquik/tweetclaw
```

OpenClaw tracks the verified ClawHub package. Use
`openclaw plugins install npm:@xquik/tweetclaw` for the npm fallback.

Update through the tracked source.

```bash
openclaw plugins update tweetclaw
```

Pin production installs when reproducibility matters.

```bash
openclaw plugins install npm:@xquik/tweetclaw@<version> --pin
```

Pinned installs stay pinned. Run `openclaw plugins update @xquik/tweetclaw` to
return to the stable release line.

If `OPENCLAW_NIX_MODE=1`, install or update through the Nix source. OpenClaw
disables plugin lifecycle mutators in that mode.

Without credentials, `explore` works and live calls return setup guidance.

Verify the runtime.

```bash
openclaw plugins inspect tweetclaw --runtime --json
openclaw skills info tweetclaw
```

Confirm `explore`, optional `tweetclaw`, `before_tool_call`, and `xtrends`. If
the Gateway did not reload, run `openclaw gateway restart`. For slow checks, use
`OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1 openclaw plugins inspect tweetclaw --runtime --json`.
Timings go to stderr, so JSON remains valid.

## Trust profile

| Field | Value |
| --- | --- |
| Owner | Xquik |
| License | MIT-0 for Skill instructions. MIT for package code. |
| Use | User-authorized X/Twitter workflows through OpenClaw. |
| Geography | Global, subject to authorization, plan, law, platform rules, and organization policy. |
| Runtime | Optional `explore` and `tweetclaw` tools. One configured HTTPS API origin. No shell, browser, local network, filesystem, or MCP access. |
| Output | Markdown guidance, OpenClaw commands, endpoint descriptors, and structured API responses. |
| Risks | Public changes, private data, paid usage, recurring work, prompt injection, and credential exposure. |
| Mitigations | Per-call approval, cost limits, blocked admin routes, catalog checks, and untrusted-content isolation. |

## Safety rules

Use TweetClaw only for authorized accounts and lawful workflows. Refuse spam,
harassment, deceptive engagement, impersonation, credential collection,
platform evasion, unsolicited bulk messages, and bulk engagement campaigns.

Do this before visible, state-changing, paid, private, bulk, or recurring work.

1. Show the endpoint, account, target, action, and payload.
2. Show the final text and media list for public posts.
3. Show the current price, estimated cost, scope, and maximum result count.
4. Wait for explicit approval.

Ask again after any change to the account, target, text, media, limit, cost
ceiling, or recurrence. Never add claims, links, mentions, hashtags, or media
the user did not request.

The optional `tweetclaw` tool still prompts for one-time approval or deny after
the user enables it. Approval never grants durable trust.

Confirm account authorization before reading bookmarks, timelines,
notifications, DMs, connected accounts, or usage. Minimize private data in
responses and never pass it to unrelated tools.

MPP mode is read-only. If a user asks it to write or send a DM, refuse and
explain that the action needs an account-backed API key. Never print the MPP
signing key.

## Pricing

Use the [billing guide](https://docs.xquik.com/guides/billing) for current
account-backed charges. Use `mpp.price` from `explore` for direct MPP calls.
Confirm any amount returned by the API before payment.

- API keys can use prepaid credits across public paid-read routes.
- MPP pays for single lookups without an account.
- `explore` with `mpp` set to `true` lists every MPP route.
- Other paid reads and media downloads require account-backed access.

Install the optional MPP packages.

```bash
npm i mppx@0.13.4 viem@2.57.5
```

## Documentation

| Source | Use |
| --- | --- |
| [Documentation](https://docs.xquik.com) | Product and workflow guides |
| [API reference](https://docs.xquik.com/api-reference/overview) | Parameters and response shapes |
| [Read data richness](https://docs.xquik.com/guides/read-data-richness) | Tweet, profile, and media fields |
| [Billing](https://docs.xquik.com/guides/billing) | Current access and prices |

## Use TweetClaw for

- Twitter search, tweet lookup, user lookup, and timelines
- Posts, replies, deletes, likes, retweets, follows, and DMs

From Xquik-dev/tweetclaw, MIT-0.