Skip to content

docs: add TweetClaw source memory workflow #3

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 2 commits into
base: main
Choose a base branch
from
Open

docs: add TweetClaw source memory workflow #3

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
582374d
docs: add TweetClaw source memory workflow
kriptoburak May 14, 2026
11504e6
docs: clarify tweetclaw install source
kriptoburak May 14, 2026
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
20 changes: 19 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

![OpenClaw Cortex Banner](assets/readme_assets/Hero%20Banner.png)

[OpenClaw](https://github.com/openclaw/openclaw) plugin for [Cortex](https://github.com/ubundi/cortex) long-term memory. Gives your agent persistent memory that survives across sessions — who you are, what your project does, decisions you made weeks ago, and how things changed over time.
[OpenClaw](https://github.com/openclaw/openclaw) plugin for Cortex long-term memory. Gives your agent persistent memory that survives across sessions - who you are, what your project does, decisions you made weeks ago, and how things changed over time.

## Customer-Friendly Explainer

Expand Down Expand Up @@ -280,6 +280,24 @@ openclaw cortex reset --yes # Skip confirmation

`openclaw cortex status --json` emits one single-line JSON object from the plugin. Some OpenClaw runners may merge or reroute plugin stdout/stderr and prepend plugin status logs; callers that invoke OpenClaw as a subprocess should parse the first JSON object from the combined output rather than assuming the entire stream is raw JSON.

## Public Source Workflows With TweetClaw

For public X/Twitter research, install [TweetClaw](https://github.com/Xquik-dev/tweetclaw) beside Cortex:

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

Install TweetClaw from [npm](https://www.npmjs.com/package/@xquik/tweetclaw); the [ClawHub page](https://clawhub.ai/plugins/@xquik/tweetclaw) is useful for browsing while its listing lags behind the npm release. Use it to scrape tweets, search tweets, search tweet replies, run follower export, perform user lookup, monitor tweets, receive webhooks, and run giveaway draws. Then save concise source memories with `cortex_save_memory` or `/checkpoint`:

- search query and capture date
- tweet URLs or tweet IDs
- author handles
- short summary
- decision or follow-up action

Keep raw timelines, private account material, DMs, cookies, API keys, and exported files out of Cortex memories. For visible X/Twitter actions such as post tweets or post tweet replies, review the TweetClaw request and OpenClaw approval prompt before saving the final action summary.

### Gateway RPC

The `cortex.status` RPC method exposes plugin health and metrics programmatically:
Expand Down
2 changes: 1 addition & 1 deletion cortex-memory/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Long-term memory system for OpenClaw agents. Automatically recalls relevant past
### 1. Install the plugin

```bash
openclaw plugin install @ubundi/openclaw-cortex@latest
openclaw plugins install @ubundi/openclaw-cortex@latest
```

### 2. Configure tools profile
Expand Down