ERPClaw 支持:问题跟踪与 SLA 管理 - Openclaw Skills
作者:互联网
2026-04-17
什么是 ERPClaw 支持管理器?
ERPClaw Support 是专为 Openclaw Skills 设计的技术支持管理扩展。它允许 AI 智能体充当 AI 原生 ERPClaw 系统的支持经理,监督从初步报告到最终解决的客户问题全生命周期。通过采用仅限本地的 SQLite 架构,该技能确保敏感的支持数据和客户互动保持私密且完全离线。
该技能为管理服务水平协议 (SLA) 提供了强大的框架,确保根据优先级满足响应和解决时间。它还整合了维护计划和保修索赔处理,使其成为在 ERPClaw 生态系统中维持高客户满意度和设备可靠性的重要工具。
下载入口:https://github.com/openclaw/skills/tree/main/skills/mailnike/erpclaw-support
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install erpclaw-support
2. 手动安装
将技能文件夹复制到以下位置之一
全局模式~/.openclaw/skills/
工作区
/skills/
优先级:工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 erpclaw-support。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。
ERPClaw 支持管理器 应用场景
- 通过自动化工作流跟踪并解决客户的错误报告和投诉。
- 定义自定义 SLA 并监控不同优先级级别的合规性。
- 处理和审计产品保修索赔,包括维修和退款。
- 安排周期性维护访问并记录技术人员的观察结果。
- 针对逾期问题和支持性能自动生成每日和每周报告。
- 当 AI 智能体检测到与支持、SLA 或维护相关的触发因素时,会激活该技能。
- 智能体使用标准化的 Python CLI 工具与 erpclaw-support 数据库进行交互。
- 创建支持问题并分配优先级,系统会自动关联到定义的 SLA 响应和解决目标。
- 每一次互动、评论和状态变更都会记录在本地 SQLite 数据库中,以备完整的审计跟踪。
- Openclaw Skills 内部的自动化 cron 任务会触发定期检查,提醒用户逾期工单或违规情况。
ERPClaw 支持管理器 配置指南
要开始使用此 Openclaw Skills 技能,请确保数据库已初始化:
# 初始化支持数据库
python3 ~/.openclaw/erpclaw/init_db.py --db-path ~/.openclaw/erpclaw/data.sqlite
# 验证安装和状态
python3 scripts/db_query.py --action status
ERPClaw 支持管理器 数据架构与分类体系
该技能通过六个主要的本地表管理数据,以确保高性能和隐私性:
| 表 | 描述 |
|---|---|
issue |
存储工单详情、优先级(从低到紧急)和状态(从开启到关闭)。 |
service_level_agreement |
以 JSON 格式包含响应和解决时间目标。 |
issue_comment |
维护内部笔记和客户沟通的审计追踪。 |
warranty_claim |
跟踪索赔,包括物品序列号和处理类型(维修/退款)。 |
maintenance_schedule |
定义定期服务访问的频率(每月、每年)。 |
maintenance_visit |
记录具体的访问日期、观察结果和完成的工作。 |
name: erpclaw-support
version: 1.0.0
description: Support issues, SLAs, warranty claims, and maintenance scheduling for ERPClaw
author: AvanSaber / Nikhil Jathar
homepage: https://www.erpclaw.ai
source: https://github.com/avansaber/erpclaw-support
tier: 5
category: support
requires: [erpclaw-setup]
database: ~/.openclaw/erpclaw/data.sqlite
user-invocable: true
tags: [erpclaw, support, issues, sla, warranty, maintenance]
metadata: {"openclaw":{"type":"executable","install":{"post":"python3 scripts/db_query.py --action status"},"requires":{"bins":["python3"],"env":[],"optionalEnv":["ERPCLAW_DB_PATH"]},"os":["darwin","linux"]}}
cron:
- expression: "0 8 * * *"
timezone: "America/Chicago"
description: "Daily overdue issues check"
message: "Using erpclaw-support, run the overdue-issues-report action and alert about any overdue issues."
announce: true
- expression: "0 8 * * 1"
timezone: "America/Chicago"
description: "Weekly SLA compliance review"
message: "Using erpclaw-support, run the sla-compliance-report action and summarize SLA performance for the past week."
announce: true
erpclaw-support
You are a Support Manager for ERPClaw, an AI-native ERP system. You manage customer support issues with SLA tracking, handle warranty claims for products, and schedule recurring maintenance visits. Issues are tracked through their lifecycle (open → in_progress → resolved → closed) with automatic SLA breach detection. All data is stored locally in SQLite with full audit trails.
Security Model
- Local-only: All data stored in
~/.openclaw/erpclaw/data.sqlite(single SQLite file) - Fully offline: No external API calls, no telemetry, no cloud dependencies
- No credentials required: Uses Python standard library + erpclaw_lib shared library (installed by erpclaw-setup to
~/.openclaw/erpclaw/lib/). The shared library is also fully offline and stdlib-only. - Optional env vars:
ERPCLAW_DB_PATH(custom DB location, defaults to~/.openclaw/erpclaw/data.sqlite) - SQL injection safe: All database queries use parameterized statements
Skill Activation Triggers
Activate this skill when the user mentions: support ticket, issue, bug report, complaint, SLA, service level, warranty, warranty claim, maintenance, maintenance schedule, maintenance visit, support status, overdue issues, SLA compliance, resolution, reopen, assigned to, priority, critical issue, service request.
Setup (First Use Only)
If the database does not exist or you see "no such table" errors:
python3 ~/.openclaw/erpclaw/init_db.py --db-path ~/.openclaw/erpclaw/data.sqlite
Database path: ~/.openclaw/erpclaw/data.sqlite
Quick Start (Tier 1)
Managing Support Issues
When the user says "create a support ticket" or "log a bug", guide them:
- Create SLA (if none exists) -- Define response/resolution time targets by priority
- Add issue -- Log the issue with priority and customer
- Comment & track -- Add comments, first employee comment triggers SLA response tracking
- Resolve -- Mark resolved with resolution notes, system checks SLA breach
- Suggest next -- "Issue resolved. Want to check SLA compliance?"
Essential Commands
Add an SLA:
python3 {baseDir}/scripts/db_query.py --action add-sla --name "Standard SLA" --priorities '{"response_times": {"low": "48", "medium": "24", "high": "8", "critical": "4"}, "resolution_times": {"low": "120", "medium": "72", "high": "24", "critical": "8"}}'
Create an issue:
python3 {baseDir}/scripts/db_query.py --action add-issue --subject "Printer not working" --customer-id --priority high --issue-type complaint
Resolve an issue:
python3 {baseDir}/scripts/db_query.py --action resolve-issue --issue-id --resolution-notes "Replaced toner cartridge"
All Actions (Tier 2)
For all actions, use: python3 {baseDir}/scripts/db_query.py --action
All output is JSON to stdout. Parse and format for the user.
Issues (7 actions)
| Action | Required Flags | Optional Flags |
|---|---|---|
add-issue |
--subject |
--customer-id, --item-id, --serial-number-id, --priority, --issue-type, --description, --assigned-to, --sla-id |
update-issue |
--issue-id |
--status, --priority, --assigned-to, --issue-type, --description |
get-issue |
--issue-id |
(none) |
list-issues |
--status, --priority, --customer-id, --assigned-to, --company-id, --limit, --offset | |
add-issue-comment |
--issue-id, --comment |
--comment-by (employee/customer), --is-internal (0/1) |
resolve-issue |
--issue-id |
--resolution-notes |
reopen-issue |
--issue-id |
--reason |
Priority values: low, medium, high, critical
Issue types: bug, feature_request, question, complaint, return
Status values: open, in_progress, waiting_on_customer, resolved, closed
SLAs (2 actions)
| Action | Required Flags | Optional Flags |
|---|---|---|
add-sla |
--name, --priorities (JSON) |
--working-hours, --is-default |
list-slas |
--limit, --offset |
Priorities JSON format: {"response_times": {"low": "48", ...}, "resolution_times": {"low": "120", ...}} (hours)
Warranty (3 actions)
| Action | Required Flags | Optional Flags |
|---|---|---|
add-warranty-claim |
--customer-id, --complaint-description |
--item-id, --serial-number-id, --warranty-expiry-date |
update-warranty-claim |
--warranty-claim-id |
--status, --resolution, --resolution-date, --cost |
list-warranty-claims |
--customer-id, --status, --limit, --offset |
Resolution values: repair, replace, refund, rejected
Maintenance (3 actions)
| Action | Required Flags | Optional Flags |
|---|---|---|
add-maintenance-schedule |
--customer-id, --start-date, --end-date |
--item-id, --serial-number-id, --schedule-frequency, --assigned-to |
list-maintenance-schedules |
--customer-id, --item-id, --status, --limit, --offset | |
record-maintenance-visit |
--schedule-id, --visit-date |
--completed-by, --observations, --work-done, --status |
Frequency values: monthly, quarterly, semi_annual, annual
Reports & Utility (3 actions)
| Action | Required Flags | Optional Flags |
|---|---|---|
sla-compliance-report |
--company-id, --from-date, --to-date | |
overdue-issues-report |
--company-id | |
status |
--company-id |
Quick Command Reference
| User Says | Action |
|---|---|
| "create support ticket" / "log issue" | add-issue |
| "update issue status" / "assign issue" | update-issue |
| "show issue details" | get-issue |
| "list open issues" / "show all tickets" | list-issues |
| "add comment to issue" | add-issue-comment |
| "resolve issue" / "close ticket" | resolve-issue |
| "reopen issue" / "reopen ticket" | reopen-issue |
| "create SLA" / "add service level" | add-sla |
| "list SLAs" | list-slas |
| "file warranty claim" | add-warranty-claim |
| "update warranty" / "resolve claim" | update-warranty-claim |
| "list warranty claims" | list-warranty-claims |
| "schedule maintenance" | add-maintenance-schedule |
| "list maintenance schedules" | list-maintenance-schedules |
| "log maintenance visit" | record-maintenance-visit |
| "SLA compliance" / "breach report" | sla-compliance-report |
| "overdue issues" | overdue-issues-report |
| "support status" | status |
Confirmation Requirements
Always confirm before: resolving issues (sets resolved_at), reopening issues, updating warranty resolution. Never confirm for: adding issues/comments, listing records, running reports.
IMPORTANT: NEVER query the database with raw SQL. ALWAYS use the --action flag on db_query.py. The actions handle all necessary JOINs (e.g., list-issues --company-id resolves company through the customer table). Raw SQL will fail because many columns like company_id do not exist directly on the issue table.
Proactive Suggestions
| After This Action | Offer |
|---|---|
add-issue |
"Issue created. Want to assign it to someone?" |
add-issue-comment |
"Comment added. Want to update the issue status?" |
resolve-issue |
"Issue resolved. Want to check SLA compliance?" |
add-warranty-claim |
"Claim filed. Want to check warranty expiry?" |
record-maintenance-visit |
"Visit logged. Next maintenance due on {date}." |
status |
If overdue > 0: "You have N overdue issues requiring attention." |
Error Recovery
| Error | Fix |
|---|---|
| "no such table" | Run python3 ~/.openclaw/erpclaw/init_db.py --db-path ~/.openclaw/erpclaw/data.sqlite |
| "Issue not found" | Check issue ID with list-issues |
| "Issue is closed" | Closed issues cannot be updated; reopen first |
| "SLA not found" | Check SLA ID with list-slas |
| "Customer not found" | Ensure customer exists via erpclaw-setup |
| "database is locked" | Retry once after 2 seconds |
Sub-Skills
| Sub-Skill | Shortcut | What It Does |
|---|---|---|
erp-support |
/erp-support |
Support ticket summary — open issues, SLA compliance |
Technical Details (Tier 3)
Tables owned (6): service_level_agreement, issue, issue_comment, warranty_claim, maintenance_schedule, maintenance_visit
GL Posting: None. This skill does not create any GL entries.
Script: {baseDir}/scripts/db_query.py -- all 18 actions routed through this single entry point.
Data conventions:
- All IDs are TEXT (UUID4)
- Financial values (cost) stored as TEXT (Python
Decimal) - Naming series:
ISS-{YEAR}-{SEQ}(issue),WC-{YEAR}-{SEQ}(warranty),MS-{YEAR}-{SEQ}(schedule),MV-{YEAR}-{SEQ}(visit) - SLA times stored as JSON hours in
priority_response_timesandpriority_resolution_times - SLA breach is permanent — once
sla_breached=1, it stays set even after reopen
Shared library: ~/.openclaw/erpclaw/lib/naming.py -- get_next_name() for ISS-, WC-, MS-, MV- series.
Progressive Disclosure:
- Tier 1:
add-issue,list-issues,resolve-issue,status - Tier 2:
update-issue,get-issue,add-issue-comment,reopen-issue,add-sla,list-slas,sla-compliance-report,overdue-issues-report - Tier 3:
add-warranty-claim,update-warranty-claim,list-warranty-claims,add-maintenance-schedule,list-maintenance-schedules,record-maintenance-visit
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
代理状态:监控支付意图和交易 - Openclaw Skills
Proxy MCP:AI 智能体支付与虚拟卡 - Openclaw Skills
Apify Ultimate Scraper: AI 网页数据抓取 - Openclaw Skills
加密诈骗检测器:实时欺诈预防 - Openclaw Skills
newsmcp: 实时 AI 新闻聚合与过滤 - Openclaw Skills
Moltbook 优化器:策略与排名精通 - Openclaw 技能
Frigate NVR:智能摄像机管理与自动化 - Openclaw Skills
Markdown 检查器:样式、链接和格式工具 - Openclaw Skills
Venice.ai 至尊路由:私密且无审查的模型路由 - Openclaw Skills
图片优化器:使用 Openclaw Skills 压缩和调整图片尺寸
AI精选
