← Back to Skills Marketplace
141
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install auto-customer-support
Description
自动化客服(基于 FAQ 的轻量检索回复 + 简单转人工/工单接口;支持 Webhook 接入、邮件/企业微信/工单系统集成与可选升级到 LLM 混合模式)。
README (SKILL.md)
自动化客服 Skill
本 Skill 提供一个可运行的客服自动化 scaffold,适合快速搭建轻量客服机器人并接入外部渠道。默认实现是基于 FAQ 的检索+模板回复,并提供转人工/工单的接口。
适用触发语(示例)
- “帮我自动回复客服消息”
- “把这个接入到微信/邮箱,遇不到答案就转人工”
- “给我一份客服 FAQ 的示例和测试对话”
快速功能概览
- 加载 CSV 格式的 FAQ(intent, question_variants, answer)
- 基于简单关键词/模糊匹配选择最佳答案并渲染模板
- 可配置信心阈值,低信心时自动标记为需人工或创建工单
- 提供 /webhook 接口用于接收消息并返回回复(JSON),以及 /escalate 用于转人工
目录结构(已创建)
- scripts/server.py — Flask webhook 服务(主运行脚本)
- data/faq.csv — 示例问答对
- assets/templates/auto-reply.txt — 回复模板示例(变量支持)
- references/integration-guides.md — 渠道/集成与凭证说明
- examples/sample_conversation.md — 示例对话与测试用例
运行(快速上手)
- 安装依赖:uv pip install flask
- 启动服务(开发): uv run python skills/auto-customer-support/scripts/server.py --port 5005
- 测试请求: curl -X POST http://localhost:5005/webhook -H "Content-Type: application/json" -d '{"message":"如何退款","sender":"user-123"}'
输出(示例)
- 成功匹配时返回:{ "reply": "...", "confidence": 0.95, "escalate": false }
- 未匹配或低置信时返回:{ "reply": "抱歉,我不确定……我们将转人工处理。", "confidence": 0.35, "escalate": true }
扩展与升级点
- 将检索层替换成向量搜索(FAISS/Chroma)并接入 LLM 以生成更自然的回答
- 增加对话上下文管理与会话状态
- 集成渠道(企业微信/微信客服/邮箱/Zendesk)并实现双向消息同步
隐私与安全
- 不要把生产 API Key、密码粘贴到对话中;在部署时使用环境变量或受限凭证文件
- 自动回复前在测试环境做 100% 验证,避免误发敏感信息
下一步
- 我可以立刻在 workspace 中创建并启动服务供你本地测试;或根据你要接入的渠道(微信/邮箱/Zendesk)帮你生成对接示例。
Usage Guidance
This skill appears to do what it says: a tiny FAQ-based webhook server. Before running or deploying it, consider: 1) Do NOT run the bundled server in production as-is — it starts Flask with debug=True and host=0.0.0.0, which can expose an interactive debugger and allow remote code execution if internet-accessible. Change debug=False and bind to localhost or run behind a proper WSGI server (gunicorn/uwsgi) and reverse proxy. 2) The code reads an optional CONFIDENCE_THRESHOLD env var but the metadata doesn't declare it — set it explicitly if you need a non-default value. 3) The integration guide mentions external credentials (WeChat/SMTP/Zendesk); those are not used by the sample code but will be required when you implement channel integrations — keep those secrets in environment variables or a secrets manager, and do not paste them into chat. 4) Treat the provided data and templates as examples only (remove sample data before production). 5) Fix the small packaging/run instructions (typo like 'uv pip install flask') and consider adding a proper install/run README and production deployment notes. If you plan to let the agent create/start the service in your workspace, make sure the workspace network exposure and runtime settings are appropriate (no public debug server).
Capability Analysis
Type: OpenClaw Skill
Name: auto-customer-support
Version: 1.0.0
The skill bundle provides a legitimate customer support automation scaffold using a Flask-based webhook and a CSV-backed FAQ system. The code in `scripts/server.py` implements simple keyword matching and provides endpoints for message handling and escalation, while `SKILL.md` and `references/integration-guides.md` offer clear instructions and security advice (e.g., avoiding hardcoded credentials). Although the server is configured to run with `debug=True` and binds to `0.0.0.0`, these are standard development settings for a scaffold and do not indicate malicious intent or intentional exploitation.
Capability Assessment
Purpose & Capability
The name/description (FAQ-based lightweight customer support + escalation) matches the files and code: a small Flask webhook server, sample FAQ CSV, reply template, and integration guidance. The included endpoints (/webhook, /escalate) and CSV-based matching implement the claimed functionality.
Instruction Scope
Runtime instructions tell the agent to install Flask and start the provided server. The server code runs app.run(host='0.0.0.0', debug=True) which exposes a debug-mode dev server to the network if run as-is — dangerous if deployed publicly. SKILL.md also offers to create/start the service in the workspace (fine for local testing) but could lead to accidental public exposure if the operator is not careful. The code does not read or transmit other local files or secrets beyond an optional CONFIDENCE_THRESHOLD env var.
Install Mechanism
This is an instruction-only skill with no install spec. The only dependency is Flask (install via pip). No remote downloads or extract operations are specified and code size is small.
Credentials
The skill metadata declares no required env vars, but the code reads CONFIDENCE_THRESHOLD from the environment if present. Integration guides mention external channel credentials (CorpID/Secret, SMTP creds, Zendesk tokens) but these are not required by this code — they would be needed only when you implement channel integrations. The discrepancy (undeclared optional env var) is minor but worth documenting.
Persistence & Privilege
The skill does not request permanent/always-on inclusion and does not modify other skills or system-wide settings. It only provides a local web service when run; the principal privilege/risk is network exposure from running the dev server, not any elevated platform privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install auto-customer-support - After installation, invoke the skill by name or use
/auto-customer-support - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
auto-customer-support 1.0.0
- 新增基于 FAQ 的自动化客服 scaffold:支持静态问答检索、模板回复
- 集成 /webhook 和 /escalate 接口,实现自动回复与工单转人工
- 支持加载 CSV 格式 FAQ,内置信心阈值与变量模板渲染
- 提供 Webhook、邮件、企业微信、工单系统等集成参考
- 含完整目录结构与本地开发/测试指引
- 明确列出扩展(向量检索、LLM混合、会话管理)与安全建议
Metadata
Frequently Asked Questions
What is auto-customer-support?
自动化客服(基于 FAQ 的轻量检索回复 + 简单转人工/工单接口;支持 Webhook 接入、邮件/企业微信/工单系统集成与可选升级到 LLM 混合模式)。 It is an AI Agent Skill for Claude Code / OpenClaw, with 141 downloads so far.
How do I install auto-customer-support?
Run "/install auto-customer-support" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is auto-customer-support free?
Yes, auto-customer-support is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does auto-customer-support support?
auto-customer-support is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created auto-customer-support?
It is built and maintained by xianji520 (@xianji520); the current version is v1.0.0.
More Skills