← 返回 Skills 市场
y1035211-cloud

Ma2 Control

作者 y1035211-cloud · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ⚠ suspicious
123
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install ma2-control
功能描述
grandMA2 实体控台控制技能。通过 Telnet 连接控台执行命令。 用于:选灯、调光、存 Cue、播放、查询等 MA2 操作。 触发条件:用户提到 MA2、grandMA2、灯光控台、选灯、存 Cue、执行器等。 执行命令必须使用 ~/ma2_bridge/ma2_cmd.sh 脚本。
使用说明 (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 自动检测 桥接服务端口

桥接服务

控台连接流程:

  1. 控台开启 Telnet Remote (Settings → Network → Remote)
  2. 本机运行:python3 ~/ma2_bridge/ma2_telnet_server.py
  3. 通过桥接服务发送命令

📖 详细文档

完整命令语法见:references/MA2_COMMAND_SYNTAX.md 模板库见:references/MA2_TEMPLATES.md 故障排查见:references/MA2_TROUBLESHOOTING.md

安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install ma2-control
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /ma2-control 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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 执行所有控制命令。 - 提供常用灯光属性、颜色、位置的命令范例与速查表格。 - 衔接详细命令语法和模板库文档路径。
元数据
Slug ma2-control
版本 1.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Ma2 Control 是什么?

grandMA2 实体控台控制技能。通过 Telnet 连接控台执行命令。 用于:选灯、调光、存 Cue、播放、查询等 MA2 操作。 触发条件:用户提到 MA2、grandMA2、灯光控台、选灯、存 Cue、执行器等。 执行命令必须使用 ~/ma2_bridge/ma2_cmd.sh 脚本。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 123 次。

如何安装 Ma2 Control?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install ma2-control」即可一键安装,无需额外配置。

Ma2 Control 是免费的吗?

是的,Ma2 Control 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Ma2 Control 支持哪些平台?

Ma2 Control 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Ma2 Control?

由 y1035211-cloud(@y1035211-cloud)开发并维护,当前版本 v1.1.0。

💬 留言讨论