The ULTIMATE OpenClaw Setup Guide: Your Personal AI Assistant

Before diving into the exciting world of OpenClaw, it's crucial to ensure you have the necessary components. This section outlines the prerequisites to guarantee a smooth setup process. ### 1. A Compatible Computer OpenClaw is designed to run on most modern operating systems. You will need one of the following: * **Mac**: Apple's macOS operating system. * **Windows**: The widely used Microsoft Windows PC operating system. * **Linux**: A versatile and powerful operating system, often favored by developers. ### 2. Node.js (Version 22 or Higher) Node.js is a runtime environment that allows your computer to execute JavaScript code, which is the foundation of OpenClaw. To check if you have Node.js installed and its version: * **On Mac**: Open Terminal (Command + Space, type 'Terminal', press Enter). * **On Windows**: Open Command Prompt or PowerShell (Windows key, type 'cmd' or 'PowerShell', press Enter). * In the terminal or command prompt, type `node --version` and press Enter. If the output shows a version number starting with '22' or higher (e.g., `v22.1.0`), you're good to go. If not, or if you see 'command not found', you need to install it. **To install Node.js**: 1. Visit the official Node.js website: [https://nodejs.org/](https://nodejs.org/) 2. Download the 'LTS' (Long Term Support) version, which is the most stable. 3. Run the installer and follow the on-screen instructions (typically just clicking 'Next' repeatedly). 4. After installation, re-check the version in your terminal to confirm it's installed correctly. ### 3. An AI Service Account OpenClaw requires an external AI service to provide its intelligence. You'll need an account with one of the following providers and an API key: * **Option A: Anthropic (Claude)**: Known for its advanced reasoning capabilities. You'll need a Claude account (Pro or Max recommended for optimal performance) and an API key from their console. * **Option B: OpenAI (ChatGPT)**: A popular choice with a wide range of models. You'll need an OpenAI account and an API key from their platform. **PRO TIP**: For the best experience, consider using Claude Opus 4.5, which offers exceptional performance but may incur higher costs. ### 4. Time Commitment While not overly complex, the setup process typically takes around 30 minutes. Following the steps carefully will ensure a successful installation.

With OpenClaw installed, the next step is to configure it to understand your preferences and connect to your chosen AI service. This is handled by the user-friendly onboarding wizard. ### Step 1: Launch the Onboarding Wizard Open your terminal and type the following command: ```bash openclaw onboard --install-daemon ``` The `--install-daemon` flag ensures that OpenClaw runs continuously in the background, making it always available. A 'daemon' is a program that runs as a service, operating without direct user interaction. ### Step 2: Respond to the Wizard's Prompts The wizard will guide you through a series of questions: #### Question 1: "What should we call your assistant?" Choose a name for your AI. This can be anything from classic AI names like 'Jarvis' or 'Alfred' to something more personal or humorous. Type your chosen name and press Enter. #### Question 2: "Which AI provider do you want to use?" Use your arrow keys to select either 'Anthropic' (for Claude) or 'OpenAI' (for ChatGPT), depending on which service you have an account with. Press Enter to confirm. #### Question 3: "Enter your API key" This is a critical step. Your API key is a secret token that allows OpenClaw to authenticate with your AI service. * **For Anthropic**: Navigate to [https://console.anthropic.com/](https://console.anthropic.com/), sign in, go to 'API Keys', click 'Create Key', and copy the generated key. * **For OpenAI**: Visit [https://platform.openai.com/api-keys](https://platform.openai.com/api-keys), sign in, click 'Create new secret key', and copy the token. Paste the copied API key into the terminal. Note that characters won't be visible as you type for security reasons. Press Enter to submit. **IMPORTANT**: Treat your API key like a password. Never share it publicly or store it insecurely. #### Question 4: "Which model do you want to use?" Select the specific AI model you wish to use. Options will vary based on your provider (e.g., `claude-opus-4.5`, `claude-sonnet-4.5`, `gpt-4`). The wizard will display available models. Claude Opus 4.5 is highly recommended for its advanced capabilities. #### Question 5: "Do you want to set up messaging channels?" Choose 'Yes' if you want to interact with OpenClaw via messaging apps like WhatsApp or Telegram. Select 'No' if you prefer to use the web dashboard initially (you can add channels later). #### Question 6: "Which channels do you want to set up?" If you chose 'Yes' in the previous step, you'll see a list of supported channels (e.g., WhatsApp, Telegram, Discord, Slack). Use the Space bar to select your desired channels and press Enter. Some channels may require additional configuration steps, which will be covered later. #### Question 7: "Do you want to install the gateway daemon?" Confirm 'YES' to ensure OpenClaw runs in the background, always ready to assist you. ### Step 3: Await Wizard Completion The wizard will now finalize the setup by creating configuration files, initializing the gateway, and starting the background daemon. This process typically takes about 30 seconds.

To ensure that OpenClaw is running correctly after the setup, you can perform a few verification steps. ### Step 1: Check Gateway Status Open your terminal and run the following command: ```bash openclaw gateway status ``` You should see output similar to this, indicating that the gateway is active and healthy: ``` ✓ Gateway is running ✓ Port: 18789 ✓ Status: healthy ``` If the gateway is not running, you can start it manually by typing: ```bash openclaw gateway start ``` ### Step 2: Access the Web Dashboard OpenClaw provides a convenient web-based dashboard for interacting with your AI and managing settings. To open it, run: ```bash openclaw dashboard ``` This command should automatically launch your default web browser and navigate to the OpenClaw control panel at `http://127.0.0.1:18789/`. If it doesn't open automatically, manually enter this address into your browser. The dashboard allows you to: * Chat directly with your AI. * Monitor its current activities. * Adjust settings. * Review logs. ### Step 3: Send Your First Message Once the dashboard is open, locate the chat input box. Try sending a simple message to your AI, such as: ``` Hello! Can you introduce yourself? ``` If your AI responds accurately, you have successfully set up OpenClaw! This confirms that the installation, AI connection, and gateway are all functioning as expected. Congratulations on setting up your personal AI assistant!

