Selig
4c966a3ad2
6 custom skills (assign-task, dispatch-webhook, daily-briefing, task-capture, qmd-brain, tts-voice) with technical documentation. Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
1.6 KiB
macOS Onboarding
Overview
This documentation describes the first-run onboarding experience for the OpenClaw macOS application. The process guides users through initial setup in eight sequential steps, culminating in a dedicated onboarding chat session.
Key Setup Stages
The onboarding flow progresses through:
- Welcome/security notice
- Gateway location selection
- Authentication
- Setup wizard execution
- System permissions requests
- Optional CLI installation
- Introductory agent chat session
Gateway Configuration Options
Users can choose where the Gateway runs:
- Local (this Mac): Allows OAuth flows and local credential storage
- Remote (over SSH/Tailnet): Requires pre-existing credentials on the gateway host
- Defer: Lets users skip configuration entirely
Authentication Details
For local setups with Anthropic, the process involves browser-based OAuth using PKCE flow. Users authenticate and credentials are stored at ~/.openclaw/credentials/oauth.json. Other providers require environment variables or config files.
System Permissions
The app requests macOS permissions for:
- Notifications
- Accessibility
- Screen recording
- Microphone/speech recognition
- AppleScript automation
Agent Bootstrapping
Upon first run, the system initializes a workspace at ~/.openclaw/workspace and seeds configuration files. An interactive Q&A ritual gathers user preferences before the bootstrap process completes.
Additional Setup
Gmail webhook integration requires manual CLI commands, while remote Gateway setups need credentials pre-configured on the host machine.