WhatsApp FAQ Bot

Build and query a FAQ knowledge base from markdown files. Use when asked to create a FAQ bot, set up automatic answers, build a knowledge base, add FAQ entries, search FAQs, or answer common questions from a knowledge base. Perfect for WhatsApp business bots.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install whatsapp-faq-bot

WhatsApp FAQ Bot

Build a searchable knowledge base from markdown files. Match incoming questions to the best FAQ answer using fuzzy text matching.

Quick Start

# Initialize a new FAQ knowledge base
python scripts/faqbot.py init

# Add a FAQ entry interactively
python scripts/faqbot.py add -q "What are your business hours?" -a "We are open Monday to Friday, 9 AM to 6 PM CET."

# Import FAQs from a markdown file
python scripts/faqbot.py import faq-source.md

# Search for the best matching answer
python scripts/faqbot.py search "when are you open"

# List all FAQ entries
python scripts/faqbot.py list

# Export all FAQs to markdown
python scripts/faqbot.py export --format md -o faqs-export.md

# Export as JSON
python scripts/faqbot.py export --format json -o faqs.json

# Remove a FAQ entry by ID
python scripts/faqbot.py remove 3

# Get stats about the knowledge base
python scripts/faqbot.py stats

Commands

Command	Args	Description
`init`		Create a new empty knowledge base
`add`	`-q QUESTION -a ANSWER [-t TAGS]`	Add a single FAQ entry
`import`	`<file.md>`	Import FAQs from markdown (H2 = question, body = answer)
`search`	`<query> [--top N] [--threshold T]`	Find best matching answer(s)
`list`	`[--tag TAG]`	List all FAQ entries
`remove`	`<id>`	Remove a FAQ entry
`export`	`[--format md\|json] [-o FILE]`	Export knowledge base
`stats`		Show knowledge base statistics

Markdown Import Format

## What are your business hours?
We are open Monday to Friday, 9 AM to 6 PM CET.
Weekend support is available via email only.

## How do I reset my password?
Go to Settings > Account > Reset Password.
You will receive an email with a reset link.

## What payment methods do you accept?
We accept:
- Credit/debit cards (Visa, Mastercard)
- PayPal
- Bank transfer (EU only)

Each H2 heading becomes a question, the body below becomes the answer.

Search Scoring

Uses TF-IDF-like fuzzy matching on question text
Returns confidence score (0.0 to 1.0)
Default threshold: 0.3 (adjustable with --threshold)
Returns top 3 matches by default (adjustable with --top)

Integration with OpenClaw

This skill is designed to work as a WhatsApp FAQ bot. When a user asks a question, the agent can use the search command to find the best match and respond automatically. Configure it in your cron or agent system prompt.