阿里云支持工单助手

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install alibabacloud-support
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 alibabacloud-support。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

阿里云支持工单助手可帮助客户创建和管理阿里云 Workorder 工单，而无需手动浏览支持控制台。它将报告的问题与经过验证的工单规则进行匹配，构建脱敏草稿，解析实时产品类别，并支持工单创建、状态检查、回复、关闭和评估。
专为 Openclaw Skills 工作流设计，每个云操作都通过捆绑的 Python 客户端和 Alibaba Cloud CLI 运行。该技能可保护凭据、每次写入都需要明确确认、避免重复提交，并且在可选规则源不可用时继续使用记录在案的通用模板。

应用场景

为报告的服务问题提交新的阿里云或 Aliyun 支持工单。
将故障排除问题升级至人工阿里云支持。
列出最近的支持工单并检查工单状态。
检索工程师回复并在不重写原始消息的情况下呈现它。
通过确认的回复向现有的支持案例添加信息。
关闭已解决的工单或提交明确解决状态的 1-5 评分。
在 Alibaba Cloud CLI 不可用时生成本地的、非阻塞的草稿。
使用 Openclaw Skills 自动化进行一次一个工单的支持工作流，而不暴露 AccessKey 密钥。

工作原理

通过 doctor 运行安静的就绪状态检查，检查自更新状态，并尝试尽力进行规则更新。
在进行云相关操作之前，确认 Python 运行时、Alibaba Cloud CLI、Workorder 插件、凭据链和技能清单可用。
将客户的问题与置顶的 GitHub 规则、官方 OSS 后备、经过验证的缓存快照或内置通用模板进行匹配。
仅收集有用的非机密详细信息，适时提出至多一个澄清问题，并在缺少可选字段时保持工作流继续运行。
在未提供值时，生成带有记录默认值（例如 cn-hangzhou 和 General issue）的已验证且脱敏的草稿。
为每次工单创建查询实时的阿里云产品目录和类别列表；绝不持久化类别 ID 以供重复使用。
准备一个完整的 preview-* 响应，显示规范化的标题、类别、严重性、正文和客户端请求标识符。
等待明确的客户确认，然后使用其一次性确认令牌重播精确的预览内容。
每次创建、回复、评估或关闭一个工单，使用有界超时且对写入操作不进行自动重试。
通过范围狭窄的 ListTickets 和 GetTicket 查询来调和不确定的工单创建，并且仅在结果可验证后才返回可点击的工单 URL。

配置指南

Python 3.9 或更高版本。
带有用于目录和工单 API 操作的 Workorder 产品插件的 Alibaba Cloud CLI。
macOS、Linux 或 Windows。
通过 Alibaba Cloud CLI 默认凭据链配置的凭据；该技能从不存储或打印凭据。
当客户明确同意时安装 CLI：
brew install aliyun-cli
仅在客户自己的交互式终端中配置 OAuth：
aliyun configure --mode OAuth --profile default
请勿让智能体执行 OAuth 流程、捕获授权 URL 或读取浏览器会话数据。仅在单独且明确的客户批准后安装或修复 CLI。
从技能目录运行就绪状态检查：
python3 scripts/aliyun_support.py doctor
python3 scripts/aliyun_support.py self-update status
python3 scripts/aliyun_support.py rules update
可选配置变量包括：
ALIBABACLOUD_SUPPORT_HOME: 本地缓存、令牌和更新状态目录。
ALIBABACLOUD_SUPPORT_RULES_OSS_URL: 官方 OSS 规则源覆盖。
ALIBABACLOUD_SUPPORT_RULES_OSS_PREFIX: OSS 对象前缀覆盖。
ALIBABACLOUD_SUPPORT_CLI_PATH: Alibaba Cloud CLI 的绝对路径。
ALIBABACLOUD_SUPPORT_CLI_ENCODING: utf-8 或 gb18030 CLI 输出解码。
ALIBABA_CLOUD_REGION_ID: CLI 区域，默认为 cn-hangzhou。
SKILL_SESSION_ID: 可选的 32 位十六进制追踪标识符。
仅当 readiness.readyForTicketOperations 为 true 时，才继续进行目录和工单操作。在 Windows 上，使用 py scripts/aliyun_support.py ... 并传递 UTF-8 文件，而不是复制 macOS 或 Linux heredoc 命令。

