OpenClaw Mac Mini Setup - Claude Skill

Description

Guide users through setting up an OpenClaw agent on a Mac Mini with a dedicated user account, Slack integration, and proper security configuration.

When to Use This Skill

Invoke this skill when users ask about:

• Setting up OpenClaw on Mac Mini
• Creating isolated OpenClaw agent accounts
• Configuring OpenClaw with Slack
• OpenClaw security best practices
• Multiple agent setups on the same machine

Instructions

When a user requests OpenClaw setup assistance:

1. Understand their goal:

   • Single agent or multiple agents?
   • What's the agent name and username?
   • Do they have Slack workspace access?
   • Do they have Anthropic API credentials?

2. Guide them through the setup:

   • Reference the AGENT-SETUP.md guide
   • Help them fill in the variables section:
     • AGENT_NAME: Display name (e.g., "EVE", "WALL-E")
     • AGENT_USERNAME: Lowercase username
     • UNIQUE_ID: Auto-detect or specify (502, 503, etc.)
     • ADMIN_USERNAME: Their admin username
     • Slack tokens (obtained in Part 4)
     • Anthropic API key

3. Walk through each part:

   • Part 1: Create user account
   • Part 2: Set up environment
   • Part 3: Install Node.js and build
   • Part 4: Create Slack app (detailed OAuth flow)
   • Part 5: Configure OpenClaw
   • Part 6: Set up API key
   • Part 7: Start gateway
   • Part 8: Verify setup
   • Part 9: Test in Slack
   • Part 10: (Optional) Admin access

4. Security reminders:

   • Warn about secrets in shell history
   • Ensure .env files have proper permissions (chmod 600)
   • Explain Slack DM policy security implications
   • Recommend FileVault for disk encryption
   • Suggest strong passwords for user accounts

5. LLM Configuration:

   • Recommend Anthropic Opus 4.5 for best results
   • Mention OAuth support (Anthropic Pro/Max)
   • Note that any LLM can be configured (local or cloud)
   • Reference OpenClaw docs for model configuration

6. Troubleshooting:

   • "User already exists" → check/change UNIQUE_ID
   • "Permission denied" → re-run ownership commands
   • "Slack not connecting" → verify tokens and Socket Mode
   • "Node/pnpm not found" → ensure nvm is sourced

Example Usage

User: "How do I set up OpenClaw on my Mac Mini?"

Agent: "I'll help you set up OpenClaw on your Mac Mini! This guide will create a dedicated user account for your agent with proper isolation and security.

First, let's gather some info:

1. What would you like to name your agent? (e.g., 'EVE', 'WALL-E')
2. Do you have a Slack workspace?
3. Do you have an Anthropic API key?

Once we have these, I'll walk you through the setup using a variable-driven guide that makes it easy to copy-paste commands..."

Files

• AGENT-SETUP.md: Complete setup guide with all commands
• README.md: Quick overview and features
• claude-skill.md: This skill documentation

Repository

https://github.com/bcharleson/openclaw-macmini-setup-guide