Ready to get started with OpenClaw? This comprehensive OpenClaw setup guide covers installation on Windows, macOS, and Linux systems. Follow these steps to deploy your own AI automation platform.

Prerequisites Before OpenClaw Setup

Before beginning your OpenClaw setup, ensure your system meets the basic requirements. You will need Node.js version 18 or higher, npm or yarn package manager, and approximately 500MB of free disk space for the core installation.

For browser automation features, you will also need Google Chrome installed. Optional but recommended components include Git for version control and a code editor like VS Code for customizing your OpenClaw configuration.

OpenClaw Setup on Windows

Installing OpenClaw on Windows is straightforward using npm. Open PowerShell or Command Prompt as administrator and run the global installation command. The OpenClaw setup on Windows includes automatic configuration of environment variables and creates a dedicated OpenClaw directory in your user profile.

After installation, initialize OpenClaw by running the configuration wizard. This will set up the gateway service, configure default security settings, and create your initial workspace directory. Windows users should ensure Windows Defender or other antivirus software is configured to allow OpenClaw processes.

OpenClaw Setup on macOS

Mac users can install OpenClaw through Homebrew or npm. The Homebrew method is recommended for easier updates. Run the installation command in Terminal, and Homebrew will handle dependencies automatically. The OpenClaw setup on macOS requires granting accessibility permissions for browser automation features.

After installation, you may need to approve OpenClaw in System Preferences under Security and Privacy. This allows the gateway service to run properly and enables full browser control capabilities. macOS users should also configure their shell profile to include OpenClaw commands in their PATH.

OpenClaw Setup on Linux

Linux installation offers the most flexibility for OpenClaw setup. Installation methods vary by distribution. Ubuntu and Debian users can use the official apt repository, while Arch Linux users can install from the AUR. The npm installation method works across all distributions.

Linux users should configure systemd to manage the OpenClaw gateway service for automatic startup. Proper permission configuration is essential, as browser automation and command execution require appropriate user privileges. Refer to the distribution-specific guides in the official documentation for detailed instructions.

Configuring Your OpenClaw Environment

After completing the basic OpenClaw setup, configure your environment by editing the config.yaml file in your OpenClaw directory. Key settings include choosing your preferred AI model provider, setting up authentication tokens, and configuring browser automation preferences.

The configuration file allows you to customize security policies, set rate limits for API calls, and define which tools and skills are available to your AI agents. Take time to review each option to ensure OpenClaw operates according to your security requirements.

Installing Skills and Extensions

One of the most powerful aspects of OpenClaw setup is the skills ecosystem. Use the clawhub command-line tool to browse and install community-contributed skills. Popular options include browser automation enhancements, coding assistants, and integrations with services like Discord and Telegram.

Skills extend OpenClaw's capabilities without requiring code modifications. Each skill includes documentation and configuration options. You can also develop custom skills using the OpenClaw SDK if you have specific automation needs not met by existing options.

Testing Your OpenClaw Installation

Verify your OpenClaw setup by running the built-in diagnostics. The openclaw doctor command checks your installation, verifies dependencies, and identifies any configuration issues. Address any warnings before proceeding to use OpenClaw for production tasks.

Start with simple automation tasks to familiarize yourself with OpenClaw's capabilities. Try browser navigation, file operations, and basic command execution. Once comfortable, explore more advanced features like scheduled tasks, multi-agent workflows, and custom skill development.