AlphaClaw - SkillHub CLI 工具

AlphaClaw 是 1688 SkillHub 技能商店的命令行工具，让你可以直接在终端搜索、安装、发布和管理openclaw的技能SKILL。

官网: https://skill.alphashop.cn/

触发条件

当用户提到以下内容时触发：

• - "安装 alphaclaw"、"安装技能商店"、"安装 skill 商店"
• "搜索技能"、"安装技能"、"发布技能"
• "alphaclaw login"、"alphaclaw search"、"alphaclaw install" 等命令
• "技能管理"、"skill 管理"

前置条件

• - Node.js >= 11
• npm

安装

CODEBLOCK0

安装完成后，终端输入 alphaclaw --version 验证是否安装成功。

登录认证

AlphaClaw 使用 AK/SK（Access Key / Secret Key）认证。

获取密钥

访问遨虾控制台获取：https://www.alphashop.cn/seller-center/apikey-management

Secret Key 仅在创建时可见，请妥善保管！

执行登录

CODEBLOCK1

执行后会自动打开浏览器访问 API 密钥管理页面，然后在终端输入 Access Key 和 Secret Key（SK 输入时会被隐藏）。

凭证保存在 ~/.alphaclaw/auth.json，后续请求自动使用 JWT Token 认证（有效期 30 分钟，自动刷新）。

查看当前用户

CODEBLOCK2

完整命令参考

1. login - 登录

CODEBLOCK3

自动打开浏览器访问密钥管理页面，交互式输入 AK/SK。

2. whoami - 查看当前用户

CODEBLOCK4

显示当前登录用户的信息。

3. search - 搜索技能

CODEBLOCK5

按关键词模糊搜索技能，返回匹配的技能列表。

示例：
CODEBLOCK6

4. info - 查看技能详情

CODEBLOCK7

查看指定技能的详细信息，包括版本、描述、下载次数、收藏数等。

示例：
CODEBLOCK8

5. install - 安装技能

CODEBLOCK9

下载并安装技能到本地。默认安装到当前项目的 skills/ 目录下。

选项：

选项	说明
INLINECODE3	安装指定版本（默认最新版）
INLINECODE4

强制覆盖已安装的技能 |
| --dir <path> | 自定义安装目录 |

示例：
CODEBLOCK10

安装记录保存在 ~/.skillhub/skills-lock.json。

6. list - 查看已安装的技能

CODEBLOCK11

列出本地已安装的所有技能，显示名称、版本、安装路径和安装时间。

7. publish - 发布技能

CODEBLOCK12

将技能目录打包为 zip 并上传到 SkillHub。目录中必须包含 SKILL.md 文件。

选项：

选项	说明
INLINECODE8	跳过确认提示，直接发布

示例：
CODEBLOCK13

发布流程：

1. 1. 读取并校验 SKILL.md 的 YAML frontmatter
2. 如果未设置 category，交互式选择分类
3. 显示元数据预览，确认后打包上传
4. 上传后进入"待审批"状态，管理员审批通过后上线

8. comment - 发表评论

CODEBLOCK14

对指定技能发表评论，执行后在终端输入评论内容。

示例：
CODEBLOCK15

9. favorite - 收藏/取消收藏

CODEBLOCK16

选项：

选项	说明
INLINECODE10	取消收藏

示例：
CODEBLOCK17

全局选项

所有命令均支持以下全局选项：

选项	说明
INLINECODE11	覆盖 API 基础 URL
INLINECODE12

显示版本号 |
| --help, -h | 显示帮助信息 |
| --debug | 显示调试信息（排查问题时使用） |

技能包格式

发布技能时，目录中必须包含 SKILL.md，格式如下：

CODEBLOCK18

字段说明

字段	必填	说明
name	Y	技能名称，小写字母+数字+连字符，3-50字符
description

Y | 技能描述 | | version | N | 语义化版本号，如 1.0.0（省略则自动递增） | | type | N | SKILL（默认）或 EXPERIENCE | | category | N | 分类编码（发布时可交互选择） | | github-url | N | GitHub 仓库链接 |

技能分类

分类编码	名称
official-1688	官方
product-selection

选品 | | pricing | 定价 | | inquiry | 询盘 | | material | 素材 | | distribution | 铺货 | | other | 其他 |

目录结构推荐

CODEBLOCK19

配置文件位置

文件	路径	说明
认证凭证	INLINECODE19	AK/SK 存储
安装锁文件

~/.skillhub/skills-lock.json | 已安装技能记录 | | 技能目录 | ./skills/ | 默认安装位置 |

环境变量

变量	说明	默认值
INLINECODE22	API 地址	INLINECODE23
INLINECODE24

禁用彩色输出 | - |

常见工作流

安装一个技能

CODEBLOCK20

创建并发布一个技能

CODEBLOCK21

故障排查

遇到问题时，使用 --debug 查看详细信息：

CODEBLOCK22

常见问题：

• - 认证失败：重新执行 INLINECODE26
• 安装失败：检查网络连接，或加 --force 重试
• 发布被拒绝：检查 SKILL.md 格式是否正确，name 字段是否符合命名规范