← Back to Skills Marketplace
Ma2 Control
by
y1035211-cloud
· GitHub ↗
· v1.1.0
· MIT-0
123
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install ma2-control
Description
grandMA2 实体控台控制技能。通过 Telnet 连接控台执行命令。 用于：选灯、调光、存 Cue、播放、查询等 MA2 操作。 触发条件：用户提到 MA2、grandMA2、灯光控台、选灯、存 Cue、执行器等。 执行命令必须使用 ~/ma2_bridge/ma2_cmd.sh 脚本。
README (SKILL.md)
MA2 控台控制
⚠️ 使用前检查
1. 控台连接检测
执行命令前，先检查控台是否在线：
curl -s http://127.0.0.1:40100/health
返回 "ok":true 表示连接正常。
2. 常见错误处理
| 错误 | 原因 | 解决 |
|---|---|---|
timed out |
控台IP不对或网络不通 | 确认控台IP和网段 |
connection refused |
Telnet端口未开启 | 在控台设置里开启Remote |
no service |
桥接服务未启动 | 运行 python3 ~/ma2_bridge/ma2_telnet_server.py |
🚀 快速命令
选灯
| 命令 | 说明 |
|---|---|
Fixture 1 |
单个 |
Fixture 1 Thru 10 |
范围 |
Fixture 1 + 3 + 5 |
多选 |
Group 1 |
组 |
亮度
| 命令 | 说明 |
|---|---|
At Full |
100% |
At 50 |
50% |
At 0 |
全关 |
属性
| 命令 | 说明 |
|---|---|
Attribute "COLOR1" At 30 |
颜色 |
Attribute "PAN" At 127 |
水平 |
Attribute "TILT" At 50 |
垂直 |
存储
| 命令 | 说明 |
|---|---|
Store Cue 1 |
存 Cue |
Store Cue 1 "名称" |
带名存 |
Assign Cue 1 To Executor 1.1 |
到执行器 |
播放
| 命令 | 说明 |
|---|---|
Go Executor 1.1 |
触发 |
Pause Sequence 1 |
暂停 |
Goto Cue 5 Sequence 1 |
跳转 |
查询
| 命令 | 说明 |
|---|---|
List Cue |
列表 Cue |
List Fixture |
列表灯具 |
List Executor |
列表执行器 |
Info Cue 1 |
Cue 详情 |
⚡ 执行方式
执行 MA2 命令必须使用：
~/ma2_bridge/ma2_cmd.sh "MA2命令"
多条命令用 ; 分隔：
~/ma2_bridge/ma2_cmd.sh "Fixture 1 Thru 10 ; At Full"
🎨 颜色值速查
| 颜色 | 值 |
|---|---|
| 红 | 0 |
| 橙 | 10 |
| 黄 | 20 |
| 绿 | 30 |
| 青 | 40 |
| 蓝 | 60 |
| 紫 | 70 |
| 品红 | 80 |
📍 位置值速查
| 方向 | PAN | TILT |
|---|---|---|
| 左 | 0 | - |
| 中 | 127 | 50 |
| 右 | 255 | - |
🔧 配置说明
环境变量 (可选)
| 变量 | 默认值 | 说明 |
|---|---|---|
MA2_IP_EXPECTED |
192.168.1.11 | 控台IP |
MA2_TELNET_PORT_EXPECTED |
30000 | Telnet端口 |
MA2_HTTP_PORT_OVERRIDE |
自动检测 | 桥接服务端口 |
桥接服务
控台连接流程：
- 控台开启 Telnet Remote (Settings → Network → Remote)
- 本机运行：
python3 ~/ma2_bridge/ma2_telnet_server.py - 通过桥接服务发送命令
📖 详细文档
完整命令语法见：references/MA2_COMMAND_SYNTAX.md
模板库见：references/MA2_TEMPLATES.md
故障排查见：references/MA2_TROUBLESHOOTING.md
Usage Guidance
Before enabling this skill, confirm the following: (1) You have a trusted ~/ma2_bridge directory and the ma2_cmd.sh / ma2_telnet_server.py scripts are legitimate — the skill relies on those local scripts but does not include them. (2) python3 is required to run the bridge per the docs; ensure python3 is present and that any bridge server you run only connects to your intended MA2 hardware. (3) Set MA2_IP_EXPECTED and MA2_TELNET_PORT_EXPECTED correctly and restrict their values to the known console to avoid accidental commands to other hosts. (4) Because the agent may invoke this skill when certain keywords appear, consider whether you want autonomous invocation enabled for your agent (disable or restrict if you do not want the agent to send commands automatically). (5) If you cannot verify the contents of ma2_cmd.sh and the bridge server, do not enable the skill — a malicious or buggy local script could send unintended commands to lighting hardware.
Capability Analysis
Type: OpenClaw Skill
Name: ma2-control
Version: 1.1.0
The skill bundle provides instructions for an AI agent to control grandMA2 lighting consoles via a local bridge service. It is classified as suspicious because it requires high-risk capabilities, including shell execution (bash) and network utilities (nc, curl), and directs the agent to pass user-provided command strings to an external script (~/ma2_bridge/ma2_cmd.sh), which creates a potential shell injection vulnerability. Furthermore, the skill relies on unprovided external scripts and a local service (http://127.0.0.1:40100) that are not included in the bundle, making the complete execution chain unverified.
Capability Assessment
Purpose & Capability
Name and description describe Telnet-based control of a grandMA2 console. Declared binaries (bash, curl, nc), required env vars (MA2_IP_EXPECTED, MA2_TELNET_PORT_EXPECTED), and the requirement to invoke ~/ma2_bridge/ma2_cmd.sh are consistent with that purpose.
Instruction Scope
The SKILL.md instructs the agent to call a local health endpoint (127.0.0.1:40100) and to execute ~/ma2_bridge/ma2_cmd.sh and, in troubleshooting, to run python3 ~/ma2_bridge/ma2_telnet_server.py. These steps are within the skill's domain (local bridge + telnet to console) but the SKILL.md references running python3 even though python3 is not listed in required binaries and no bridge code is included in the package — you should confirm the bridge scripts actually exist and are trusted. The skill does not instruct reading unrelated files or exfiltrating data to external endpoints.
Install Mechanism
Instruction-only skill with no install spec — it does not download or write code. This is the lower-risk model for skills, but it depends on an existing local ~/ma2_bridge in the user's environment which the skill does not provide.
Credentials
Required environment variables (MA2_IP_EXPECTED, MA2_TELNET_PORT_EXPECTED) are appropriate for a console-control skill. The SKILL.md also documents an optional MA2_HTTP_PORT_OVERRIDE that is not declared in requires.env, and python3 is referenced but not declared as a required binary — small documentation mismatches to verify.
Persistence & Privilege
always is false and the skill does not request any elevated or persistent platform privileges. It does not try to modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ma2-control - After installation, invoke the skill by name or use
/ma2-control - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
**MA2-control 1.1.0: Adds troubleshooting guide and enhances usage instructions**
- Added detailed troubleshooting guide: `references/MA2_TROUBLESHOOTING.md`
- Expanded usage documentation with connection checks, error handling, and configuration tips
- Included more quick command examples (e.g., pause, jump to cue, list fixtures/executors)
- Documented environment variables and bridge service setup
- Improved layout and clarity for quick reference and onboarding
v1.0.0
ma2-control 1.0.0 初始发布
- 新增 grandMA2 控台基础控制技能，通过 Telnet 连接下达命令。
- 支持选灯、调光、存 Cue、播放、查询等常用 MA2 指令及命令速查。
- 强制使用 ~/ma2_bridge/ma2_cmd.sh 执行所有控制命令。
- 提供常用灯光属性、颜色、位置的命令范例与速查表格。
- 衔接详细命令语法和模板库文档路径。
Metadata
Frequently Asked Questions
What is Ma2 Control?
grandMA2 实体控台控制技能。通过 Telnet 连接控台执行命令。 用于：选灯、调光、存 Cue、播放、查询等 MA2 操作。 触发条件：用户提到 MA2、grandMA2、灯光控台、选灯、存 Cue、执行器等。 执行命令必须使用 ~/ma2_bridge/ma2_cmd.sh 脚本。 It is an AI Agent Skill for Claude Code / OpenClaw, with 123 downloads so far.
How do I install Ma2 Control?
Run "/install ma2-control" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ma2 Control free?
Yes, Ma2 Control is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Ma2 Control support?
Ma2 Control is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ma2 Control?
It is built and maintained by y1035211-cloud (@y1035211-cloud); the current version is v1.1.0.
More Skills