安装指南

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

什么是

Zhinii AI 客服助手将兼容的 AI 工具（包括 Codex 和 WorkBuddy）连接到 Zhinii Customer Service MCP 服务。它可帮助你查询客户资料、当前及历史对话、消息记录、客户细分，以及微信、企业微信、抖音、小红书、微博和网站客服等渠道的 API Key 使用情况。
作为实用的 Openclaw Skills 之一，它适用于客服工作流程，将只读检索与经过严格把关的操作相结合。你可以准备选定的对话以便处理，也可以创建文本或图片外联任务，但只有在你检查收件人和确切内容并明确确认后，消息才会发送。

应用场景

按姓名、电话号码、微信号、渠道、负责客服、标签、时间范围或已知 UID 查找客户。
查看当前队列、分配给你或队友的对话，以及由 AI 处理的对话。
检索涉及咨询、投诉、订单、退款或其他关键词的历史对话，然后检查消息上下文再进行总结。
使用受支持的标签、渠道、客服、联系人类型、性别和时间条件创建客户或对话细分。
确认收件人列表后，为当前客服打开选定客户的对话。
准备经确认的文本或图片外联，监控每位客户的发送进度，并查看历史发送任务。
检查已连接 API Key 的配额、用量和剩余额度，同时不暴露密钥。

工作原理

连接 Zhinii MCP 端点 https://mcp.h5bqb.top/mcp，并完成 OAuth 授权或配置 Bearer API Key。
将请求路由到相关工作流程。必要时将渠道、客服或标签名称解析为稳定 ID，并在搜索客户时使用明确的结构化筛选条件。
从相应工具获取依据：使用当前会话列表查看当前队列，使用会话搜索查找历史对话，并在得出结论前获取消息以检查上下文。
使用客户 UID、会话 ID 和分页详情确保结果可追溯。将搜索匹配项视为候选对象，而非已验证身份；不要将单页结果视为完整细分。
外联时仅使用由用户明确选定或核实的收件人。如有需要，先上传图片，再准备发送任务，并展示其收件人、标题和确切消息内容。
只有在用户使用确认令牌确认内容未被更改后，才创建任务。保存任务 ID，并检查任务状态以跟踪进度和每位客户的结果。

配置指南

打开 Zhinii 服务 https://ai.zhinikefu.com/，并确保账户有权访问相关客服渠道。
在兼容的 MCP 客户端（例如 Codex 或 WorkBuddy）中添加 MCP 服务器端点 https://mcp.h5bqb.top/mcp。按照客户端的 MCP 连接流程操作；技能文档未指定通用的软件包安装命令或客户端配置文件格式。
选择一种身份验证方式：
推荐：OAuth 2.1。 不要配置静态凭据。首次发起受保护请求时，在客户端打开的浏览器中授权 Zhinii 账户。可通过 Zhinii 网站撤销授权。
Bearer API Key： 通过客户端的密钥配置或 ZHINI_API_KEY 环境变量提供密钥。切勿将其包含在提示词或工具参数中。

可选：通过环境变量提供 API Key。

持久化配置时，优先使用客户端的密钥管理器。

export ZHINI_API_KEY=""
如果 MCP 连接器缺失或尚未授权，请先完成连接和授权，再查询客户数据。妥善保管凭据，不要显示完整 API Key。

数据架构

此技能使用 Zhinii MCP 工具及服务返回的标识符，不定义本地数据文件或本地数据库。文档未说明生成的文件或本地元数据分类体系。
数据或标识符 用途
uid 标识客户；使用它获取客户资料或检索相关消息。
sid 标识对话会话，用于获取该会话的消息。
kfid 标识客服；在区分当前客服的会话时获取此标识。
渠道、客服和标签 ID 使用渠道、客服和标签列表/搜索工具解析得到的稳定筛选条件。
page 和搜索条件 跟踪分页的客户或历史会话结果；汇报细分时记录实际筛选条件和返回数量。
confirmation_token 与相同的已审核内容及 user_confirmed: true 一起提供时，用于确认创建已准备好的消息发送任务。
task_id 标识已创建的发送任务，以便检查状态、查看每位客户的结果和管理历史记录。
idempotency_key 重试创建任务时重复使用相同的密钥，以帮助防止群发重复。
每个发送任务最多包含 100 个客户 UID 和两条消息。图片上传支持 PNG、JPEG 和 GIF，解码后大小限制为 10 MiB；将返回的 CDN URL 用作图片消息内容。

高级特性

将请求路由到客户搜索、资料查询、实时队列、历史会话、消息获取、细分、外联和配额检查；只要依据清晰，也可组合工作流程。
在结构化搜索前将渠道、客服和标签名称解析为稳定 ID，并支持历史检索与细分的分页结果。
支持受控地批量打开对话，每次调用最多处理 20 位选定客户；已由其他客服处理的客户不会被转接。
发送采用两步确认流程：准备任务会返回确认令牌，但在用户确认确切的收件人和内容之前，不会创建或发送任务。
跟踪发送进度和每位客户的结果，列出历史任务，并在核实任务详情后支持删除任务。删除操作不可撤销，已发送的消息也无法撤回。
客户检索为只读，不会修改资料或标签，也不会接受、转接或关闭对话，亦不会执行完整数据导出。
报告 API 配额总量、用量和剩余额度，但不会透露完整 API Key 或内部身份验证详情。

name: "zhini-ai-assistant" description: "使用知你AI助手查询多平台客户资料、当前与历史客服会话、聊天记录、客户分群及 API Key 用量，并在用户明确确认后批量打开客户对话、发送文本或图片消息并跟踪发送进度。适用于个微、企微、视频号、微信小程序、公众号、服务号、微信客服、微信小店、抖音号、小红书、微博、网站及 H5 客服等渠道。"

