What makes Chameleon Ultra Cli notable?

3.2K downloads. Trust evidence available

How should Chameleon Ultra Cli be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

agentCLAWHUBUnverified

Chameleon Ultra Cli

控制变色龙(Chameleon)Ultra 读写卡器，通过其 chameleon_cli_main 命令行程序操作设备。当用户想用命令行操作 Chameleon Ultra 设备时使用本技能：连接设备、扫描/读取高频(HF/NFC)或低频(LF)卡片、运行 MIFARE Classic 攻击(nested/darkside/hardnested)、管理模拟卡槽、载入/保存 dump、修改设备设置，或自动化任意 chameleon_cli_main 命令。本技能以非交互方式驱动交互式 REPL，并在首次配置后持久保存可执行文件路径。 Skill: Chameleon Ultra Cli Owner: georgechou17 Summary: 控制变色龙(Chameleon)Ultra 读写卡器，通过其 chameleon_cli_main 命令行程序操作设备。当用户想用命令行操作 Chameleon Ultra 设备时使用本技能：连接设备、扫描/读取高频(HF/NFC)或低频(LF)卡片、运行 MIFARE Classic 攻击(nested/darkside/hardnested)、管理模拟卡槽、载入/保存 dump、修改设备设置，或自动化任意 chameleon_cli_main 命令。本技能以非交互方式驱动交互式 REPL，并在首次配置后持久保存可执行文件路径。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-07-25T15:24:55.695Z | auto Initial release of

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

3.2k

Updated

Oct 9, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 3.2K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 3.2K downloadsadoption · observed Oct 9, 2026
Latest release: 0.1.0release · observed Jul 25, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176y064ps888173yfc6zmjp498b0fqn:chameleon-ultra-cli-skill

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-georgechou17-chameleon-ultra-cli-skill/snapshot"

Documentation

CLAWHUB

30,601 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: chameleon-ultra-cli
description: "控制变色龙(Chameleon)Ultra 读写卡器，通过其 chameleon_cli_main 命令行程序操作设备。当用户想用命令行操作 Chameleon Ultra 设备时使用本技能：连接设备、扫描/读取高频(HF/NFC)或低频(LF)卡片、运行 MIFARE Classic 攻击(nested/darkside/hardnested)、管理模拟卡槽、载入/保存 dump、修改设备设置，或自动化任意 chameleon_cli_main 命令。本技能以非交互方式驱动交互式 REPL，并在首次配置后持久保存可执行文件路径。"
agent_created: true
---

# 变色龙 Ultra CLI 控制器

通过命令直接驱动 Chameleon Ultra 设备的 `chameleon_cli_main` 程序，无需在交互式
REPL 中手动敲命令。本技能把可执行文件包裹在伪终端(pseudo-terminal)中，从而可以脚本化
下发命令并可靠捕获输出（官方 CLI 是交互式的 `prompt_toolkit` REPL，在 Windows 上无法
通过管道输入来驱动）。

## 何时使用

只要用户想通过 CLI 对 Chameleon Ultra 做任何操作，就应使用本技能，包括但不限于：

- 连接 / 断开设备，读取固件版本、芯片 ID、设备模式
- 扫描或读取高频卡(ISO14443-A / NFC)或低频卡(EM410x / HID)
- MIFARE Classic 攻击：`nested`、`darkside`、`hardnested`、密钥恢复
- 管理模拟卡槽（类型、初始化、启用、切换、载入/保存 dump）
- 修改设备设置（LED 动画、BLE 配对密钥）
- 用户提到的任何其他 `chameleon_cli_main` 命令

## 首次配置（必需，仅一次）

可执行文件路径**无法预先获知**。在运行任何命令前，先确认是否已配置：

1. 运行辅助脚本的 `--show-config`。如果 `exe_path` 已设置且有效，则跳到下面的"运行命令"。
2. 如果尚未配置，向用户询问 `chameleon_cli_main` 的完整路径
   （例如 `C:\tools\chameleon\chameleon_cli_main.exe`）。
   使用 AskUserQuestion 工具询问；仅当用户之前提到过某个路径时，才提供合理的默认值。
3. 调用辅助脚本持久化保存：

   ```
   python SKILL_DIR/scripts/chameleon_control.py --set-exe "C:\path\to\chameleon_cli_main.exe"
   ```

   这会把 `exe_path` 保存到脚本同级的 `config.json` 中，之后所有运行都会复用该路径。

