> For the complete documentation index, see [llms.txt](https://minara.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minara.ai/docs/minara-handbook/zh/jiao-yi/minara-skills.md).

# 技能

## 什么是 Minara Skills？

Minara Skills 是官方技能包，可让任何兼容的 AI 智能体访问加密货币和股票交易、链上执行以及市场情报。一旦安装，你的智能体就能通过自然语言与它对话，分析并交易加密货币、美国股票、大宗商品和外汇；在 EVM、Solana 和 Hyperliquid 上执行链上交易；管理钱包和信用卡入金；并获取实时市场情报——全部都可以通过自然语言与它交互完成。

Minara Skills 运行在 [Minara CLI](https://www.npmjs.com/package/minara) 之上，并作为即插即用包提供给 [Claude Code](https://claude.com/claude-code), [OpenClaw](https://docs.openclaw.ai/tools/skills)以及 [Hermes](https://hermes-agent.nousresearch.com/).

**使用 Minara Skills 你可以做什么：**

* 按代号、代币名称或合约地址，在 19 个网络上买入、卖出、兑换、转换和转移现货资产
* 在 Hyperliquid 上使用杠杆、多钱包管理和 AI 自动驾驶开平永续合约仓位
* 下达、列出和取消现货与永续合约限价单
* 在现货与永续钱包之间存入、提取和转账，包括通过 MoonPay 的信用卡入金
* 获取链上数据、代币基本面、巨鲸资金流、热门代币和股票、股票研究、大宗商品和外汇
* 支付 [x402](https://www.x402.org/)启用的 HTTP API，直接从 Minara 钱包中发起
* 管理你的 Minara 订阅、积分和高级套餐

***

## Minara Skills 适合谁？

| 用户类型           | 经验水平                                | 使用方式                                                                        |
| -------------- | ----------------------------------- | --------------------------------------------------------------------------- |
| **零售交易者**      | 任意                                  | 用通俗英语和你的智能体对话： *"买入价值 100 美元的 ETH"*, *"做多 ETH 永续 5 倍杠杆"*, *"今天有什么热门？"*      |
| **高级用户与量化交易者** | 熟悉 CLI                              | 直接驱动底层 [Minara CLI](https://www.npmjs.com/package/minara) 用于脚本、批处理任务和可复现工作流 |
| **智能体开发者**     | 基于 Claude Code、OpenClaw 或 Hermes 构建 | 把技能包放入你的智能体技能目录，并将 Minara 作为一等工具调用——无需胶水代码                                  |

***

## 如何访问

Minara Skills 通过 GitHub 分发： [github.com/Minara-AI/skills](https://github.com/Minara-AI/skills).

使用对应运行时的一键安装器，将其安装到三种受支持的智能体运行时之一（Claude Code、OpenClaw 或 Hermes）中，然后在智能体内部运行 `登录 Minara` 进行认证。

你需要：

* 已正常安装 Claude Code、OpenClaw 或 Hermes
* Node.js（用于 `npm install -g minara`)
* 一个 Minara 账户（[minara.ai](https://minara.ai))

***

## 安装

选择与你的智能体匹配的安装器。每个一键脚本都会从 npm 安装 Minara CLI，将技能文件复制到智能体的技能目录，并启动登录流程。

### Claude Code

将以下提示发送给你的 Claude Code 智能体：

```
运行 "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/claudecode-minara-skill-setup.sh | bash" 以安装 Minara CLI、Minara Skills 并设置以下配置。出现提示时，请跟随登录链接。
```

这会全局安装 Minara CLI，将技能复制到 `~/.claude/skills/minara`，并在浏览器中打开登录链接。

**手动安装：**

```bash
npm install -g minara@latest
git clone https://github.com/Minara-AI/skills.git /tmp/minara-skills
cp -r /tmp/minara-skills/skills/minara ~/.claude/skills/minara
```

### OpenClaw

将以下提示发送给你的 OpenClaw 智能体：

```
运行 "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/openclaw-minara-skill-setup.sh | bash" 以安装 Minara CLI、Minara Skills 并设置以下配置。出现提示时，请跟随登录链接。
```

这会安装 CLI，将技能复制到 `~/.openclaw/skills/minara`，将技能注册到 `openclaw.json`，并启动登录。

**ClawHub：**

```bash
clawhub install lowesyang/minara
```

**手动安装：** 克隆仓库，复制 `skills/minara` 到你的 OpenClaw 工作区，然后将技能添加到 `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "minara": {
        "enabled": true
      }
    }
  }
}
```

### Hermes

将以下提示发送给你的 Hermes 智能体：

```
运行 "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/hermes-minara-skill-setup.sh | bash" 以安装 Minara CLI、Minara Skills 并设置以下配置。出现提示时，请跟随登录链接。
```

这会安装 Minara CLI，将技能复制到 `~/.hermes/skills/minara`，并启动登录流程。

所有设置脚本都具备幂等性。它们支持三级技能下载回退：ClawHub → GitHub → clawhub CLI。

***

## 首次运行流程

验证安装是否端到端成功的最快方式。只需三条命令，就能从全新安装进入你的第一笔交易。

{% stepper %}
{% step %}
**登录**

告诉智能体： *"登录 Minara"*。智能体会运行 CLI 登录命令并打开浏览器标签页。使用你的 Minara 账户进行认证；CLI 会将会话保存在本地。
{% endstep %}

{% step %}
**为你的钱包充值**

告诉智能体： *"显示我的 Minara 存款地址"* 用于存入现有加密货币，或者 *"用信用卡购买加密货币"* 通过 MoonPay 入金。若要交易永续合约，继续使用 *"向永续钱包存入 500 USDC"* 将资金从现货转入 Hyperliquid 永续钱包。
{% endstep %}

{% step %}
**交易**

告诉智能体你想做什么： *"买入价值 100 USDC 的 ETH"*, *"将 0.1 ETH 兑换为 USDC"*，或者 *"做多 ETH 永续，5 倍杠杆"*。智能体会在执行前确认交易详情。请在批准前仔细查看 **风险披露** 。
{% endstep %}
{% endstepper %}

***

## 现货交易

现货交易涵盖在所有 [受支持网络](#supported-networks)上买入、卖出、兑换、转换和转移代币。你可以通过代号（`ETH`, `SOL`）、名称（`ethereum`）或合约地址来引用资产。

**示例：**

* *"买入价值 100 USDC 的 ETH"*
* *"卖出我全部的 SOL"*
* *"在 Base 上将 0.1 ETH 兑换为 USDC"*
* *"转账 50 USDC 到 0xabc..."*

智能体会根据你的钱包余额和资产选择正确的网络和路由。

***

## 永续合约

永续合约通过 Hyperliquid 路由。你可以开平仓、设置杠杆、管理多个钱包并查看交易历史。

**示例：**

* *"做多 ETH 永续"*
* *"做空 BTC，10 倍杠杆"*
* *"平掉我的 ETH 仓位"*
* *"显示我的永续历史"*

### AI 自动驾驶

自动驾驶可让智能体根据策略替你管理永续仓位。通过 *"为永续合约启用 AI 自动驾驶"*&#x6765;开启。自动驾驶只会在你授权的范围内行动，你可以随时关闭。

> **风险：** 永续合约是杠杆产品。亏损可能超过你的初始保证金。在启用自动驾驶或开设杠杆仓位前，请先查看风险披露。

***

## 限价单

限价单同时适用于现货和永续合约。可下单、列出未完成订单，并按 ID 取消。

**示例：**

* *"当价格达到 3000 美元时买入 ETH"*
* *"以 150 美元买入 SOL"*
* *"列出我的限价单"*
* *"取消限价单 \[id]"*

***

## 钱包与资金

| 操作            | 示例提示                                        |
| ------------- | ------------------------------------------- |
| **检查余额**      | *"我的余额是多少？"* / *"显示我的加密资产组合"*               |
| **存款**        | *"显示我的存款地址"* / *"用信用卡购买加密货币"*               |
| **现货 ↔ 永续转账** | *"向永续钱包存入 500 USDC"* / *"从永续钱包提取 200 USDC"* |
| **链上提现吗**     | *"向 \[地址] 提取 10 SOL"*                       |
| **支付**        | *"向 \[地址] 支付 100 USDC"*                     |

信用卡入金使用 MoonPay。转账到外部地址会在链上执行，并收取标准网络费用。

***

## 市场情报

Minara Skills 将 Minara 的完整市场情报栈暴露给你的智能体：实时链上数据、代币基本面、巨鲸资金流、热门代币和股票、股票研究、大宗商品和外汇。

**示例：**

* *"哪些代币正在走热？"*
* *"搜索 SOL 代币"*
* *"给我看看 ETH 的巨鲸资金流"*
* *"NVDA 的前景如何？"*
* *"现在金价是多少"*

***

## x402 支付

Minara Skills 可以直接从你的 Minara 钱包支付 [x402](https://www.x402.org/)启用的 HTTP API。这让你的智能体无需你单独处理 API 密钥或充值，就能调用付费 API。

CLI 会处理 x402 握手；只有在付费调用即将结算时，你才会看到智能体请求确认。

***

## 高级版

在智能体内部管理你的 Minara 订阅、积分余额和套餐。

**示例：**

* *"显示我的积分"*
* *"升级我的 Minara 套餐"*
* *"我当前使用的是什么套餐？"*

***

## 受支持网络

现货交易和链上操作可在以下网络上使用：

Ethereum、Base、Arbitrum、Optimism、Polygon、Avalanche、Solana、BSC、Berachain、Blast、Manta、Mode、Sonic、Conflux、Merlin、Monad、Polymarket、XLayer。

永续合约通过 Hyperliquid 路由。

***

## 基准测试

Minara Skills 在 **88/100** 上的得分 [crypto-skill-bench](https://github.com/Minara-AI/crypto-skill-benchmark) v3.0.2，使用 Claude Sonnet 4.6 在 76 个场景上评估。

| 维度   | 分数 |
| ---- | -- |
| 安全性  | 91 |
| 覆盖率  | 86 |
| 鲁棒性  | 88 |
| 路由   | 88 |
| 用户体验 | 86 |

66 个场景通过，10 个部分通过，0 个失败。安全门禁：通过。

该基准测试是开源的。你可以复现运行、检查每个场景，并与其他技能包进行比较。

***

## Minara Skills 能做什么和不能做什么

### 你可以定义什么

* 智能体运行时（Claude Code、OpenClaw 或 Hermes）
* 你想交易的网络和资产
* 是否为永续合约启用 AI 自动驾驶，以及其作用范围
* 限价单价格、杠杆水平和保证金分配
* 通过链上存款还是信用卡入金进行充值

### 平台控制什么

* 订单路由和执行场所选择
* 网络费用和链上确认时间
* Hyperliquid 的永续合约流动性、资金费率和清算逻辑
* MoonPay 的信用卡入金 KYC 和定价
* 技能版本更新（由 `version-check.sh` 在每次会话中管理）

### 当前限制

* 该技能仅绑定于三种受支持的运行时；其他智能体框架尚未集成。
* 不支持直接将资金存入永续钱包。资金必须先进入现货，再进行转账。
* Hyperliquid 对永续合约提现收取 1 USDT 手续费；该技能不会免除这一费用。
* 永续合约仅可在 Hyperliquid 上使用。其他永续交易场所当前未被路由。
* 某些高级订单类型（TWAP、冰山单）未通过自然语言提示暴露。

***

## 获得更好结果的建议

1. **对金额和资产要具体明确。** *"买入价值 100 美元的 ETH"* 是明确的； *"买一些 ETH"* 会触发澄清流程。
2. **如有疑问，请注明网络名称。** *"在 Base 上将 0.1 ETH 兑换为 USDC"* 可避免智能体自行推断路由。
3. **批准前先确认。** 智能体在执行前总会展示交易详情。请阅读；如果有任何异常就拒绝。
4. **从小开始。** 先用 5 美元的兑换验证安装，再投入真实资金。
5. **对于你重视的入场点，请使用限价单。** 市价单更快，但在流动性薄的交易对上精确度较低。
6. **保持 CLI 为最新版本。** 运行 `minara --version` 并与 npm 上的版本比较；会话级 `version-check.sh` 脚本会自动标记升级。
7. **在你理解的范围内授权自动驾驶。** 在扩大量级之前，先从单一资产和小额保证金分配开始。

***

## 免责声明

* 所有交易都存在风险。只用你能承受损失的资金进行交易。
* 永续合约是杠杆产品。亏损可能超过你的初始保证金。
* Minara Skills 是一个让你的智能体操作 Minara 平台的工具。它不构成财务建议。
* Minara **不** 提供流动性或作为对手方。现货路由通过外部交易场所；永续合约在 Hyperliquid 上执行。
* 你始终保有完全控制权。你可以随时关闭自动驾驶、取消限价单或提取资金。
* 历史基准表现并不保证未来结果。

***

## 链接

* 仓库： [github.com/Minara-AI/skills](https://github.com/Minara-AI/skills)
* npm 上的 CLI： [npmjs.com/package/minara](https://www.npmjs.com/package/minara)
* 基准测试： [github.com/Minara-AI/crypto-skill-benchmark](https://github.com/Minara-AI/crypto-skill-benchmark)
* 许可证：MIT


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://minara.ai/docs/minara-handbook/zh/jiao-yi/minara-skills.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