知你AI助手

通过知你客服 MCP 服务，将多平台客户资料、会话及聊天记录连接到 Codex、WorkBuddy 等 AI 工具，并按用户确认执行批量打开对话和消息发送任务。

Connection

官网：https://ai.zhinikefu.com/
MCP endpoint：https://mcp.h5bqb.top/mcp
认证方式（二选一，由客户端连接配置决定）：
MCP 原生 OAuth 2.1 浏览器授权（推荐）：连接时不配置任何静态认证字段，首次访问受保护资源时由客户端打开浏览器完成知你账号授权，无需 API Key；授权可随时在官网吊销。
静态 Bearer API Key：由 ZHINI_API_KEY 环境变量或客户端 Secret 提供，不作为提示词或工具参数传入。
连接器未配置或未授权时，先引导用户完成连接与授权，再执行查询；面向用户省略连接器、信任操作和本地配置细节。

Channel coverage

支持个微、企微、视频号、微信小程序、公众号、服务号、微信客服、微信小店、抖音号、小红书、微博、网站及 H5 客服等平台渠道。

Capability routing

根据用户意图选择对应流程；一个请求涉及多项能力时，可在保持证据链清晰的前提下组合调用。

当前会话分诊

适用于当前队列、等待接待、我的会话、同事会话或 AI 会话查询。

需要区分“我的会话”时，先调用 zhini_get_current_kefu 获取 kfid。
调用 zhini_list_active_sessions 获取实时队列，不把当前快照当作历史统计。
选定会话后，用 sid 调用 zhini_fetch_messages，用 uid 调用 zhini_get_customer_profile。
客户查询与画像

适用于按姓名、手机号、微信号、渠道、客服、标签、时间或已知 uid 定位客户。

客户名、渠道名、客服名或标签名先通过 zhini_list_channels、zhini_list_kefu 或 zhini_search_tags 解析为稳定 ID。
将明确的结构化条件交给 zhini_search_customers，避免空条件查询。
已知 uid 时直接调用 zhini_get_customer_profile；需要聊天内容时再调用 zhini_fetch_messages。
多个候选时保留 uid 供核对，不把推断当成客户身份事实。
历史会话研判

适用于历史咨询、投诉、订单、退款、问题处理、关键词命中或客户前情复盘。

按客户、消息关键词或 msg_stime 调用 zhini_search_sessions。
关键词只用于召回候选；调用 zhini_fetch_messages 读取上下文后再总结。
需要更多结果时按 page 翻页；输出会话 ID、时间范围和关键证据。
已知 uid 时可调用 zhini_get_customer_profile 补充资料。
客户分群

适用于按标签、渠道、客服、联系人类型、性别和时间条件构建客户或会话分群。

先将用户明确提到的标签、渠道和客服名称解析为稳定 ID。
结构化条件使用 zhini_search_customers；必须按消息内容判断时使用 zhini_search_sessions 和 zhini_fetch_messages。
多个相似标签或候选需要保留核对点。
分页查询并记录实际条件、页码和返回数量，避免把单页结果当成完整分群。
客户触达与消息发送

适用于批量打开选定客户对话、发送跟进文本或图片、跟踪群发进度和管理历史任务。

收件客户必须来自用户明确选定的结果或其他流程已核对候选后的确认结果；不要把整批搜索结果或分群直接当作收件人。
用户要集中处理对话时，展示目标客户清单并确认后调用 zhini_open_sessions，将选定客户对话打开到当前客服的“我的对话”，单次最多 20 个用户；已被其他客服接待的用户不会转接。
用户要发送图片时，先调用 zhini_upload_image_for_message_sending 上传（PNG/JPEG/GIF，解码后不超过 10 MiB），使用返回的 CDN URL 作为图片消息内容。
首次调用 zhini_create_message_sending_task 只准备任务并返回 confirmation_token，不会创建或发送；向用户完整展示收件客户、任务标题和最终消息内容，确认后用完全相同的内容加 confirmation_token 与 user_confirmed: true 再次调用才会创建任务。
创建成功后保存 task_id，用 zhini_get_message_sending_task_status 跟踪进度和逐客户结果；用 zhini_list_message_sending_tasks 查询历史任务；删除前先核对任务并保存所需明细，再调用 zhini_delete_message_sending_task。
单任务最多 100 个 UID、最多 2 条消息；重试创建时携带相同的 idempotency_key 避免重复群发。
API Key 用量

适用于查询当前连接的总额度、已使用量和剩余额度。

调用 zhini_get_apikey_usage。
汇总总配额、已使用量和剩余额度，并标记数据是否一致。
仅展示额度摘要，不输出完整 API Key 或内部鉴权细节。

Available tools

zhini_get_current_kefu
zhini_list_active_sessions
zhini_search_customers
zhini_get_customer_profile
zhini_search_sessions
zhini_fetch_messages
zhini_search_tags
zhini_list_channels
zhini_list_kefu
zhini_get_apikey_usage
zhini_open_sessions
zhini_upload_image_for_message_sending
zhini_create_message_sending_task
zhini_get_message_sending_task_status
zhini_list_message_sending_tasks
zhini_delete_message_sending_task

Boundary

查询保持只读；批量打开对话与消息发送为受控触达操作，必须在用户明确确认后执行。
消息任务不会修改客户资料或标签；不接待、转接或关闭会话；不做全量导出。
删除消息任务不可逆，已发送的消息不会撤回；查询结果受当前凭据数据权限约束。
中文 AI 图像生成器
Huawei Cloud ModelArts vLLM-Ascend 模型部署