始终先检查 `--show-config`；如果路径已保存，不要重复询问用户。

## 运行命令

把用户的需求翻译成一条或多条 `chameleon_cli_main` 命令（命令树参见
`references/cli_reference.md`；设备上可用 command-group -h 查看精确的、与固件版本
对应的语法）。然后用辅助脚本运行，每条命令作为独立引号参数传入：

```
python SKILL_DIR/scripts/chameleon_control.py "hw connect" "hf 14a scan"
```

辅助脚本的关键行为：

- 会自动在命令前补 `hw connect`（除非加 `--no-connect`），并在末尾补 `exit`，
  因此每次调用都是一个全新的、可自行结束的会话。
- 多条命令在同一会话中顺序执行——把相关步骤（如卡槽设置 + 载入 + 启用）放在一次调用中。
- 需要等待卡片或计算的命令（如 `hf 14a scan`、`hf mf nested`）可能耗时较久，
  可用 `--timeout SECONDS` 调大上限（默认 120 秒）。
- `--file commands.txt` 会逐行运行文件中的命令（`#` 开头为注释）。
- `--raw` 保留 ANSI 转义码和回显输入；否则会对输出做清理以提升可读性。

示例——把一张 MIFARE dump 读入卡槽 8 并启用：

```
python SKILL_DIR/scripts/chameleon_control.py "hw slot type -s 8 -t MIFARE_1024" "hw slot init -s 8 -t MIFARE_1024" "hw slot enable -s 8 --hf" "hw slot change -s 8"
```

运行后，把捕获到的设备输出呈现给用户并据此处理（例如汇总扫描到的 UID、报告恢复出的密钥）。

## 依赖

在首次真正运行（非仅配置）时，辅助脚本会确保存在 PTY 后端：

- **Windows**：会在 `SKILL_DIR/.venv` 本地创建一个 venv 并安装 `pywinpty`
  （一次性，需要网络）。随后进程会用该解释器重新执行自身，无需手动安装。
- **POSIX**：使用标准库 `pty` 模块——无需安装。

若一次性的 `pywinpty` 安装失败（无网络），辅助脚本会清晰报错；恢复网络后重试即可。

## MIFARE 攻击方式速查

`chameleon_cli_main` 内置 5 种 MIFARE Classic 密钥攻击方式，各有适用场景。

| 攻击方式 | 核心原理 | 适用场景 |
|----------|----------|----------|
| Darkside（黑暗侧信道攻击） | 利用卡片在认证失败时返回的特殊错误信息（NACK）来逆向出密钥 | 完全不依赖任何已知密钥，可从零开始 |
| Nested（嵌套攻击） | 利用一个已知的扇区密钥去「偷听」并破解其他扇区的密钥 | 至少需要知道一个扇区的密钥 |
| StaticNested（静态嵌套攻击） | 嵌套攻击的一个变种，针对伪随机数生成器（PRNG）有缺陷的卡片 | 卡片生成随机数的规律较弱时 |
| Hardnested（硬嵌套攻击） | 嵌套攻击的「终极版」，不依赖卡片的随机数质量，仅凭一个已知密钥即可破解，但计算量巨大 | 卡片随机数质量很好，其他攻击无效时 |
| MFKEY32 v2 | 通常用于分析你之前「嗅探」到的刷卡数据，以计算出密钥 | 当你用 Chameleon 在「监听模式」下抓取过卡片与读卡器的通信数据时 |

对应 C

README.md

# chameleon-ultra-cli

