From 3938ea77096547d1af6d870e305f1f6875f06ce9 Mon Sep 17 00:00:00 2001 From: kriptoburak Date: Sun, 17 May 2026 00:59:31 +0300 Subject: [PATCH] docs: add TweetClaw tool boundary example --- README.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/README.md b/README.md index 5ba82cc..5271c96 100644 --- a/README.md +++ b/README.md @@ -49,6 +49,40 @@ Important points: - It does not call an LLM for every message. - It does not send messages from the ingest path. +## Companion X/Twitter tools + +This plugin governs chat ingest and chat replies. It does not replace OpenClaw +tool allow-lists or review controls for plugins that call outside services. + +For example, an OpenClaw workspace can install +[TweetClaw](https://github.com/Xquik-dev/tweetclaw) for public X/Twitter +automation while this plugin keeps Discord, Telegram, or other chat channels +silent or recall-only: + +```sh +openclaw plugins install @xquik/tweetclaw +openclaw config set tools.alsoAllow '["explore", "tweetclaw"]' +``` + +Keep the responsibilities separate: + +- Use Extra Message Policy for channel ingest, raw recall, and reply + suppression. +- Use OpenClaw tool allow-lists and TweetClaw review controls for live + `tweetclaw` calls. +- Store only concise decisions, source URLs, tweet IDs, or follow-up notes in + raw recall. Do not write API keys, cookies, raw direct-message bodies, or raw + follower exports to JSONL or HTTP sinks. + +`explore` lets the agent inspect TweetClaw's endpoint catalog without a live API +call. `tweetclaw` performs Xquik-backed actions such as search tweets, search +tweet replies, follower export, user lookup, media upload, media download, +direct messages, monitor tweets, webhooks, giveaway draws, post tweets, and +post tweet replies. + +References: [npm package](https://www.npmjs.com/package/@xquik/tweetclaw) and +[ClawHub listing](https://clawhub.ai/plugins/@xquik/tweetclaw). + ## Config model ### `respond`