smart-followups – OpenClaw Skill

---

name: smart-followups version: 2.1.1 description: Generate contextual follow-up suggestions after AI responses. Shows 3 clickable buttons (Quick, Deep Dive, Related) when user types "/followups". metadata: {"clawdbot":{"requires":{"bins":["node"],"env":["OPENROUTER_API_KEY","ANTHROPIC_API_KEY"]}}} triggers:

• /followups
• followups
• follow-ups
• suggestions
• give me suggestions
• what should I ask commands:
• name: followups description: Generate 3 smart follow-up suggestions based on conversation context aliases: [fu, suggestions, next] channels:
• telegram
• discord
• slack
• signal
• whatsapp
• imessage
• sms
• matrix
• email

---

Smart Follow-ups Skill

Generate contextual follow-up suggestions for OpenClaw conversations.

🚀 Slash Command (New in v2.1.0!)

Primary command:

/followups

Aliases:

/fu
/suggestions

When you type /followups, I'll generate 3 contextual follow-up questions based on our conversation:

1. ⚡ Quick — Clarification or immediate next step
2. 🧠 Deep Dive — Technical depth or detailed exploration
3. 🔗 Related — Connected topic or broader context

---

How to Trigger

Method	Example	Recommended
/followups	Just type it!	✅ Yes
/fu	Short alias	✅ Yes
Natural language	"give me suggestions"	Works too
After any answer	"what should I ask next?"	Works too

Usage

Say "followups" in any conversation:

You: What is Docker?
Bot: Docker is a containerization platform...

You: /followups

Bot: 💡 What would you like to explore next?
[⚡ How do I install Docker?]
[🧠 Explain container architecture]
[🔗 Docker vs Kubernetes?]

On button channels (Telegram/Discord/Slack): Tap a button to ask that question.

On text channels (Signal/WhatsApp/iMessage/SMS): Reply with 1, 2, or 3.

Categories

Each generation produces 3 suggestions:

Category	Emoji	Purpose
Quick	⚡	Clarifications, definitions, immediate next steps
Deep Dive	🧠	Technical depth, advanced concepts, thorough exploration
Related	🔗	Connected topics, broader context, alternatives

Authentication

Default: Uses OpenClaw's existing auth — same login and model as your current chat.

Optional providers:

• openrouter — Requires OPENROUTER_API_KEY
• anthropic — Requires ANTHROPIC_API_KEY

Configuration

{
  "skills": {
    "smart-followups": {
      "enabled": true,
      "provider": "openclaw",
      "model": null
    }
  }
}

Option	Default	Description
provider	"openclaw"	Auth provider: openclaw, openrouter, anthropic
model	null	Model override (null = inherit from session)
apiKey	—	API key for non-openclaw providers

Channel Support

Channel	Mode	Interaction
Telegram	Buttons	Tap to ask
Discord	Buttons	Click to ask
Slack	Buttons	Click to ask
Signal	Text	Reply 1-3
WhatsApp	Text	Reply 1-3
iMessage	Text	Reply 1-3
SMS	Text	Reply 1-3
Matrix	Text	Reply 1-3
Email	Text	Reply with number

See CHANNELS.md for detailed channel documentation.

How It Works

1. User types /followups
2. Handler captures recent conversation context
3. OpenClaw generates 3 contextual questions (using current model/auth)
4. Formatted as buttons or text based on channel
5. User clicks button or replies with number
6. OpenClaw answers that question

Files

File	Purpose
handler.js	Command handler and channel formatting
cli/followups-cli.js	Standalone CLI for testing/scripting
README.md	Full documentation
CHANNELS.md	Channel-specific guide
FAQ.md	Common questions

Credits

Inspired by Chameleon AI Chat's smart follow-up feature.

💡 Smart Follow-ups

🦎 A OpenClaw Skill

Generate contextual follow-up suggestions for your AI conversations

<p align="center"> <a href="https://openclaw.com"><img src="https://img.shields.io/badge/🦎_OpenClaw-Skill-7c3aed?style=for-the-badge" alt="OpenClaw Skill"></a> <a href="https://clawhub.ai/skills/smart-followups"><img src="https://img.shields.io/badge/ClawHub-Install-22c55e?style=for-the-badge" alt="ClawHub"></a> </p> <p align="center"> <img src="https://img.shields.io/badge/version-2.0.1-orange?style=flat-square" alt="Version"> <img src="https://img.shields.io/badge/channels-9-blue?style=flat-square" alt="Channels"> <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License"> </p>

---

This is a skill for OpenClaw — the AI assistant that works across Telegram, Discord, Signal, WhatsApp, and more.

After every AI response, get 3 smart suggestions for what to ask next:

• ⚡ Quick — Clarifications and immediate questions
• 🧠 Deep Dive — Technical depth and detailed exploration
• 🔗 Related — Connected topics and broader context

Telegram/Discord/Slack: Clickable inline buttons
Signal/iMessage/SMS: Numbered text list

---

✨ Features

• 🎯 Context-Aware — Analyzes your last 1-3 exchanges
• 🔘 Interactive Buttons — One tap to ask (Telegram, Discord, Slack)
• 📝 Text Fallback — Numbered lists for channels without buttons
• ⚡ Fast — ~2 second generation time
• 🔐 Privacy-First — Uses your existing OpenClaw auth by default
• 🔧 Flexible — Multiple provider options (see below)

---

🦎 What is OpenClaw?

OpenClaw is a powerful AI assistant that connects Claude to your favorite messaging apps — Telegram, Discord, Signal, WhatsApp, iMessage, and more. Skills extend OpenClaw with new capabilities.

Not using OpenClaw yet? Check out openclaw.com to get started!

---

🚀 Quick Start