To truly unlock the potential of your OpenClaw AI assistant, you can equip it with 'skills' – essentially, plugins that grant it new capabilities. These skills allow OpenClaw to interact with external services and perform a variety of tasks. ### What Are Skills? Skills are like applications that OpenClaw can leverage. For example, a 'web browsing' skill enables it to search the internet, a 'calendar' skill allows it to manage your schedule, and a 'file management' skill helps organize your documents. The availability of skills is vast, covering numerous functionalities. ### How to Add Skills **Step 1: Browse Available Skills** Visit [https://clawhub.ai](https://clawhub.ai) to explore the extensive library of skills that OpenClaw can utilize. You'll find skills for productivity, information retrieval, entertainment, and much more. **Step 2: Install a Skill** Let's use the 'web-search' skill as an example. To install it, open your terminal and run: ```bash openclaw skills install web-search ``` This command downloads and integrates the skill into your OpenClaw setup. **Step 3: Test the Skill** Once installed, you can test the 'web-search' skill by asking OpenClaw a question that requires internet research: ``` Can you search the internet for information about dinosaurs? ``` OpenClaw should now be able to access the web, find relevant information, and present it to you. ### Cool Skills to Try Here are some highly recommended skills to enhance your OpenClaw experience: * `calendar`: For managing your schedule and appointments. * `weather`: To get real-time weather updates. * `spotify`: To control your Spotify playback. * `file-organizer`: For automating the organization of your files. * `code-helper`: To assist with programming tasks and debugging. * `homework-helper`: To aid in understanding academic subjects (use responsibly for learning, not cheating).

Even with careful setup, you might encounter occasional issues. This section provides solutions to common problems. ### Problem: "Command not found" This error indicates that your system's terminal cannot locate the `openclaw` executable. **Solutions**: * Close your current terminal window and open a new one. This often refreshes the system's PATH environment variable. * Re-run the OpenClaw installer script. * Manually add the OpenClaw installation directory to your system's PATH environment variable. If you're unsure how to do this, seek assistance from a knowledgeable user or refer to your operating system's documentation. ### Problem: "Gateway won't start" This usually means that another application is already using the default port (18789) that OpenClaw's gateway tries to occupy. **Solution**: You can instruct OpenClaw to use a different port. Try starting the gateway with a new port number: ```bash openclaw gateway --port 18790 ``` Adjust the port number as needed if 18790 is also in use. ### Problem: "AI isn't responding" If your AI fails to respond, several factors could be at play. **Solutions**: * **Verify API Key**: Double-check that the API key entered during onboarding is correct and hasn't expired or been revoked. You can re-enter it via `openclaw config edit`. * **Check AI Service Credits/Subscription**: Ensure you have sufficient credits or an active subscription with your AI provider (Anthropic or OpenAI). * **Examine Logs**: The `openclaw logs` command will display detailed activity and error messages, which can pinpoint the exact cause of the issue. ### Problem: "WhatsApp keeps disconnecting" WhatsApp's connection can sometimes be unstable due to its security protocols. **Solutions**: * Ensure your phone has a stable internet connection. * Avoid logging out of WhatsApp on your phone. * If the connection drops, try re-scanning the QR code to re-link your device. ### Problem: "It's using too much money!" If you're concerned about API costs, you can implement usage limits. **Solution**: Edit your `openclaw.json` configuration file to set maximum token usage per day and define alert thresholds: ```json "limits": { "maxTokensPerDay": 100000, "alertWhenOver": 50000 } ``` This helps manage your spending by capping daily usage and notifying you when you approach the limit.

As OpenClaw integrates with your digital life and connects to external services, it's paramount to prioritize online safety and data security. Adhering to these guidelines will help protect your information and ensure a secure experience. ### 1. NEVER Share Your API Keys Your API key is a sensitive credential that grants access to your AI service account. Treat it with the same caution as a password. * **Do Not**: Post your API key on social media, share it with friends, or embed it in publicly accessible code repositories. * **Secure Storage**: Keep your API keys in a secure location, such as a password manager, and only provide them to trusted applications like OpenClaw. ### 2. Be Cautious with Personal Information While OpenClaw can be a personal assistant, avoid sharing highly sensitive personal details with it. * **Avoid Sharing**: Do not disclose your home address, full phone number, parents' credit card information, or passwords to other accounts. * **Privacy**: Remember that while OpenClaw runs locally, the AI models themselves process your queries. Be mindful of the information you input. ### 3. Utilize the Pairing System For messaging channels like WhatsApp, OpenClaw offers a pairing system that restricts access to approved contacts. * **Enable and Use**: Ensure this feature is active and only approve trusted phone numbers. This prevents unauthorized individuals from interacting with your AI. ### 4. Don't Rely Solely on AI OpenClaw, despite its advanced capabilities, is not infallible. AI models can sometimes generate incorrect or misleading information. * **Verify Information**: Always double-check critical information, especially for academic or professional tasks. * **Ethical Use**: Use OpenClaw as a learning tool, not as a means to cheat on assignments or plagiarize content. * **Critical Thinking**: Maintain a critical perspective on the information provided by the AI. Use your own judgment and reasoning.