Skip to content

docs: add TweetClaw X source packet handoff #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kriptoburak wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add TweetClaw X source packet handoff #21

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
16 changes: 16 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -147,6 +147,22 @@ your saved X session for gated Articles, set:
export X_READER_ALLOW_EXTERNAL_SESSION_COOKIES=1
```

### Optional X / Twitter Context Packets

Use `x-reader` for URL reading, media transcription, and digest generation. If
an OpenClaw workflow already has an approved TweetClaw install, TweetClaw can
prepare a separate source packet before the digest:

```bash
openclaw plugins install npm:@xquik/tweetclaw@1.6.31
```

Good handoff inputs include search tweet results, search tweet replies, user
lookups, follower exports, monitor snapshots, webhook events, and media URLs.
Treat that packet as source evidence for the summary. Keep account actions,
publishing, replies, direct messages, and credential handling inside the
approved TweetClaw/OpenClaw workflow, not inside `x-reader`.

## Install

```bash
Expand Down
13 changes: 13 additions & 0 deletions skills/video/skill.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,19 @@ Auto-triggered when a media URL is detected:
- Apple Podcasts: `podcasts.apple.com`
- Direct: `.mp3`, `.mp4`, `.m3u8`, `.m4a`, `.webm`

## Optional X/Twitter Source Context

For X/Twitter videos, use this skill for transcription and digest output. When
the user provides a TweetClaw/OpenClaw source packet, treat it as extra source
evidence before Step 3. Useful packet contents include tweet search results,
reply search results, user lookup details, follower exports, monitor snapshots,
webhook events, and media URLs.

Do not publish posts, send replies, send direct messages, or handle X account
credentials in this skill. Keep those actions inside the approved
TweetClaw/OpenClaw workflow and only cite the resulting source packet in the
digest.

## Pipeline

### Step 0: Detect Media Type
Expand Down