# @bitget-ai/bitget-agent-skill 中文文档

规范地址：https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/

版本：3\.3\.1
npm 元数据更新时间：2026-09-20T08:39:32.296Z
中文译文更新时间：2026-11-08T05:09:27.212Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bitget-ai/bitget-agent-skill
原文对照：https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：168 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：0 个
- 首次发布：2026-06-15T07:19:14.587Z
- 最新版本发布：2026-09-20T08:39:32.106Z
- 近 30 天下载量：2062（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

官方 Bitget AI 技能 — 教Claude Code, Codex, 和 OpenClaw 何时以及如何通过 Bitget 统一交易账户(UTA / v3) API `bgc` 自然语言的CLI. 运行 `npx @bitget-ai/bitget-agent-skill` 在您的 AI 工具中部署

## 安装

```sh
npm install @bitget-ai/bitget-agent-skill
```

也可以使用：`pnpm add @bitget-ai/bitget-agent-skill`、`yarn add @bitget-ai/bitget-agent-skill`、`bun add @bitget-ai/bitget-agent-skill`

## README

![Bitget Agent Skill — AI reasoning guide for Claude Code, Codex and terminal crypto trading](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/assets/logo.png)

# bitget - 代理技能 - 官方 Bitget AI 交易技能

**给克洛德代码(Claude Code),Codex,和OpenClaw(OpenClaw)以判断理解你的交易指令——何时拨打Bitget,如何建立正确的指令,当出事时怎么办.**

