platforms/codex/skills/mx-im/SKILL.md
Safely search MX users or groups and send Midea MX / 美信 IM messages from Codex. Use when the user asks to notify someone, send a message to a person or group, use a configured group alias, @ users, @ all, or send MX file/image messages. Read lookups need no extra authorization; every live send needs explicit user authorization for that exact target and message.
npx skillsauth add codingsamss/ai-dotfiles mx-imInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill for MX / 美信 write-side interactions: user lookup, group lookup, group alias resolution, text sends, file/image sends, @user, and @all.
scripts/mx_safe_send.py for normal text sends. It dry-runs by default.--send and --confirm-user-authorized.scripts/im_send.py only for file, image, @user, @all, or push
fields; it also requires --confirm-user-authorized.Send scripts resolve auth in this order:
MX_OC_TOKEN.OPENCLAW_MX_SERVER_PORT + OPENCLAW_MX_SERVER_SECRET from the current env.ai.midea-openclaw.gateway-stable.plist, then GET /oc-token with
x-server-secret to exchange a fresh OC token.mcporter.json./tmp/ua_token.txt.ua_login.py or when the
original im_send.py needs a final fallback.Never print or store the raw OC token or server secret in skill docs, repo files, logs, or memory.
python3 scripts/group_alias.py "<别名>"
python3 scripts/user_search.py --keyword "<姓名/工号/邮箱前缀>"
python3 scripts/group_search.py --keyword "<群名关键字>" --limit 5
Alias data is local-only at references/group-aliases.local.json; do not sync
it to repos.
Dry-run first:
python3 scripts/mx_safe_send.py \
--from-id "<sender_uid>" \
--to-id "<receiver_uid_or_group_id>" \
--session-type p2p \
--body "message text"
After explicit authorization:
python3 scripts/mx_safe_send.py \
--from-id "<sender_uid>" \
--to-id "<receiver_uid_or_group_id>" \
--session-type p2p \
--body "message text" \
--send \
--confirm-user-authorized
For detailed original script behavior, read only the relevant file in
references/: mx-ua-auth.md, im-send.md, user-search.md,
or group-search.md.
development
Query Midea MX / 美信 local message cache through the MX local HTTP query service from Codex. Use when the user asks to read MX sessions, search chat history, search messages globally or inside a group/session, list recent messages, or page message history. This is read-only and does not require send authorization. Never fall back to reading SQLite or app cache files directly.
tools
MX channel output rules. Always active in MX conversations.
tools
Use the company WorkSpace `ws` CLI reliably as a delegated coding agent from Codex. Trigger when the user wants Codex to command `ws`, WorkSpace CLI, or the company opencode-derived coding tool to generate code, inspect a repo, run a bounded implementation task, or use a requested WorkSpace model while Codex reviews the output.
development
Safely work with Midea MX / 美信 interactions from Codex. Use when the user asks to search MX users or groups, prepare or send an MX message, notify someone in MX, inspect MX message-query capabilities, search MX chat history, or understand MX ocToken / UA auth behavior. Prefer dry-run before any live send.