← 返回 Skills 市场
514
总下载
10
收藏
1
当前安装
4
版本数
在 OpenClaw 中安装
/install exchange
功能描述
货币汇率换算、热门汇率、货币列表及银行外汇牌价等。当用户说：100 美元换多少人民币？今天中行美元现汇价？或类似汇率换算问题时，使用本技能。
使用说明 (SKILL.md)
\r \r
极速数据汇率查询（Jisu Exchange）\r
\r
数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r
- 汇率换算：任意两种货币之间的金额换算；\r
- 单个货币：某一货币相对热门货币的实时汇率列表；\r
- 所有货币：查询所有支持的货币代码及名称；\r
- 十大银行外汇牌价：查询银行中间价、买入价、卖出价等。\r \r
汇率为综合汇率，仅供参考，来源详见极速数据文档
https://www.jisuapi.com/api/exchange/。\r \r
前置配置：获取 API Key\r
\r
# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/exchange/exchange.py`\r
\r
## 使用方式\r
\r
### 1. 汇率换算（/exchange/convert）\r
\r
```bash\r
python3 skills/exchange/exchange.py '{"from":"CNY","to":"USD","amount":10}'\r
```\r
\r
请求 JSON：\r
\r
```json\r
{\r
"from": "CNY",\r
"to": "USD",\r
"amount": 10\r
}\r
```\r
\r
### 2. 单个货币热门汇率（/exchange/single）\r
\r
```bash\r
python3 skills/exchange/exchange.py single CNY\r
```\r
\r
### 3. 所有货币列表（/exchange/currency）\r
\r
```bash\r
python3 skills/exchange/exchange.py currency\r
```\r
\r
### 4. 十大银行外汇牌价（/exchange/bank）\r
\r
```bash\r
# 默认中国银行 BOC\r
python3 skills/exchange/exchange.py bank\r
\r
# 指定银行（示例：工商银行 ICBC）\r
python3 skills/exchange/exchange.py bank ICBC\r
```\r
\r
支持的银行编码示例：\r
\r
- `ICBC`：工商银行\r
- `BOC`：中国银行\r
- `ABCHINA`：农业银行\r
- `BANKCOMM`：交通银行\r
- `CCB`：建设银行\r
- `CMBCHINA`：招商银行\r
- `CEBBANK`：光大银行\r
- `SPDB`：浦发银行\r
- `CIB`：兴业银行\r
- `ECITIC`：中信银行\r
\r
## 请求参数\r
\r
### 汇率换算\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|--------|--------|------|---------------------------------|\r
| from | string | 是 | 原货币代码（如 CNY、USD） |\r
| to | string | 是 | 目标货币代码 |\r
| amount | number | 否 | 数量（默认 1） |\r
\r
### 单个货币\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|----------|--------|------|----------|\r
| currency | string | 是 | 货币代码 |\r
\r
### 所有货币\r
\r
无需额外参数，仅需 `appkey`。\r
\r
### 银行外汇牌价\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|--------|--------|------|------------------------------------|\r
| bank | string | 否 | 银行编码，不传则默认为 BOC（中国银行） |\r
\r
## 返回结果示例\r
\r
### 汇率换算（简化）\r
\r
```json\r
{\r
"from": "CNY",\r
"to": "USD",\r
"fromname": "人民币",\r
"toname": "美元",\r
"updatetime": "2015-10-26 16:56:22",\r
"rate": "0.1574",\r
"camount": "1.574"\r
}\r
```\r
\r
### 单个货币热门汇率（简化）\r
\r
```json\r
{\r
"currency": "CNY",\r
"name": "人民币",\r
"list": {\r
"USD": {\r
"name": "美元",\r
"rate": "0.1574",\r
"updatetime": "2015-10-26 16:56:22"\r
},\r
"EUR": {\r
"name": "欧元",\r
"rate": "0.1426",\r
"updatetime": "2015-10-26 16:56:22"\r
}\r
}\r
}\r
```\r
\r
### 所有货币列表（简化）\r
\r
```json\r
[\r
{ "currency": "USD", "name": "美元" },\r
{ "currency": "EUR", "name": "欧元" },\r
{ "currency": "CNY", "name": "人民币" }\r
]\r
```\r
\r
### 银行外汇牌价（简化）\r
\r
```json\r
{\r
"bank": "BOC",\r
"list": [\r
{\r
"code": "USD",\r
"name": "美元",\r
"midprice": "717.4100",\r
"cashbuyprice": "722.0800",\r
"forexbuyprice": "722.0800",\r
"cashsellprice": "725.1100",\r
"forexsellprice": "725.1100",\r
"updatetime": "2025-03-11 18:05:59"\r
}\r
]\r
}\r
```\r
\r
当出现参数错误（如货币代码有误、数量为空等）时，脚本会输出：\r
\r
```json\r
{\r
"error": "api_error",\r
"code": 204,\r
"message": "要兑换的货币有误"\r
}\r
```\r
\r
## 常见错误码\r
\r
来源于 [极速数据汇率文档](https://www.jisuapi.com/api/exchange/)：\r
\r
| 代号 | 说明 |\r
|------|------------------|\r
| 201 | 要兑换的货币为空 |\r
| 202 | 兑换后的货币为空 |\r
| 203 | 兑换数量为空 |\r
| 204 | 要兑换的货币有误 |\r
| 205 | 兑换后的货币有误 |\r
| 206 | 货币为空 |\r
| 207 | 货币有误 |\r
| 208 | 没有信息 |\r
\r
系统错误码：\r
\r
| 代号 | 说明 |\r
|------|----------------------|\r
| 101 | APPKEY 为空或不存在 |\r
| 102 | APPKEY 已过期 |\r
| 103 | APPKEY 无请求权限 |\r
| 104 | 请求超过次数限制 |\r
| 105 | IP 被禁止 |\r
\r
## 推荐用法\r
\r
1. 用户输入自然语言：「帮我把 1000 人民币换算成美元，大概是多少？」 \r
2. 代理构造 JSON：`{"from":"CNY","to":"USD","amount":1000}` 并调用： \r
`python3 skills/exchange/exchange.py '{"from":"CNY","to":"USD","amount":1000}'` \r
3. 从返回结果中读取 `rate` 和 `camount`，向用户说明当前汇率与折算后的金额； \r
4. 若用户询问某货币常见汇率，可使用 `single` 或 `currency` / `bank` 子命令补充汇率表或银行牌价信息。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r
安全使用建议
This skill appears to do what it claims: it sends requests to api.jisuapi.com and returns exchange data. Before installing, ensure you are comfortable providing a JISU_API_KEY (the key will be sent to JisuAPI), verify your JisuAPI account/quotas, and install the Python 'requests' library in the agent environment. Because the skill's homepage/source is unknown, consider creating or using a dedicated API key with limited scope/quota rather than a highly-privileged account. If you need higher assurance, review the JisuAPI privacy/TOS and run the script in an isolated environment to confirm behavior.
功能分析
Type: OpenClaw Skill
Name: exchange
Version: 1.0.3
The exchange skill is a legitimate integration with the JisuAPI service for currency conversion and bank exchange rates. The Python script (exchange.py) correctly handles API requests using the requests library and retrieves the API key from an environment variable as specified in SKILL.md, with no evidence of malicious execution, data exfiltration, or prompt injection.
能力评估
Purpose & Capability
Name/description, SKILL.md, and exchange.py align: the skill queries JisuAPI exchange endpoints and needs an AppKey (JISU_API_KEY). Requiring python3 is expected for the provided Python script.
Instruction Scope
SKILL.md instructs only how to call the included script and how to set JISU_API_KEY. The instructions and script only access the environment variable JISU_API_KEY and make HTTP requests to api.jisuapi.com; they do not read arbitrary files, other env vars, or send data to unexpected endpoints.
Install Mechanism
This is instruction-only with an included Python script (no install spec). The script uses the third-party 'requests' library but the skill metadata does not declare this dependency—users must ensure 'requests' is available. Network calls go to the documented JisuAPI endpoints (expected).
Credentials
Only JISU_API_KEY is required and declared as the primary credential, which is proportionate for calling the JisuAPI service. No other credentials or config paths are requested.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system config, and is user-invocable. Autonomous invocation remains possible (platform default) but is not combined with elevated privileges here.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install exchange - 安装完成后，直接呼叫该 Skill 的名称或使用
/exchange触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.3
- Improved skill name and description for better clarity and context matching user questions.
- Polished setup instructions and API feature descriptions.
- No functional or code changes in this version.
v1.0.2
- 优化说明，添加关于极速数据（JisuAPI）平台的详细介绍和能力概览
- 更新 API Key 获取与配置流程说明，更方便新用户上手
- 增加“关于极速数据”版块，列举更多 API 类型及应用示例
- 细化文档结构和推荐用法，提升可读性和指引性
- 说明 ClawHub 可搜索更多基于极速数据的技能
v1.0.1
- No changes detected in this version.
- Documentation, features, and usage remain the same as previous release.
v1.0.0
Initial release of jisu-exchange:
- Provides real-time currency conversion, single-currency rate lists, supported currency codes, and top-10 bank forex quotes via Jisu API.
- Includes command-line usage examples for all supported features.
- Documents required environment variable: JISU_API_KEY.
- Details request/response formats, error codes, and sample outputs.
- Lists supported bank codes for forex price queries.
- Recommends best practices for integration and typical user flows.
元数据
常见问题
Exchange Rate Inquiry & Conversion - 汇率查询 是什么？
货币汇率换算、热门汇率、货币列表及银行外汇牌价等。当用户说：100 美元换多少人民币？今天中行美元现汇价？或类似汇率换算问题时，使用本技能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 514 次。
如何安装 Exchange Rate Inquiry & Conversion - 汇率查询？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install exchange」即可一键安装，无需额外配置。
Exchange Rate Inquiry & Conversion - 汇率查询 是免费的吗？
是的，Exchange Rate Inquiry & Conversion - 汇率查询 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Exchange Rate Inquiry & Conversion - 汇率查询 支持哪些平台？
Exchange Rate Inquiry & Conversion - 汇率查询 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Exchange Rate Inquiry & Conversion - 汇率查询？
由 极速数据（@jisuapi）开发并维护，当前版本 v1.0.3。
推荐 Skills