最佳实践
[TOC]
# 智谱 AutoClaw Skills 技能包操作指南
## 一、准备工作
### 1. 下载并安装智谱 AutoClaw
**软件下载地址：** [https://autoclaw.zhipuai.cn/](https://autoclaw.zhipuai.cn/)
根据操作系统选择对应版本，点击下载图标进行下载：
> **说明：** 本教程基于 Windows 11 环境，软件版本为 1.11.4。若您的操作系统或软件版本与演示差异较大，请参考官方网站。
下载完成后，双击安装包并按提示完成安装，随后注册并登录软件。注册、登录等基础步骤此处不再赘述。
---
### 2. 注册 ShowAPI 平台账号
**注册地址：** [https://www.showapi.com/auth/reg](https://www.showapi.com/auth/reg)
> 若您已注册，可跳过此步骤。
---
### 3. 获取 AppKey
**登录地址：** [https://www.showapi.com/auth/login](https://www.showapi.com/auth/login)
登录成功后，按以下路径操作：
**右上角「控制台」 → 左侧菜单「接口使用者」 → 「appKey 管理」**
如下图所示：
您可以根据需要创建独立的应用和 appKey，并设置访问 IP 或接口权限。
点击「查看」按钮，输入注册密码后即可查看并复制 appKey。**该密钥将在后续调用 Skills 时使用，请妥善保存。**
---
## 二、下载技能包
### 1. 进入 Skills 市场
访问 [万维易源平台首页](https://www.showapi.com/)，登录后点击导航栏 **「AI Skills」 → 「Skills 市场」**：
或直接访问：[https://www.showapi.com/ai/skills/market](https://www.showapi.com/ai/skills/market)
Skills 市场界面如下：
---
### 2. 下载 Skill（技能）
在 Skills 市场中浏览并查找您需要的技能：
> **提示：** Skills 市场的内容会动态更新，您看到的界面可能与示例略有不同。
本示例以 **「文创设计」** 技能包为例进行演示（其他技能包的安装步骤相同）。在搜索框中输入「文创设计」，找到对应的 Skill 卡片：
点击卡片后，依次选择：
1. **「Agent 使用与开发集成」**
2. **「Agent 接入」**
3. **「选择客户端下载技能包」**
技能包提供中英文两个版本，部分工具仅支持英文版，请根据实际需求选择。本示例使用中文版，点击 **「智谱 AutoClaw」** 旁的下载图标进行下载。
> **注意：** 请留意技能包的保存路径，后续安装步骤中需要选择该文件。
---
## 三、安装技能包
### 1. 打开软件
---
### 2. 导入技能包
首先，解压此前下载的技能包。本示例使用浏览器默认的下载位置，解压后的路径如下图所示：
接着，在 AutoClaw 中依次点击：
**「Skill 商店」 → 「创建」 → 「添加技能文件」**
然后选择解压好的技能包文件夹：
**安装成功后的界面：**
在「我的创建」栏目下，会新增一个「文创设计」技能：
---
## 四、使用技能
### 1. 查阅技能参数
以「文创设计」为例，在线测试地址：
[https://www.showapi.com/ai/skills/6a4c58393c51f2d32d00c4fc?tab=run](https://www.showapi.com/ai/skills/6a4c58393c51f2d32d00c4fc?tab=run)
在线测试界面如下：
该技能包含以下四个参数：
| 参数 | 说明 | 是否必填 |
|------|------|----------|
| **产品图排版** | 生成图片的宫格数量（1~4 宫格） | ✅ 必填 |
| **参考图** | 图片 URL 或 Base64 字符串 | 可选 |
| **产品描述** | 提示词（Prompt） | 可选 |
| **长宽比** | 生成图片的比例，默认 1:1 | 可选 |
> **建议：** 为获得最佳生成效果，提示词中尽量包含以上所有参数，并详细描述各参数对应的内容。
---
### 2. 调用技能的提示词
点击左侧菜单中的 **「新对话」**，在输入框下方选择 **「Skills」**，然后在输入框中输入 `/文创`，选择如图所示的技能包：
输入您的需求（即提示词），建议尽量涵盖测试界面中的所有参数。
**参考示例：**
```
生成一个文化创意的产品宣传图，图片主要描述江浙一带的绸缎文化，图片为四宫格，长宽比为 16:9 横版，产品参考图：https://oss.showapi.com/doc/4826/5/ae919726ce38_1780382555943.jpg
```
该提示词包含以下四个参数信息：
| 序号 | 参数 | 值 |
|------|------|-----|
| 1 | `grid_num` | `4` |
| 2 | `image` | `https://oss.showapi.com/...82555943.jpg` |
| 3 | `prompt` | `生成一个文化创意的产品宣传图，图片主要描述江浙一带的绸缎文化` |
| 4 | `aspect_ratio` | `16:9` |
如上图，填写好提示词后，按 **Enter** 或点击右下角 **发送按钮**，即可开始调用 Skill。
---
### 3. 调用过程及结果
> **重要提示：**
> - 首次调用 Skill 时，需要配置 AppKey。后续调用同一 Skill 时无需重复配置。
> - AppKey 获取地址：[https://www.showapi.com/console#/myApp](https://www.showapi.com/console#/myApp)
> - 调用过程中，系统可能会不定时在提示词输入框或整个窗口界面弹出交互窗口，请根据实际情况进行确认和操作（如网络请求权限确认、文件操作确认、密钥调整、环境变量修改等）。不同 Skill 的交互提示内容各不相同，此处不再逐一展示，请依据提示操作即可。
**AppKey 设置交互：**
**完整的交互过程（步骤较多，分多张截图展示）：**
**HTML 渲染效果（图片渲染失败，但 Skill 调用实际已成功）：**
> **说明：** 图片渲染失败可能是默认模型能力不足所致。建议切换至更优的模型，如 **GLM-5.2**。调整模型的操作参考下图：
**最终生成的结果图：**