一个用于 [WorkBuddy](https://www.codebuddy.cn/) 的技能（Skill），让你用大白话指挥
[Chameleon Ultra](https://github.com/RfidResearchGroup/ChameleonUltra) 读写卡器，
把加密 IC 卡（门禁卡、电梯卡等）复制、读取、模拟出来，全程不用自己敲命令行。

## 语言 / Languages / Langues

- **中文**
  - [简体中文](#简体中文)
  - [香港正體](#香港正體)
  - [新加坡中文](#新加坡中文)
- [English](#english)
- [Français](#french)

---

## 简体中文

### 背景介绍

在国内，很多小区的物业会限制业主自由使用属于自己的门禁卡：补一张卡动辄几十上百元、
绑定手机号、甚至规定「一张卡只能对应一个人」，本质是把本该免费提供给业主的便利变成
持续的收费项目，情节严重的已经涉嫌恶意收费、侵占业主权益。

而绝大多数业主手里的门禁卡其实是**加密的 IC 卡（MIFARE Classic 居多）**。一旦丢了或
需要多备一张，物业就借机收费。其实，只要是你**自己小区、自己名下的卡**，复制一张备用
完全是你个人的正当权利。

问题在于：变色龙 Ultra 这类设备的官方操作依赖一个命令行程序，要在交互式界面里手敲一堆
命令，对普通小白极不友好。为了解决这个问题，我制作了这个 Skill——把复杂的命令行交互
封装起来，你只需要用自然语言告诉 WorkBuddy 想做什么，它就会自动完成连接、读卡、复制、
模拟等全流程操作。

> 说明：本工具仅用于复制**你本人拥有合法使用权**的卡片（自家门禁、自家电梯卡等）。
> 请勿用于复制不属于你的、或未经授权的他人卡片。

### 使用方法（小白向）

**第 1 步：下载变色龙 Ultra 的命令行程序**

本程序**只支持 Windows 系统**，请在 Windows 电脑上操作。

- 下载地址：https://wwaxz.lanzoul.com/iar123ylt1sh
- 提取密码：**6bm4**
- 下载后解压，你会得到一个 `chameleon_cli_main.exe` 文件，**记住它的完整路径**
  （例如 `C:\tools\chameleon\chameleon_cli_main.exe`）。

**第 2 步：安装本 Skill 到 WorkBuddy**

把整个 `chameleon-ultra-cli` 文件夹放到 WorkBuddy 的用户技能目录：

```
C:\Users\你的用户名\.workbuddy\skills\chameleon-ultra-cli\
```

**第 3 步：告诉 Skill 程序在哪（只需一次）**

打开 WorkBuddy，对助手说类似这样的话，把第 1 步记下的路径填进去：

```
请设置变色龙程序路径为 C:\tools\chameleon\chameleon_cli_main.exe
```

（本质就是执行了 `python scripts/chameleon_control.py --set-exe "你的路径"`，
路径会保存下来，以后不用再设。）

**第 4 步：插上设备，开始用大白话指挥**

用 USB 把变色龙 Ultra 连上电脑，然后直接用自然语言下指令即可，例如：

- 「读一下我这张门禁卡的信息」
- 「把这张卡复制一份到卡槽 8 里」
- 「扫描一下这张高频卡，看看 UID 是什么」

Skill 会自动连上设备、执行对应命令、把结果翻成你能看懂的话返回给你。

**常用参数（进阶，可不看）**

- `--timeout 秒数`：读卡 / 跑攻击比较慢时用，把等待时间调大（默认 120 秒）
- `--file 命令.txt`：把一堆命令写进文本文件，逐行批量执行（`#` 开头是注释）
- `--raw`：保留原始终端输出，仅在排查问题时用

### 技术原理（简述）

为什么不能直接用官方命令行程序？因为它是一个**交互式 REPL**（基于 prompt_toolkit），
就像个一直在等你敲命令的小窗口——你没法简单地把命令「管道」喂给它，在 Windows 上尤其
会直接报错。

本 Skill 的解法是：

1. **伪终端（PTY）包裹**：在 Windows 上用 `pywinpty`（首次运行会自动建好环境安装），
   在 Linux / macOS 上用系统自带的 `pty` 模块，把官方程序包进一个「假终端」里，
   这样就能像真人一样给它下发命令、并可靠地读回输出。
2. **自动会话管理**：每次调用都会自动先发 `hw connect` 连设备、最后发 `exit` 退出，
   保证每次都是干净、能自己结束的独立会话。
3. **踩过的关键坑**（已自动处理，你无需关心）：
   - 换行符必须用 `LF(\n)`，用回车 `\r` 会被当成补全触发；
   - 程序启动会发终端能力查询并等应答才显示提示符，Skill 会自动回写应答，
     否则它会「卡死」、什么都不输出。

### 致谢

本 Skill 建立在变色龙 Ultra 开源项目的成果之上，衷心感谢原作者的无私开源：

**RfidResearchGroup / ChameleonUltra**
https://github.com/RfidResearchGroup/ChameleonUltra

没有这个优秀的开源硬件与固件，普通用户根本无法低成本地拿回本就属于自己那张卡的控制权。

---

## 香港正體

### 背景介紹

在國內，很多小區的物業會限制業主自由使用屬於自己的門禁卡：補一張卡動輒幾十上百元、
綁定手機號、甚至規定「一張卡只能對應一個人」，本質是把本該免費提供給業主的便利變成
持續的收費項目，情節嚴重的已經涉嫌惡意收費、侵占業主權益。

而絕大多數業主手裡的門禁卡其實是**加密的 IC 卡（MIFARE Classic 居多）**。一旦掉了或
需要多備一張，物業就藉機收費。其實，只要是你**自己小區、自己名下的卡**，複製一張備用
完全是你個人的正當權利。

問題在於：變色龍 Ultra 這類設備的官方操作依賴一個命令列程式，要在互動式介面裡手敲一堆
命令，對普通小白極不友善。為了解決這個問題，我製作了這個 Skill——把複雜的命令列互動
封裝起來，你只需要用自然語言告訴 WorkBuddy 想做什麼，它就會自動完成連接、讀卡、複製、
模擬等全流程操作。

> 說明：本工具僅用於複製**你本人擁有合法使用權**的卡片（自家門禁、自家電梯卡等）。
> 請勿用於複製不屬於你的、或未經授權的他人卡片。

### 使用方法（小白向）

**第 1 步：下載變色龍 Ultra 的命令列程式**

本程式**只支援 Windows 系統**，請在 Windows 電

_meta.json

{
  "ownerId": "kn71cn3h6s4p3eq2qpvbnxq1k98b1r7b",
  "slug": "chameleon-ultra-cli-skill",
  "version": "0.1.0",
  "publishedAt": 1784993095695
}

references/cli_reference.md

# Chameleon Ultra CLI 命令参考 (chameleon_cli_main)

本参考整理自 RfidResearchGroup/ChameleonUltra 官方命令树（docs/cli.md、chameleon_cli_unit.py）。
chameleon_cli_main 是一个**交互式 REPL**，按功能分区组织命令：

- hw  —— 设备本身（连接、模式、版本、设置、卡槽）
- hf  —— 高频 / NFC（13.56MHz），如 ISO14443-A、MIFARE Classic
- lf  —— 低频 / 125kHz，如 EM410x、HID

通用提示
- 任何层级都可以加 -h / --help 查看该组命令与参数，例如 hw -h、hf mf -h、hw slot -h。
- 不同固件版本命令略有差异；以设备实际 *-h 输出为准。
- 本 skill 的 chameleon_control.py 会自动在每条命令前补 hw connect（除非 --no-connect），并在末尾补 exit。
- 需要等待卡片的命令（如 hf 14a scan、hf mf nested）可能耗时数秒到数十秒，可用 --timeout 调整上限。

---

## 根命令（REPL 控制）

| 命令 | 说明 |
|------|------|
| clear | 清屏 |
| rem (text) | 在输出中插入带时间戳的注释 |
| exit / quit / q | 退出 CLI 并断开设备 |
| dump_help | 列出所有命令（-d 显示描述，-g 按分组） |

---

## hw —— 设备控制

| 命令 | 参数 | 说明 |
|------|------|------|
| hw connect | -p PORT | 连接设备；自动检测失败时用 -p COM11（Windows）或 -p /dev/ttyACM0（Linux） |
| hw disconnect | — | 断开连接 |
| hw mode | -r(reader) / -e(emulator) | 获取 / 切换设备模式（读卡器 / 模拟器） |
| hw chipid | — | 读取芯片 ID |
| hw address | — | 读取蓝牙地址 |
| hw version | — | 读取固件版本与型号 |
| hw settings animation | -m (NONE\|MINIMAL\|...) | 设置 LED 动画（NONE 最隐蔽） |
| hw settings blekey | -k (key) | 修改 BLE 配对密钥（默认 12345，强烈建议修改） |
| hw settings | -h | 查看全部设备设置子命令 |

---

## hw slot —— 卡槽管理（最多 8 个，每个含 HF + LF）

| 命令 | 参数 | 说明 |
|------|------|------|
| hw slot list | — | 列出所有卡槽及状态 |
| hw slot type | -s (slot) -t (type) | 设置卡槽类型，如 MIFARE_1024 |
| hw slot init | -s (slot) -t (type) | 用指定类型的默认内容初始化卡槽 |
| hw slot enable | -s (slot) --hf / --lf | 启用某卡槽的 HF 或 LF 模拟 |
| hw slot disable | -s (slot) --hf / --lf | 禁用某卡槽的 HF 或 LF 模拟 |
| hw slot change | -s (slot) | 切换到指定卡槽（设为当前激活槽） |
| hw slot | -h | 查看其余子命令（nickname、delete 等） |

典型模拟流程（MFKEY32v2 示例）
```
hw connect
hw slot list
hw slot type   -s 8 -t MIFARE_1024
hw slot init   -s 8 -t MIFARE_1024
hw slot enable -s 8 --hf
hw slot change -s 8
hf mf econfig --enable-log
# 断开，去读卡器上刷几次卡，再连回：
hw connect
hf mf elog
hf mf elog --decrypt
hf mf econfig --disable-log
```

---

## hf —— 高频 / NFC（13.56MHz）

### hf 14a —— ISO14443-A

| 命令 | 说明 |
|------|------|
| hf 14a scan | 扫描 14a 标签，显示 UID / ATQA / SAK |
| hf 14a info | 扫描并做详细分析（猜测卡片类型、PRNG 强度等） |
| hf 14a | -h 查看读卡、raw 等子命令 |

### hf mf —— MIFARE Classic 攻击 / 操作

| 命令 | 参数 | 说明 |
|------|------|------|
| hf mf nested | --blk BLOCK -k KEY [--tblk TBLOCK] [-a\|-b] [--ta\|-tb] | Nested 攻击恢复密钥 |
| hf mf darkside | — | Darkside 攻击（0 扇区） |
| hf mf hardnested | --blk BLOCK -k KEY [--tblk TBLOCK] [--slow] [--keep-nonce-file] | HardNested 攻击（硬 PRNG） |
| hf mf elog | [--decrypt] | 查看 / 解密模拟器采集到的认证 nonce 日志 |
| hf mf econfig | --enable-log / --disable-log | 开启 / 关闭模拟器认证日志 |
| hf mf eload | (file) | 将 dump 文件载入当前模拟卡槽 |
| hf mf esave | (file) | 将当前模拟卡槽保存为 dump 文件 |
| hf mf chk | -k (keys) | 用给定密钥批量检测扇区 |
| hf mf rdbl / hf mf wrbl | 块读写（需先认证） | 读取 / 写入指定块 |
| hf mf | -h 查看全部子命令（cget/cset 等） |

---

## lf —— 低频 / 125kHz

### lf em 410x —— EM4100/EM410x（ID 卡）

| 命令 | 参数 | 说明 |
|------|------|------|
| lf em 410x scan | — | 扫描 EM410x 标签，显示 ID |
|

skill-card.md

## Description:

Controls Chameleon Ultra RFID hardware through the chameleon_cli_main command-line program for device connection, HF/LF card scanning, MIFARE Classic workflows, slot management, dump handling, and device settings.

This skill is ready for commercial/non-commercial use.

## Publisher:

[georgechou17](https://clawhub.ai/user/georgechou17)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and authorized Chameleon Ultra users use this skill to translate natural-language requests into CLI commands for reading, scanning, emulating, and managing RFID card workflows on hardware they are permitted to operate.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can run card-cloning, emulation, BLE key changes, and MIFARE attack commands against RFID hardware.

Mitigation: Install and use it only when authorized to operate the target cards and readers, and require explicit confirmation before cloning, writing, emulating, changing BLE keys, or running attack commands.

Risk: The setup path references a third-party executable download for chameleon_cli_main.

Mitigation: Replace that download with an official, verified ChameleonUltra release and check hashes or signatures before running the configured executable.

Risk: The Windows helper may install pywinpty at runtime if the dependency is missing.

Mitigation: Avoid unpinned runtime package installation where possible by preinstalling reviewed dependencies from trusted package indexes or pinned artifacts.

## Reference(s):

- [Server-resolved GitHub import](https://github.com/GeorgeChou17/chameleon-ultra-cli-skill)
- [Chameleon Ultra CLI command reference](references/cli_reference.md)
- [RfidResearchGroup ChameleonUltra](https://github.com/RfidResearchGroup/ChameleonUltra)

## Skill Output:

**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]

**Output Format:** [Markdown with inline shell commands and summarized device output]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May include captured Chameleon CLI output; commands require a configured chameleon_cli_main executable and connected hardware.]

## Skill Version(s):

0.1.0 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 0h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.