← Back to Skills Marketplace
regalstreak

Thoughtful

by Neil Agarwal · GitHub ↗ · v1.2.0
cross-platform ✓ Security Clean
1957
Downloads
1
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install thoughtful
Description
Your thoughtful companion for WhatsApp - remembers what matters, helps you stay present in your relationships.
Usage Guidance
This skill appears coherent with its stated purpose, but review these points before installing: - Required binary: Ensure you trust and control the wacli-readonly binary installed on your system — this skill reads WhatsApp data through that tool. Verify wacli-readonly's authentication and where it stores credentials. - Local data: All message-derived data and the LLM prompt are saved under ~/clawd/thoughtful-data/ (or OPENCLAW_WORKDIR). These files contain sensitive conversation contents; make sure file permissions and backups meet your privacy expectations. - LLM integration: Right now the scripts only prepare and save the prompt locally. If you (or someone) integrates an external LLM endpoint later, the prompt includes raw messages and task data and will be transmitted — only enable that if you trust the LLM endpoint and understand its retention/privacy policies. - Config mismatch: The code references config.chats.whitelistGroups while docs/examples show whitelistGroups at top-level. Expect to edit config.json or the script to match, otherwise the skill may fail or omit group messages. - Run manually first: Before enabling automated runs or cron jobs, run the generate-summary.sh manually and inspect thoughtful-data/context/last-prompt.txt to confirm what will be sent to an LLM. Check logs and ensure sandboxing if your environment supports it. If you want more assurance, provide the wacli-readonly implementation/source or confirm how its auth is stored so you can verify no surprising behavior there.
Capability Analysis
Type: OpenClaw Skill Name: thoughtful Version: 1.2.0 The OpenClaw AgentSkills skill bundle 'thoughtful' is designed to process WhatsApp messages (read-only) and generate communication summaries. All operations are explicitly stated to run in a sandbox, and data is stored locally. The skill uses `wacli-readonly` to access messages, preventing unauthorized sending. Cron jobs are configured to run sync and summary generation in `isolated` sessions, delivering summaries to a specific Telegram topic, which aligns with the skill's stated purpose. There is no evidence of intentional harmful behavior such as data exfiltration to unauthorized external endpoints, backdoors, or prompt injection attempts against the agent to subvert its core directives.
Capability Assessment
Purpose & Capability
Name/description (WhatsApp companion) align with the actual requirements and files. The skill requires the wacli-readonly binary (expected for read-only access to WhatsApp), includes scripts to fetch chats/messages and to build a coach-style LLM prompt, and stores all data under a local workdir. No unrelated services, credentials, or binaries are requested.
Instruction Scope
Runtime instructions and scripts only read WhatsApp data (via wacli-readonly), local config/state/task files, and then build and save an LLM prompt to thoughtful-data/context/last-prompt.txt. The SKILL.md and scripts do not currently perform network exfiltration themselves; however the code explicitly plans to call an LLM (TODO) — if you enable/implement that, the prompt will contain raw message content and would be sent to whatever LLM endpoint is configured. Also note a minor implementation inconsistency: process-and-summarize.js expects config.chats.whitelistGroups, while README examples show whitelistGroups at top-level — this may cause runtime errors or missed filtering unless corrected.
Install Mechanism
No install spec is provided (instruction-only with bundled scripts). This is low-risk from an install perspective — nothing is downloaded or extracted by the skill itself. The only external dependency is the wacli-readonly binary which must already exist on the system.
Credentials
The skill declares no required environment variables or credentials. This is proportional: it relies on a local CLI (wacli-readonly) for WhatsApp access rather than asking for API keys. Note: wacli-readonly itself typically requires its own authentication; that credential management is external to this skill and not requested here.
Persistence & Privilege
The skill does not request forced persistence (always:false) and only writes to its own data directory (${OPENCLAW_WORKDIR:-$HOME/clawd}/thoughtful-data). It doesn't modify other skills or system-wide configs. Agent autonomous invocation is allowed by default but is not combined with elevated privileges here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install thoughtful
  3. After installation, invoke the skill by name or use /thoughtful
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
Updated: Enhanced SKILL.md documentation with 3x daily sync schedule, cron setup details, and improved first-time setup flow
v1.1.0
Updated cron schedule to 3x daily (11 AM, 6 PM, 11 PM) with separate sync crons running 30 min before each summary. Improved documentation for better WhatsApp message coverage throughout the day.
v1.0.0
Initial release of Thoughtful: your WhatsApp relationship assistant. - Tracks pending tasks, commitments, and important dates from your chats. - Provides emotionally intelligent communication coaching and relationship insights. - Generates daily, conversational summaries with actionable next steps and conversation starters. - Interactive, chat-based setup for configuring tracked groups, priority contacts, and summary timing. - All processing runs securely in a sandbox; no manual file editing required. - Example summary included to demonstrate key features and summary style.
Metadata
Slug thoughtful
Version 1.2.0
License
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is Thoughtful?

Your thoughtful companion for WhatsApp - remembers what matters, helps you stay present in your relationships. It is an AI Agent Skill for Claude Code / OpenClaw, with 1957 downloads so far.

How do I install Thoughtful?

Run "/install thoughtful" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Thoughtful free?

Yes, Thoughtful is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Thoughtful support?

Thoughtful is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Thoughtful?

It is built and maintained by Neil Agarwal (@regalstreak); the current version is v1.2.0.

💬 Comments