WhatsApp FAQ 机器人:Markdown 知识库 - Openclaw Skills
作者:互联网
2026-04-01
什么是 WhatsApp FAQ 机器人?
WhatsApp FAQ 机器人是一项技术技能,旨在消除静态文档与交互式客户支持之间的差距。通过在 Openclaw Skills 生态系统中使用此工具,开发人员可以将标准 Markdown 文件转换为可搜索的数据库,利用模糊文本匹配将用户查询与最相关的答案配对。
该技能提供了一个强大的 CLI 界面,用于管理知识库的生命周期,从初始化和批量导入到精细搜索。它特别适合希望在不增加复杂数据库管理开销的情况下实现 WhatsApp 业务交互自动化的团队,而是依赖于干净、易读的 Markdown 格式。
下载入口:https://github.com/openclaw/skills/tree/main/skills/mariusfit/whatsapp-faq-bot
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install whatsapp-faq-bot
2. 手动安装
将技能文件夹复制到以下位置之一
全局模式~/.openclaw/skills/
工作区
/skills/
优先级:工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 whatsapp-faq-bot。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。
WhatsApp FAQ 机器人 应用场景
- 通过提供即时的 FAQ 答案,为 WhatsApp Business 机器人自动化客户支持。
- 为内部技术文档创建可搜索的命令行知识库。
- 将现有的基于 Markdown 的文档迁移为交互式代理就绪格式。
- 通过基于自然语言查询的自动响应,扩展小型企业的客户服务。
- 用户使用 init 命令初始化本地知识库以准备存储结构。
- 通过导入 Markdown 文件来摄取知识,其中 H2 标题代表问题,随后的正文代表答案。
- 当代理收到查询时,它调用应用类 TF-IDF 模糊匹配算法的搜索函数。
- 系统为所有潜在匹配计算 0.0 到 1.0 之间的置信度分数。
- 该技能根据配置的阈值返回排名靠前的匹配答案。
- 管理员可以通过列表、删除或将条目导出回 JSON 或 Markdown 格式来管理数据。
WhatsApp FAQ 机器人 配置指南
要在 Openclaw Skills 环境中开始使用此技能,请按照以下安装和初始化步骤操作:
# 初始化新的 FAQ 知识库
python scripts/faqbot.py init
# 导入现有的 FAQ Markdown 文件
python scripts/faqbot.py import faq-source.md
# 测试搜索功能
python scripts/faqbot.py search "How do I contact support?"
WhatsApp FAQ 机器人 数据架构与分类体系
该技能通过将 Markdown 结构映射到可搜索索引来组织数据。该架构针对检索速度和准确性进行了优化:
| 元素 | 格式 | 来源 |
|---|---|---|
| 问题 | 字符串 | 从 H2 Markdown 标题中提取 |
| 答案 | 字符串 | 从 Markdown 内容正文中提取 |
| ID | 整数 | 自动生成的唯一标识符 |
| 标签 | 数组 | 用于过滤的可选元数据 |
| 分数 | 浮点数 | 搜索期间的动态计算 (0.0-1.0) |
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 |
|
Import FAQs from markdown (H2 = question, body = answer) |
search |
|
Find best matching answer(s) |
list |
[--tag TAG] |
List all FAQ entries |
remove |
|
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.
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
HealthClaw 牙科:AI 驱动的牙科诊所管理 - Openclaw Skills
ERPClaw 销售:AI 订单到现金全生命周期管理 - Openclaw Skills
ERPClaw 欧盟区域合规:增值税、OSS 和电子发票 - Openclaw Skills
ERPClaw 人事:AI 人力资源与美国薪酬管理 - Openclaw Skills
erpclaw-journals:安全且AI原生的簿记系统 - Openclaw Skills
ERPClaw Growth:AI CRM 与业务分析 - Openclaw Skills
ERPClaw Billing:基于用量与计量的计费 - Openclaw Skills
educlaw: AI 原生教育与 SIS 管理 - Openclaw Skills
EduClaw K-12 扩展组件:学生管理与合规 - Openclaw Skills
AuditClaw AWS:自动化 AWS 合规证据收集 - Openclaw Skills
AI精选