数据架构

命令和输入模型
区域 数据和约束
匹配 来自文件或 stdin 的客户输入；可选产品；返回确信的问题类型或通用后备。
起草 包含产品、问题类型、摘要、影响、尝试过的步骤以及收集的值的 JSON。敏感凭据会导致起草停止。
目录 产品名称、语言、产品 ID 和类别关键词；类别 ID 是实时解析的，不会持久化。
工单创建 类别 ID、标题、严重性 1 或 2、脱敏内容以及一次性确认令牌。
后续 工单 ID、回复内容、评估分数 1-5、已解决布尔值以及关闭确认。
列表 1-3650 天的日期窗口、页码、10-100 的页面大小、关键词或工单 ID。
本地文件和元数据
references/manifest.json 是在每个 Workorder User-Agent 中使用的语义技能版本的强制源。
references/ram-policies.md 记录了权限和最小权限要求。
references/api-reference.md 定义了九个 Workorder 操作和响应信封。
references/error-handling.md 定义了退出码、Success 语义以及创建调和行为。
references/rule-sources.md 记录了置顶的 GitHub 源、OSS 后备、完整性检查、缓存布局和通用模板。
本地支持主目录使用 0600 权限存储经过验证的规则快照、确认状态和更新事务。
规则快照包含直接的 products/*.json 对象以及包含文件集、SHA-256 摘要和大小的清单。
确认令牌是即将过期的本地句柄，有效期为 30 分钟，绑定到精确的预览字节，且绝不是凭据。
每个 CLI 调用都在 User-Agent 中携带技能名称、语义版本和 32 位会话 ID。
客户问题、草稿、回复、凭据和收集的值绝不会上传到规则源或写入规则缓存。

高级特性

优先加载置顶的 GitHub 规则，具有匿名 HTTPS OSS 后备、完整性验证、缓存快照和内置通用模板。
经过验证的自更新检查，要求严格更高的版本并通过 SHA-256 验证维护回滚元数据。
使用即将过期的一次性确认令牌进行精确的预览到写入绑定。
对不明确的
CreateTicket
结果进行自动调和，没有不安全的重试。
对 AccessKey 密钥、令牌、Cookie、授权标头、密码和私钥进行脱敏和秘密检测。
在每次创建工单时对产品和类别进行实时目录解析。
区分缺少 CLI、身份验证、权限、网络和清单故障的就绪和能力诊断。
stdout 上的机器可读 JSON，带有 stderr 上的降级和进度详细信息。
通过传播的 User-Agent 和
SKILL_SESSION_ID
值实现具备会话感知的可观测性。
在回复、评估或关闭之前重新验证状态，以防止对处于终结状态的工单进行写入。
逐字工程师回复检索、可点击的工单 URL、有界分页、显式超时和零批处理操作。
当 CLI 安装、本地参数暴露、附件或身份验证无法满足工作流的安全边界时，安全回退到本地草稿或阿里云控制台。

name: alibabacloud-support description: | Manage Alibaba Cloud (Aliyun) after-sales support tickets from the conversation:
match the reported problem against the published ticket rules, build a redacted
non-blocking draft, then query the product catalog, list recent tickets, create,
view, reply to, close and rate tickets through the Workorder OpenAPI. Use when a
customer asks to open, follow up on, reply to, close or rate an Alibaba Cloud
support ticket, asks for the ticket list, status or engineer reply, or wants human
support instead of self-service.
Triggers: "submit a ticket", "create a support ticket", "list my tickets",
"view ticket status", "reply to the engineer", "close the ticket",
"rate the ticket", "transfer to human support", "escalate to Alibaba Cloud support",
"support case". Do not use for product knowledge, troubleshooting or solution
discussion that carries no ticket intent.
compatibility: Requires Python 3.9+. The aliyun CLI with the workorder product plugin is required only for catalog and ticket API operations; when the CLI is absent, the agent may help install and configure it only after explicit customer consent. Rules load from the pinned aliyun/alibabacloud-aiops-skills master commit, then an anonymous HTTPS OSS fallback. Workorder authentication uses the aliyun CLI default credential chain; this skill never stores, reads or prints AccessKey credentials.