Ma2 Control

v1.1.0

grandMA2 实体控台控制技能。通过 Telnet 连接控台执行命令。用于：选灯、调光、存 Cue、播放、查询等 MA2 操作。触发条件：用户提到 MA2、grandMA2、灯光控台、选灯、存 Cue、执行器等。执行命令必须使用 ~/ma2_bridge/ma2_cmd.sh 脚本。

⭐ 0· 119·0 current·0 all-time

by@y1035211-cloud

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for y1035211-cloud/ma2-control.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "Ma2 Control" (y1035211-cloud/ma2-control) from ClawHub.
Skill page: https://clawhub.ai/y1035211-cloud/ma2-control
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required env vars: MA2_IP_EXPECTED, MA2_TELNET_PORT_EXPECTED
Required binaries: bash, curl, nc
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install ma2-control

ClawHub CLI

Package manager switcher

npx clawhub@latest install ma2-control

Security Scan

VirusTotal

Suspicious

View report →

OpenClaw

Benign

medium confidence

✓

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.

Assessment

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.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

🎛️ Clawdis

Binsbash, curl, nc

EnvMA2_IP_EXPECTED, MA2_TELNET_PORT_EXPECTED

latestvk97d8ak9vyvtzg3sp8xmra28qn83kf4g

119downloads

0stars

2versions

Updated 1mo ago

v1.1.0

MIT-0

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

Comments

Loading comments...