WhatsApp FAQ Bot

通过 Python 命令行脚本管理本地 FAQ 知识库：支持初始化、增删条目、从 Markdown 导入、按标签列出、导出为 md/json 以及查看统计；查询时对问题文本做 TF-IDF 式模糊匹配，返回带置信度的最佳答案，可用于自动应答常见问题。

mariusfit

热度 62.80

最近更新 2026-05-17 12:38:25

分类：知识依赖：代码执行 / 读写文件应用场景：笔记整理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add whatsapp-faq-bot

Metadata

name: whatsapp-faq-bot
description: 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.

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.