← 返回 Skills 市场
alphaclaw
作者
1688AiInfra
· GitHub ↗
· v1.0.2
· MIT-0
189
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install alphaclaw
功能描述
AlphaClaw 是 SkillHub 技能商店的 CLI 工具，用于搜索、安装、发布和管理 Claude Code 技能。支持 AK/SK 登录、关键词搜索技能、一键安装/发布技能包、收藏和评论等完整功能。
使用说明 (SKILL.md)
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
安装
npm install -g 1688alphaclaw
安装完成后，终端输入 alphaclaw --version 验证是否安装成功。
登录认证
AlphaClaw 使用 AK/SK（Access Key / Secret Key）认证。
获取密钥
访问遨虾控制台获取：https://www.alphashop.cn/seller-center/apikey-management
Secret Key 仅在创建时可见，请妥善保管！
执行登录
alphaclaw login
执行后会自动打开浏览器访问 API 密钥管理页面，然后在终端输入 Access Key 和 Secret Key（SK 输入时会被隐藏）。
凭证保存在 ~/.alphaclaw/auth.json，后续请求自动使用 JWT Token 认证（有效期 30 分钟，自动刷新）。
查看当前用户
alphaclaw whoami
完整命令参考
1. login - 登录
alphaclaw login
自动打开浏览器访问密钥管理页面，交互式输入 AK/SK。
2. whoami - 查看当前用户
alphaclaw whoami
显示当前登录用户的信息。
3. search - 搜索技能
alphaclaw search \x3C关键词>
按关键词模糊搜索技能，返回匹配的技能列表。
示例：
alphaclaw search "小红书"
alphaclaw search "数据处理"
alphaclaw search "1688"
4. info - 查看技能详情
alphaclaw info \x3C技能名称>
查看指定技能的详细信息，包括版本、描述、下载次数、收藏数等。
示例：
alphaclaw info xiaohongshu-upload
alphaclaw info 1688-ranking
5. install - 安装技能
alphaclaw install \x3C技能名称> [选项]
下载并安装技能到本地。默认安装到当前项目的 skills/ 目录下。
选项：
| 选项 | 说明 |
|---|---|
--version \x3Cver> |
安装指定版本（默认最新版） |
--force |
强制覆盖已安装的技能 |
--dir \x3Cpath> |
自定义安装目录 |
示例：
alphaclaw install xiaohongshu-upload
alphaclaw install xiaohongshu-upload --version 1.0.0
alphaclaw install xiaohongshu-upload --force
alphaclaw install xiaohongshu-upload --dir ./my-skills
安装记录保存在 ~/.skillhub/skills-lock.json。
6. list - 查看已安装的技能
alphaclaw list
列出本地已安装的所有技能，显示名称、版本、安装路径和安装时间。
7. publish - 发布技能
alphaclaw publish [目录路径] [选项]
将技能目录打包为 zip 并上传到 SkillHub。目录中必须包含 SKILL.md 文件。
选项：
| 选项 | 说明 |
|---|---|
--yes, -y |
跳过确认提示，直接发布 |
示例：
# 发布当前目录
cd my-skill/
alphaclaw publish
# 发布指定目录
alphaclaw publish ./my-skill
# 跳过确认直接发布
alphaclaw publish ./my-skill --yes
发布流程：
- 读取并校验
SKILL.md的 YAML frontmatter - 如果未设置 category，交互式选择分类
- 显示元数据预览，确认后打包上传
- 上传后进入"待审批"状态，管理员审批通过后上线
8. comment - 发表评论
alphaclaw comment \x3C技能名称>
对指定技能发表评论，执行后在终端输入评论内容。
示例：
alphaclaw comment xiaohongshu-upload
9. favorite - 收藏/取消收藏
alphaclaw favorite \x3C技能名称> [选项]
选项：
| 选项 | 说明 |
|---|---|
--remove |
取消收藏 |
示例：
alphaclaw favorite xiaohongshu-upload # 收藏
alphaclaw favorite xiaohongshu-upload --remove # 取消收藏
全局选项
所有命令均支持以下全局选项：
| 选项 | 说明 |
|---|---|
--api \x3Curl> |
覆盖 API 基础 URL |
--version, -v |
显示版本号 |
--help, -h |
显示帮助信息 |
--debug |
显示调试信息（排查问题时使用） |
技能包格式
发布技能时，目录中必须包含 SKILL.md，格式如下：
---
name: my-skill
version: 1.0.0
type: SKILL
category: other
description: "技能描述"
github-url: https://github.com/example/repo
---
# 技能标题
详细说明...
字段说明
| 字段 | 必填 | 说明 |
|---|---|---|
| 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 | 其他 |
目录结构推荐
my-skill/
├── SKILL.md # 必需 - 技能声明和指令
├── scripts/ # 可选 - 可执行脚本
├── references/ # 可选 - 参考文档
├── assets/ # 可选 - 模板、资源文件
└── prompts/ # 可选 - Prompt 模板
配置文件位置
| 文件 | 路径 | 说明 |
|---|---|---|
| 认证凭证 | ~/.alphaclaw/auth.json |
AK/SK 存储 |
| 安装锁文件 | ~/.skillhub/skills-lock.json |
已安装技能记录 |
| 技能目录 | ./skills/ |
默认安装位置 |
环境变量
| 变量 | 说明 | 默认值 |
|---|---|---|
SKILLHUB_API |
API 地址 | https://api.alphashop.cn |
NO_COLOR |
禁用彩色输出 | - |
常见工作流
安装一个技能
alphaclaw login # 首次使用需要登录
alphaclaw search "小红书" # 搜索技能
alphaclaw info xiaohongshu-upload # 查看详情
alphaclaw install xiaohongshu-upload # 安装
alphaclaw list # 确认已安装
创建并发布一个技能
mkdir my-skill && cd my-skill
# 创建 SKILL.md（包含 frontmatter 和指令内容）
cat > SKILL.md \x3C\x3C 'EOF'
---
name: my-skill
version: 1.0.0
type: SKILL
description: "我的技能描述"
---
# My Skill
技能使用说明...
EOF
# 添加脚本等资源
mkdir scripts
# ... 添加你的文件
# 发布
alphaclaw login # 确保已登录
alphaclaw publish # 发布到 SkillHub
故障排查
遇到问题时，使用 --debug 查看详细信息：
alphaclaw install some-skill --debug
alphaclaw publish --debug
常见问题：
- 认证失败：重新执行
alphaclaw login - 安装失败：检查网络连接，或加
--force重试 - 发布被拒绝：检查 SKILL.md 格式是否正确，name 字段是否符合命名规范
安全使用建议
This SKILL.md is internally consistent for a CLI tool, but it instructs you to install an npm package (1688alphaclaw) and to enter/store AK/SK credentials locally. Before installing or using it: 1) verify the npm package page and source repository (confirm publisher, read package README, check recent versions and downloads); 2) review the package code or its GitHub repo if possible (the skill bundle here contains no executable code); 3) only use least-privilege API keys (restrict scope, rotate keys) and avoid putting high-privilege credentials in your primary account; 4) protect the auth file (set restrictive permissions, e.g., chmod 600) and consider storing secrets in a secure vault if available; 5) when publishing, be aware you will be uploading local files — review what you package before upload. These steps will reduce risk from installing and running external CLI code.
功能分析
Type: OpenClaw Skill
Name: alphaclaw
Version: 1.0.2
The 'alphaclaw' skill bundle (SKILL.md) instructs the AI agent to perform a global installation of an external npm package (1688alphaclaw) and manage sensitive Access/Secret Keys stored in ~/.alphaclaw/auth.json. While these actions are consistent with the stated purpose of a CLI tool for the SkillHub platform (alphashop.cn), the requirement for global software installation and the handling of credentials via automated agent instructions represent high-risk behaviors. Without the ability to verify the external npm package's integrity, these instructions are classified as suspicious due to the potential for RCE or credential harvesting.
能力评估
Purpose & Capability
The name/description match the SKILL.md: a CLI for searching, installing, publishing and managing SkillHub skills. Commands, AK/SK login, publish/install flows, and referenced endpoints (alphashop.cn, api.alphashop.cn, skill.alphashop.cn) are coherent with the stated purpose.
Instruction Scope
Instructions stay within the tool's domain (login, search, install, publish, comment, favorite). They instruct opening a browser to obtain AK/SK and saving credentials to ~/.alphaclaw/auth.json, and packaging/uploading a zip when publishing — all expected for a CLI that interacts with a remote skill hub. There is no instruction to read unrelated system files or exfiltrate arbitrary data, but the docs direct the user to upload local directories when publishing (expected but powerful).
Install Mechanism
The registry has no install spec, but SKILL.md tells the user to run 'npm install -g 1688alphaclaw' — this is normal for a Node CLI but means you will be running external code from npm. Because the skill bundle itself contains no code, the actual runtime behavior depends entirely on that npm package; verify the package source before installing.
Credentials
No unusual environment variables or unrelated credentials are requested. The tool uses AK/SK for the SkillHub API (expected) and optionally respects SKILLHUB_API. It stores credentials in ~/.alphaclaw/auth.json — storing secrets locally is expected but requires attention to file permissions and key scope/rotation.
Persistence & Privilege
The skill does not request permanent/always-on privileges, does not modify other skills' configs, and is user-invocable only. No elevated platform privileges are requested in the SKILL.md.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install alphaclaw - 安装完成后，直接呼叫该 Skill 的名称或使用
/alphaclaw触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.2
- 增加 metadata 字段，包括版本号、标签和作者信息
- 版本号移至 metadata 内的 version 字段
- 其余功能和使用方式未变，保持与上个版本一致
v1.0.1
AlphaClaw 1.0.1 introduces an official CLI for SkillHub, enabling users to efficiently manage Claude Code skills.
- New command-line tool for searching, installing, publishing, and managing skills via terminal.
- Supports AK/SK authentication and JWT token auto-refresh.
- Provides commands for login, skill search, install, publish, comment, favorite, and more.
- Includes skill version control, installation path selection, and skill publishing flow with YAML frontmatter validation.
- Global options for API URL overrides, debug mode, and help/version info.
- Comprehensive documentation for setup, workflows, troubleshooting, and environment variables.
元数据
常见问题
alphaclaw 是什么？
AlphaClaw 是 SkillHub 技能商店的 CLI 工具，用于搜索、安装、发布和管理 Claude Code 技能。支持 AK/SK 登录、关键词搜索技能、一键安装/发布技能包、收藏和评论等完整功能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 189 次。
如何安装 alphaclaw？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install alphaclaw」即可一键安装，无需额外配置。
alphaclaw 是免费的吗？
是的，alphaclaw 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
alphaclaw 支持哪些平台？
alphaclaw 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 alphaclaw？
由 1688AiInfra（@1688aiinfra）开发并维护，当前版本 v1.0.2。
推荐 Skills