[![npm version](https://img.shields.io/npm/v/%40bitget-ai%2Fbitget-agent-skill.svg?style=flat-square&color=28a745)](https://www.npmjs.com/package/@bitget-ai/bitget-agent-skill) [![npm downloads](https://img.shields.io/npm/dm/%40bitget-ai%2Fbitget-agent-skill.svg?style=flat-square&color=026e00)](https://www.npmjs.com/package/@bitget-ai/bitget-agent-skill) ![Node.js ≥ 20](https://img.shields.io/badge/Node.js-%E2%89%A520-026e00?style=flat-square) [![MIT License](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/LICENSE)

[快速启动](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/#readme-quick-start) • 妇女 [什么样的变化](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/#readme-what-changes-after-installing) • 妇女 [为什么是技能](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/#readme-why-a-skill-vs-just-installing-bgc) • 妇女 [安装](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/#readme-installation) • 妇女 [警卫](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/#readme-security) • 妇女 [解决问题](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/#readme-troubleshooting) • 妇女 [财务问题](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/#readme-faq)

* * *

> **位元代理 Hub** 是Bitget的官方开源AI代理生态系统. 此寄存器为 `bitget-agent-skill` - 那个 **技术表面** 用于教学终端 AI 代理 何时以及如何正确引用 Bitget 工具 。 生态系统一揽子计划: [代理技能](https://github.com/Bitget-AI/agent-skill) (这回), [代理目录](https://github.com/Bitget-AI/agent-cli), (中文(简体) ), [代理服务器- mcp](https://github.com/Bitget-AI/agent-mcp), (中文(简体) ), [代理服务器](https://github.com/Bitget-AI/agent-sdk), (中文(简体) ), [位元符号](https://github.com/Bitget-AI/bitget-signal), (中文(简体) ), [代理服务器( h)](https://github.com/Bitget-AI/agent_hub)。 。 。 .

`@bitget-ai/bitget-agent-skill` 是 Bitget 的官方 AI 交易技能文件,赋予 Claude Code, Codex, 和 OpenClaw 正确使用 Bitget 工具的判断 —— 知道何时引用 Bitget, 如何打破你的意图进入正确的多步操作, 如何在写入动作前处理确认, 以及当出事时该怎么办 。 纯打分,无跑时.

**这是给你的吗?** 你已经在使用克洛德代码(Claude Code),Codex(Codex)或OpenClaw(OpenClaw),希望它能真正理解你的交易指令——不仅拥有工具,而且缺乏使用工具的推理——安装这个.

* * *

## 快速启动

将下面的块粘入您的 AI 代理 —— 它将处理整个设置( 需要 Node. js 20+) :

```prompt
Please help me install the Bitget trading skill (requires Node.js 20+): 1. Run npx @bitget-ai/bitget-agent-skill --target all to deploy the skill files to my AI tool; 2. Run npm install -g @bitget-ai/bitget-agent-cli to install the bgc CLI globally. Tell me the result when done.
```

> 两者必须一起安装: 技能文件是AI的指令手册, `bgc` 是执行工具——技能教导AI何时称呼它以及如何构建命令, `bgc` 实际使 API 请求。 没有其中之一,完全流量是不完整的.

**检查它的工作.** 问你的AI: _"Bitget支持什么交易模块?"_ 如果返回正确的模块列表(市场,交易,账户等),则技能被加载并活动.

* * *

## 安装后有什么变化

```mermaid
graph LR
    A[You<br/>Natural Language] --> B[Claude Code / Codex<br/>with bitget-agent-skill]
    B -->|Generates v3 Command| C[bgc CLI<br/>bitget-agent-cli]
    C -->|HMAC-SHA256 Signed| D[Bitget REST API]
    style B fill:#28a745,stroke:#333,stroke-width:2px,color:#fff
```

没有技能, `bgc` 一次执行一个命令。 凭借所上载的技能,AI可以将你的意图链入跨模块的一连串操作——检查位置,评价条件,排列顺序,处理结果——全部一去不复返.

-   **英语和中文的触发识别**:无论你说"在市场上购买BTC"还是"QQ BTC",AI都承认它是一个比特交易指令并自动调用正确的工具——不需要指定命令语法
-   **v3 语法和充分参考**: 技能文件包括 `bgc` v3 语法 (`bgc <tool> --action <name>`)和每个操作的自动生成目录——AI知道什么意图动词映射到哪个操作以及如何填入参数
-   **多步骤工作流程**:"检查我的位置,如果我没有BTC打开10x长"——AI查询首先,原因,然后放出订单,显示 `[CAUTION]` 在每次写操作之前 等待您的确认
-   **纸张交易和错误处理**:告诉AI"使用演示账号"自动切换到Bitget的沙盒;当API出错发生后,AI知道是重新尝试还是向您展示这个问题——而不是卡住

* * *

## 为什么一个技能( v `bgc`(中文(简体) )

单CLI给AI 14意图动词凌驾于统一交易账户(89个业务),但没有语义——助理不知道 **何时** 要达到比特特, **哪个** 动词用于,或 **怎么样** 安全驾驶它.

该技能补充:

-   A 类 **触发描述** 因此克洛德代码 / Codex / OpenClaw 在任何与比特格相关的请求上自动引用技能——包括随意的用词(_"在市场上购买0.1 BTC"_)和汉语(_"查看我的持仓"_) (中文(简体) ).
-   这个 **v3 语法** (单位:千美元)`bgc <tool> --action <name> --<param> <value>`)和a 数据 **发现第一** 工作流程,外加每个动词,动作和参数的完整目录.
-   **业务指导** 用于书写安全(`--dry-run` 编号 : `--confirm`),近向规则,演示交易,出错类别,以及认证设置.

结果: 你说 _"在Bitget市场购买0.1 BTC"_ 并且它实际上有效——助理作曲 `bgc order --action place --category SPOT --symbol BTCUSDT --side buy --orderType market --qty 0.1`预览 `--dry-run`与你确认,然后运行它.

* * *

## 熟练的船舶

| 文件 | 目的 |
| --- | --- |
| `SKILL.md` | 上层技能定义有触发短语(英语+中文),所以AI知道何时引用,外加v3语法,14-动词地图,以及写作安全工作流程. |
| `references/commands.md` | 自动生成的静态目录 — 每个域名, 动词, 动作, 和参数( 有 enums + 描述), 来自 SDK 本身 `discover` 表面. |
| `references/discover-guide.md` | 如何引导活水面 `bgc discover` (这四个跑道,搜索, `raw`) (中文(简体) ). |
| `references/trading-safety.md` | 近向规则(单向/对接)、TP/SL、, `qty` 单位,取消所有,和退出安全. |
| `references/auth-setup.md` | 如何创建 Bitget API 键并配置环境变量 . |
| `references/demo-trading.md` | 如何使用 `--paper-trading` 安全排练. |
| `references/error-codes.md` | V3出错的有效载荷,由类别驱动的回收,以及被曲解的Bitget代码表. |

* * *

## 安装

### 步骤1:安装CLI

```bash
npm install -g @bitget-ai/bitget-agent-cli
```

> 为什么 `-g`? 吗? `bgc` 这是连续的CLI 你人工智能每场通话数十次,必须开 `$PATH`相对而言,这种技能是一发一发的部署: `npx` 复制到您的 AI 工具的技能目录和退出. `npx` 总是拉最新版本,所以后续运行自动升级您.

### 步骤2: 部署技能文件

```bash
# Default — Claude Code only
npx @bitget-ai/bitget-agent-skill

# All supported AI tools
npx @bitget-ai/bitget-agent-skill --target all

# Choose interactively
npx @bitget-ai/bitget-agent-skill --interactive
```

`--target all` 同时部署到克洛德代码(Claude Code),Codex,和OpenClaw.

| 目标 | 技能地点 |
| --- | --- |
| 克劳德代码 | `~/.claude/skills/bitget-agent-skill/` |
| 代码 | `~/.codex/skills/bitget-agent-skill/` |
| 打开Claw | `~/.openclaw/skills/bitget-agent-skill/` |

### 第3步:设立全权证书

```bash
export BITGET_API_KEY="your-api-key"
export BITGET_SECRET_KEY="your-secret-key"
export BITGET_PASSPHRASE="your-passphrase"
```

[创建 API 密钥](https://www.bitget.com/api-doc/common/intro) 如果你没有。 用于演示交易,使用a [Demo API 密钥](https://www.bitget.com/account/demo) 相反:

```bash
export BITGET_DEMO_API_KEY="your-demo-key"
export BITGET_DEMO_SECRET_KEY="your-demo-secret"
export BITGET_DEMO_PASSPHRASE="your-demo-passphrase"
```

### 第4步:重新启动和验证

关闭并重新打开您的 AI 工具, 然后问: _"你有什么比特交易能力?"_

* * *

## 相关工具

| 工具 | 关系 |
| --- | --- |
| [`@bitget-ai/bitget-agent-cli`](https://github.com/Bitget-AI/agent-cli) | 必须一起安装 : `bgc` 是执行工具, 技能文件是AI的指令手册—— 没有其他操作, 也不会起作用 |
| [`@bitget-ai/bitget-agent-mcp`](https://github.com/Bitget-AI/agent-mcp) | 桌面AI( Claude Desktop, cursor) 的替代品—— 否 `bgc` 所需经费 |
| [`@bitget-ai/bitget-signal`](https://github.com/Bitget-AI/bitget-signal) | 市场分析技能——不需要API键. 这种技能处理交易执行; `bitget-signal` 处理市场分析。 辅助,可同时安装 |

* * *

## 警卫

技能文件本身 :

-   不需要 API 密钥- 纯 Markdown
-   没有网络访问——没有运行时间进程
-   没有证书存储——密钥通过环境变量传递到 `bgc`

所有实际的API呼叫通过 `bgc`,其中规定:

-   证书只使用环境变量(无) `.env` 文件解析)
-   `--read-only` 脱去所有写入工具
-   `--paper-trading` 切换到演示环境
-   本地 HMAC- SHA256 请求签名

* * *

## 解决问题

### "技能不被AI承认"

**原因 :** 技能文件未部署或AI工具未重新启动 .

**修补 :**

1.  调动: `npx @bitget-ai/bitget-agent-skill --target all`
2.  完全重新启动您的 AI 工具
3.  校验: 问 _"有什么比特交易模块可用?"_

### "AI有bgc,但不明白交易命令"

**原因 :** 技能文件缺失—— `bgc` 已安装,但AI没有指导手册.

**修补 :** 部署技能并核实文件落在正确位置:

| AI 工具 | 预期地点 |
| --- | --- |
| 克劳德代码 | `~/.claude/skills/bitget-agent-skill/SKILL.md` |
| 代码 | `~/.codex/skills/bitget-agent-skill/SKILL.md` |
| 打开Claw | `~/.openclaw/skills/bitget-agent-skill/SKILL.md` |

### “ bgc: 未找到命令”

**原因 :** `bitget-agent-cli` 未安装或未安装 `$PATH`。 。 。 .

**修补 :** `npm install -g @bitget-ai/bitget-agent-cli` 然后重新启动您的终端.

* * *

## 更新

```bash
# Update all Bitget AI packages
npx @bitget-ai/bitget-agent-installer upgrade-all --target all

# Or update just this skill
npx @bitget-ai/bitget-agent-skill@latest
```

* * *

## 财务问题

**技能安装后AI会自动下订单吗??** 没有。 对于诸如下订单或转移资金等写作操作,AI显示a `[CAUTION]` 注释 等待你的确认 之后执行.

**没有真钱我怎么交易?** 告诉你的AI"使用演示账户"或"使用纸张交易"——它将自动切换到Bitget的Demo交易环境. 需要一个 [Demo API 密钥](https://www.bitget.com/account/demo)。 。 。 .

**这和MCP服务器有什么区别?** 终端 AI (Claude Code, Codex) − 安装 `bitget-agent-skill` + 键 `bgc`。桌面AI( Claude 桌面、 光标) − 安装 `bitget-agent-mcp`. 两者都能使自然语言Bitget进行交易——它们适应不同的AI环境.

**技能文件需要 API 密钥还是网络访问 ?** 没有 没有运行时间进程的纯 Markdown 文件 。 所有API的呼叫都发生在执行时间通过 `bgc`。 。 。 .

**免费吗?** 麻省理工学院有执照,可以自由使用.

* * *

## 捐款

-   **错误报告特性请求( T) :** [GitHub 问题](https://github.com/Bitget-AI/agent-skill/issues)
-   **讨论:** [GitHub 讨论](https://github.com/Bitget-AI/agent-skill/discussions)
-   **安全问题:** [安全@ bitget.com](mailto:security@bitget.com)

* * *

## 许可证

[麻省理工学院](https://npmcn.com/package/%40bitget-ai/bitget-agent-skill/LICENSE) ——个人和商业免费使用.

* * *

部分 **[位元代理 Hub](https://github.com/Bitget-AI/agent_hub)** 生态系统——Bitget官方开源AI代理生态系统.  
交易 Stack – Skill Surface. 交易密码货币带有风险;您负责您AI代理处的任何订单. 使用演示账户在用真实资金交易前安全练习.  
基金会: [代理服务器](https://github.com/Bitget-AI/agent-sdk) 执行: [代理目录](https://github.com/Bitget-AI/agent-cli) 桌面 : [代理服务器- mcp](https://github.com/Bitget-AI/agent-mcp) 市场信号: [位元符号](https://github.com/Bitget-AI/bitget-signal)

## 常见问题

### @bitget-ai/bitget-agent-skill 是什么？

官方 Bitget AI 技能 — 教Claude Code, Codex, 和 OpenClaw 何时以及如何通过 Bitget 统一交易账户\(UTA / v3\) API bgc 自然语言的CLI\. 运行 npx @bitget-ai/bitget-agent-skill 在您的 AI 工具中部署

### 如何安装 @bitget-ai/bitget-agent-skill？

在项目目录运行 npm install @bitget-ai/bitget-agent-skill，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bitget-agent-skill，可以用 npx bitget-agent-skill 直接运行。

### @bitget-ai/bitget-agent-skill 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bitget-ai\_\_bitget-agent-skill 是否存在。

### @bitget-ai/bitget-agent-skill 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bitget-ai/bitget-agent-skill 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bitget-ai/bitget-agent-skill 可以商用吗？

@bitget-ai/bitget-agent-skill 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bitget-ai/bitget-agent-skill 的下载量有多少？

根据 npm 官方下载统计，@bitget-ai/bitget-agent-skill 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,062 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bitget-ai/bitget-agent-skill 还在维护吗？

最新版本 3\.3\.1 发布于 2026/09/20（1 个月前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/06/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。