← 返回 Skills 市场

Mac Clamshell Mode

Name: Mac Clamshell Mode
Author: keenlycat

作者 keenlycat · GitHub ↗ · v1.0.1

cross-platform ✓ 安全检测通过

328

总下载

当前安装

版本数

在 OpenClaw 中安装

/install mac-clamshell-mode

功能描述

Mac laptop clamshell mode assistant. Supports running with lid closed WITHOUT external display/keyboard/mouse. Auto-detects Mac model and macOS version, prov...

使用说明 (SKILL.md)

Mac Clamshell Mode Assistant

Overview

Helps Mac users configure their laptops to run tasks with the lid closed. No external display, keyboard, or mouse required! This skill detects the current Mac model and macOS version, then provides appropriate configuration steps.

Key Features

✅ No external display required - Works with laptop alone
✅ No external keyboard/mouse required - Pure headless operation
✅ Auto-detection - Identifies Mac model and macOS version
✅ Multiple modes - Standard clamshell, forced headless, or temporary
✅ Safe configuration - Requires explicit approval, includes rollback
✅ Battery warnings - Alerts about power consumption

When to use

User wants to run background tasks with MacBook lid closed
User needs headless operation without external peripherals
User wants to verify current power management settings
User needs help with Amphetamine or caffeinate commands
User wants to restore default power settings

System Requirements

macOS 10.15 Catalina or later
MacBook (Pro/Air) - Intel or Apple Silicon
Power adapter connected (strongly recommended for headless mode)

Configuration Modes

Mode 1: Standard Clamshell (Requires External Display)

Traditional macOS clamshell mode
Most stable, most power-efficient
Requires: Power + External Display + Keyboard/Mouse

Mode 2: Forced Headless Operation ⭐ RECOMMENDED

No external display required
No external keyboard/mouse required
Modifies system power settings
Perfect for background tasks, servers, rendering
Warning: Increased battery consumption

Mode 3: Temporary Operation

Uses caffeinate command
No system setting changes
Good for short-term tasks
Stops when terminal closes

Mode 4: Status Check

View current power settings
See what's preventing sleep
No modifications

Mode 5: Restore Defaults

Rollback all changes
Return to factory power settings

Workflow

1) System Detection

Mac model (MacBook Pro/Air identification)
macOS version (10.15+ compatibility check)
Current power management settings
Amphetamine running status

2) User Selection

Present 5 configuration modes
Clear explanations for each option
Explicit confirmation required

3) Apply Configuration

Mode-specific setup
Safety warnings displayed
Success/failure feedback

4) Verification & Rollback

Test current sleep prevention status
Provide rollback instructions
Include recovery commands

Safety Rules

⚠️ Always recommend power adapter for headless mode
⚠️ Warn about battery drain when running without external display
✅ Require explicit approval before making system changes
✅ Provide rollback instructions for all configurations
✅ Check Amphetamine status and recommend if not running

安全使用建议

This skill appears to do what it claims: it runs local macOS commands (pmset, caffeinate), detects model/version, and prompts you before making changes. Before installing/running: 1) Review the configure-clamshell.sh script and understand the pmset changes it will make (disablesleep, autopoweroff, sleep/display settings). 2) Expect to be prompted for sudo; only run if you trust the source and you have administrator access. 3) Use check-compatibility.sh first to confirm your device is a MacBook and macOS version is supported. 4) Back up or note current pmset settings (pmset -g) before applying changes so you can restore them manually if needed. 5) Note the small inconsistency: test-skill.sh invokes --dry-run but configure-clamshell.sh does not implement that option — the test may fail. If you rely on battery-powered use, be aware forced headless mode increases battery drain; connect power when recommended.

功能分析

Type: OpenClaw Skill Name: mac-clamshell-mode Version: 1.0.1 The skill bundle provides a utility for managing macOS power settings to enable clamshell mode (running with the lid closed). It uses standard system tools like `pmset`, `sw_vers`, and `system_profiler` to detect hardware and modify sleep behavior. While the configuration script (`configure-clamshell.sh`) requires sudo privileges to change system-wide power settings, it includes clear user prompts for confirmation, provides a rollback mechanism, and its logic is entirely consistent with the stated purpose in `SKILL.md` and `README.md` without any signs of data exfiltration or malicious intent.

能力评估

✓ Purpose & Capability

The name/description match the scripts: check-compatibility.sh inspects model/version, configure-clamshell.sh modifies macOS power settings (pmset) or recommends caffeinate/Amphetamine. All required actions (changing pmset, using caffeinate) are appropriate for the stated purpose.

ℹ Instruction Scope

SKILL.md describes interactive modes and safe rollback, and the scripts require explicit user confirmation before applying changes. Minor inconsistency: test-skill.sh calls './configure-clamshell.sh --dry-run' but configure-clamshell.sh does not implement a --dry-run option — this may cause the test script to fail. Otherwise instructions remain local and do not attempt to read unrelated system secrets or call external endpoints.

✓ Install Mechanism

No install spec or remote downloads are present; the skill is delivered as local scripts packaged with the skill. No network fetches or archive extraction are performed during install.

✓ Credentials

The skill requests no environment variables or external credentials. It does require elevated privileges at runtime (uses sudo), which is expected for modifying system pmset settings.

ℹ Persistence & Privilege

The skill does not request permanent presence (always:false) nor modify other skills. It does perform privileged system configuration (sudo pmset) and will change system power behavior while active; these privileges are proportional to the task but require user attention because they affect device power/battery behavior.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install mac-clamshell-mode
安装完成后，直接呼叫该 Skill 的名称或使用 /mac-clamshell-mode 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

- Improved support for running Mac laptops with the lid closed, now works without any external display, keyboard, or mouse. - Added auto-detection of Mac model and macOS version with tailored configuration options. - Introduced multiple configuration modes: standard clamshell, forced headless, temporary (caffeinate), status check, and easy restore to defaults. - Enhanced safety: explicit user approval for changes, clear battery/power warnings, and detailed rollback instructions. - Updated documentation with clearer feature explanations and use cases.

v1.0.0

Initial release of mac-clamshell-mode. - Guides users to configure MacBook clamshell mode for running tasks with the lid closed. - Automatically detects Mac model (Intel/Apple Silicon) and macOS version. - Offers setup steps for both with and without external display scenarios. - Recommends solutions using Amphetamine, Terminal (caffeinate), or pmset configuration. - Includes safety checks, power adapter warnings, and rollback instructions. - Provides verification steps and troubleshooting for configuration effectiveness.

元数据

Slug mac-clamshell-mode

版本 1.0.1

许可证 —

累计安装 1

当前安装数 1

历史版本数 2

常见问题