mac-ai-optimizer

# Mac AI Optimizer

Optimize macOS for AI workloads (OpenClaw, Docker, Ollama). Turn an 8GB Mac into a lean AI server node with near-16GB performance for Agent tasks.

## Tools

### optimize_memory
Reduce macOS idle memory from ~6GB to ~2.5GB by disabling Spotlight indexing, Siri, photo analysis, and other background services.

Usage: "Optimize this Mac's memory for AI workloads"

### reduce_ui
Lower GPU and RAM usage by disabling animations, transparency, and Dock effects.

Usage: "Reduce UI overhead on this Mac"

### docker_optimize
Configure Docker Desktop resource limits to prevent it from consuming all available memory. Sets CPU, RAM, and swap to balanced values.

Usage: "Optimize Docker for this Mac"

### enable_ssh
Enable remote login (SSH) so this Mac can be managed remotely as an AI compute node.

Usage: "Enable SSH on this Mac"

### system_report
Show current memory, CPU, swap usage, and running service count. Helps decide what to optimize.

Usage: "Show system resource report"

### full_optimize
Run all optimizations in sequence: system report -> memory -> UI -> Docker -> SSH. One command to turn a Mac into an AI server node.

Usage: "Full optimize this Mac for OpenClaw"

## Trigger
When the user asks to optimize Mac for AI, reduce memory usage, set up Mac as AI server, improve OpenClaw performance, or run AI workloads on low-memory Mac.

## Example prompts
- "Optimize this Mac for running OpenClaw"
- "My Mac only has 8GB RAM, make it run AI better"
- "Turn this Mac mini into an AI server"
- "Reduce memory usage so Docker runs better"
- "Set up this Mac as a remote AI node"

# Mac AI Optimizer

Optimize macOS for AI workloads. Turn an 8GB Mac into a lean AI server node with near-16GB performance.

8GB Mac 极限优化工具。把小内存 Mac 变成 AI 服务器节点，接近 16GB 的运行体验。

---

## What it does / 功能说明

Reduces macOS idle memory from ~6GB to ~2.5GB:

将 macOS 闲置内存从 ~6GB 降到 ~2.5GB：

- Disable Spotlight, Siri, photo analysis, analytics / 关闭 Spotlight、Siri、照片分析、系统分析
- Reduce UI animations, transparency, GPU overhead / 减少动画、透明度、GPU 占用
- Configure Docker Desktop resource limits / 配置 Docker 资源限制
- Enable SSH for remote node management / 开启 SSH 远程管理
- Clean unused Docker resources / 清理 Docker 无用资源
- One-click revert to defaults / 一键恢复默认设置

---

## Installation / 安装

### 1. Claude Code Skill

```bash
npx skills add dongsheng123132/mac-ai-optimizer
```

Then tell Claude / 然后对 Claude 说：

```
Optimize this Mac for AI workloads
帮我优化这台 Mac 来跑 AI
```

### 2. OpenClaw / ClawHub Plugin

Local install / 本地安装：

```bash
openclaw plugins install -l /path/to/mac-ai-optimizer
```

Or copy to extensions dir / 或复制到扩展目录：

```bash
cp -r mac-ai-optimizer ~/.openclaw/extensions/mac-ai-optimizer
```

Then configure `openclaw.json` / 然后配置 `openclaw.json`：

```json
{
  "plugins": {
    "entries": {
      "mac-ai-optimizer": {
        "enabled": true,
        "config": {
          "optimizeLevel": "moderate"
        }
      }
    }
  },
  "tools": {
    "allow": [
      "mac_system_report",
      "mac_optimize_memory",
      "mac_reduce_ui",
      "mac_docker_optimize",
      "mac_enable_ssh",
      "mac_full_optimize",
      "mac_revert_optimizations"
    ]
  }
}
```

OpenClaw Agent can then call these tools directly in conversation:

OpenClaw Agent 可以在对话中直接调用这些工具：

```
"Help me optimize this Mac for running OpenClaw"
"优化这台 Mac 来跑 OpenClaw"
```

### 3. Standalone / 独立运行

```bash
chmod +x tools/*.sh

# Full optimization / 一键全部优化
./tools/full_o...