Installation

# Via ClawHub (recommended)
clawhub install smart-followups

# Or manually
cd /path/to/openclaw/skills
git clone https://github.com/robbyczgw-cla/smart-followups
cd smart-followups
npm install

Usage

Just say "followups" (or "give me follow-ups", "suggestions") in any OpenClaw conversation:

You: What is Docker?
Bot: Docker is a containerization platform that...

You: followups

Bot: 💡 What would you like to explore next?
[⚡ How do I install Docker?]
[🧠 Explain container architecture]
[🔗 Docker vs Kubernetes?]

Click any button → sends that question automatically!

Note: This works as a keyword the agent recognizes, not as a registered /slash command. OpenClaw skills are guidance docs — the agent reads the SKILL.md and knows how to respond when you ask for follow-ups.

---

🔐 Authentication Options

Option 1: OpenClaw Native (Default) ⭐

Uses your existing OpenClaw authentication — same model and login as your current chat.

• ✅ No additional API keys needed
• ✅ Uses your current session's model (Haiku/Sonnet/Opus)
• ✅ Works out of the box

{
  "skills": {
    "smart-followups": {
      "provider": "openclaw"
    }
  }
}

Option 2: OpenRouter

Use OpenRouter for model access. Requires API key.

{
  "skills": {
    "smart-followups": {
      "provider": "openrouter",
      "apiKey": "${OPENROUTER_API_KEY}",
      "model": "anthropic/claude-sonnet-4.5"
    }
  }
}

Get an OpenRouter API key: openrouter.ai/keys

Option 3: Direct Anthropic

Use Anthropic's API directly. Requires API key.

{
  "skills": {
    "smart-followups": {
      "provider": "anthropic",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "model": "claude-sonnet-4-5"
    }
  }
}

Get an Anthropic API key: console.anthropic.com

---

⚙️ Configuration

Add to your openclaw.json:

{
  "skills": {
    "smart-followups": {
      "enabled": true,
      "provider": "openclaw",
      "model": null,
      "autoTrigger": false
    }
  }
}

Option	Default	Description
enabled	true	Enable/disable the skill
provider	"openclaw"	Auth provider: openclaw, openrouter, anthropic
model	null	Model override (null = inherit from session)
apiKey	—	API key for openrouter/anthropic providers
autoTrigger	false	Auto-show follow-ups after every response

---

📱 Channel Support

Works on every OpenClaw channel with adaptive formatting:

Channel	Mode	Interaction
Telegram	Inline buttons	Tap to ask
Discord	Inline buttons	Click to ask
Slack	Inline buttons	Click to ask
Signal	Text list	Reply 1, 2, or 3
WhatsApp	Text list	Reply 1, 2, or 3
iMessage	Text list	Reply 1, 2, or 3
SMS	Text list	Reply 1, 2, or 3
Matrix	Text list	Reply 1, 2, or 3
Email	Text list	Reply with number

📖 See CHANNELS.md for detailed channel-specific documentation.

---

🛠️ CLI Tool (Optional)

A standalone CLI is included for testing and scripting:

# Set API key (OpenRouter or Anthropic)
export OPENROUTER_API_KEY="sk-or-..."

# Generate follow-ups from JSON context
echo '[{"user":"What is Docker?","assistant":"Docker is..."}]' | \
  followups-cli --mode text

# Output modes: json, telegram, text, compact
followups-cli --mode telegram < context.json

See followups-cli --help for all options.

---

📖 Examples

Telegram Buttons

💡 What would you like to explore next?

[⚡ How do I install Docker?        ]
[🧠 Explain Docker's architecture   ]
[🔗 Compare Docker to Kubernetes    ]

Signal Text Mode

💡 Smart Follow-up Suggestions

⚡ Quick
1. How do I install Docker?

🧠 Deep Dive
2. Explain Docker's architecture

🔗 Related
3. Compare Docker to Kubernetes

Reply with 1, 2, or 3 to ask that question.

---

❓ FAQ

Why 3 suggestions instead of 6?

Cleaner UX, especially on mobile. Each category (Quick, Deep, Related) gets one focused suggestion instead of overwhelming you with options.

Can I use this without OpenClaw?

Yes! The CLI tool works standalone with OpenRouter or Anthropic API keys. But the best experience is integrated with OpenClaw.

How does it know what to suggest?

The skill analyzes your last 1-3 message exchanges and generates contextually relevant questions across three categories: quick clarifications, deep technical dives, and related topics.

Will it work with my custom model?

Yes! With provider: "openclaw" (default), it uses whatever model your current chat is using. With other providers, specify the model in config.

Is my conversation data sent anywhere?

With OpenClaw native: Same privacy as your normal chat — processed by your configured AI provider.

With OpenRouter/Anthropic: Your recent exchanges are sent to generate suggestions. See their respective privacy policies.

How much does it cost?

• OpenClaw native: Uses your existing chat's API usage
• OpenRouter/Anthropic: ~$0.001-0.01 per generation depending on model

---

🏗️ Project Structure

smart-followups/
├── cli/
│   └── followups-cli.js    # Standalone CLI tool
├── handler.js              # OpenClaw command handler
├── package.json
├── README.md               # This file
├── SKILL.md                # OpenClaw skill manifest
├── FAQ.md                  # Frequently asked questions
├── INTERNAL.md             # Development notes
├── CHANGELOG.md            # Version history
└── LICENSE                 # MIT License

---

🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md first.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test across multiple channels
5. Submit a pull request

---

📄 License

MIT © Robby

---

🙏 Credits

• Inspired by Chameleon AI Chat's smart follow-up feature
• Built for the OpenClaw ecosystem
• Powered by Claude

---

Made with 🦎 by the OpenClaw community