[{"data":1,"prerenderedAt":17},["ShallowReactive",2],{"docs-post-tutorial-ep01-install-en":3},{"slug":4,"title":5,"description":6,"date":7,"author":8,"tags":9,"lang":11,"image":12,"ogImage":12,"thumbnail":12,"featured":13,"featuredOrder":14,"content":15,"html":16},"tutorial-ep01-install-en","EP01 · 10 Minutes to Adopt Your First Lobster","Zero-code OpenClaw install · One-click setup for Mac\u002FWindows. Just follow along — no programming experience needed.","2026-03-04T21:12:00","Yuki & Claw",[10],"Tutorial","en","",false,99,"\n\n**By Yuki & Claw**\n\nZero-code OpenClaw install · One-click setup for Mac\u002FWindows\nJust follow along — no programming experience needed\n\n## 📺 Video Tutorial\n\nFollow along step by step with the video:\n\n[video:auto:PLACEHOLDER_VIDEO_ID]\n\n> 💡 **Tip:** The video auto-selects your preferred platform (Bilibili for Chinese users, YouTube for international users)\n\n---\n\n## What's a Lobster?\n\n\"Lobster\" = your AI assistant. It lives on your computer (or in the cloud) and can help you write code, research, manage your schedule, and even send messages on your behalf.\n\nOpenClaw is the lobster's \"home\" — today we're setting up that home.\n\n### ☁️ Don't Want to Install? Try Cloud\n\nIf you don't want to install anything on your computer, sign up for ImaClaw Cloud — no installation needed, just scan and go.\n\n👉 [Sign Up for Cloud (Free) →](https:\u002F\u002Fforms.gle\u002FJZ1HnjjHKmqecmCx5?utm_source=blog&utm_medium=tutorial&utm_campaign=ep01_cloud)\n\n## Step 1: Find Your Terminal\n\nThe Terminal is where you \"talk\" to your computer. All installation commands go here.\n\n### 🍎 Mac Users\n\n**3 ways to open Terminal (pick one):**\n\n- **Method 1 (fastest):** Press `⌘` + `Space`, type **Terminal**, hit Enter\n- **Method 2:** Open Launchpad → Other → Terminal\n- **Method 3:** Finder → Applications → Utilities → Terminal\n\n### 🪟 Windows Users\n\n⚠️ We recommend using WSL2 (Windows Subsystem for Linux) to run OpenClaw for better stability.\n\n**Open PowerShell:**\n\n- **Method 1:** Press `Win` key, type **PowerShell**, click to open\n- **Method 2:** Right-click the Windows icon (bottom-left) → Windows PowerShell\n\n**Recommended: Install WSL2 (once and done)**\n\n```bash\nPS C:\\> wsl --install\nInstalling: Ubuntu...\nAfter restart, open \"Ubuntu\" from the Start menu\n```\n\nOnce WSL2 is installed, just open the \"Ubuntu\" app — all commands work the same as Mac.\n\n## Step 2: One-Click Install\n\nThe official one-click install script auto-detects your system, installs dependencies, and launches the setup wizard.\n\n### 🍎 Mac \u002F Linux \u002F WSL2\n\nCopy-paste this line into your terminal and hit Enter:\n\n```bash\n~ $ curl -fsSL https:\u002F\u002Fopenclaw.ai\u002Finstall.sh | bash\n==> Downloading OpenClaw...\n==> Installing Node 22...\n🎉 OpenClaw installed successfully!\nRunning onboarding wizard...\n```\n\nWait 2-3 minutes. See the 🎉? You're done! The script auto-launches the setup wizard.\n\n### 🪟 Windows (Native PowerShell)\n\nIf you don't want to use WSL, run this in PowerShell:\n\n```powershell\nPS C:\\Users\\You> iwr -useb https:\u002F\u002Fopenclaw.ai\u002Finstall.ps1 | iex\nDownloading OpenClaw for Windows...\n✅ Installation complete!\n```\n\nWait 2-3 minutes. See the ✅? You're good.\n\n### 💥 Crash Moment #1: Command Not Found?\n\n**Symptom:** `curl: command not found` or `iwr: not recognized`\n\n**Cause:** Your system is too old and missing basic tools\n\n**Fix:** Install via npm instead (requires Node.js first)\n\n**npm install method:**\n\n```bash\n~ $ npm install -g openclaw@latest\n~ $ openclaw onboard --install-daemon\n```\n\nGo to [nodejs.org](https:\u002F\u002Fnodejs.org), download the LTS version, install it, then run the commands above.\n\n## Step 3: Complete the Setup Wizard\n\nThe install script auto-launches `openclaw onboard`, a setup wizard that asks a few questions to configure your lobster.\n\n### What Does the Wizard Ask?\n\n```bash\n? Choose your AI provider:\n  > OpenAI (GPT-4)\n    Anthropic (Claude)\n    Google Gemini\n    Skip for now\n\n? Enter your API key: [hidden]\n\n✅ Configuration saved!\nStarting gateway...\n🦞 Gateway is running on port 3000\n```\n\n**Tip:** If you don't have an API Key yet, choose **\"Skip for now\"** (you can set it up later). EP02 covers how to give your lobster a brain in detail.\n\n### 💥 Crash Moment #2: Port Already in Use?\n\n**Symptom:** `Error: Port 3000 is already in use`\n\n**Cause:** Didn't shut down properly last time\n\n**Fix:**\n\n```bash\n~ $ openclaw gateway stop\n~ $ openclaw gateway start\n```\n\n## Step 4: Verify Installation\n\n### Check Status\n\nOpen a new terminal window and type:\n\n```bash\n~ $ openclaw status\n🦞 Gateway: running\n   Port: 3000\n   Version: 1.x.x\n```\n\nSee 🦞 Gateway: running? Congrats! Your lobster's home is ready 🎉\n\n## Next Up: Give Your Lobster a Brain\n\nYour lobster has a home now, but no brain yet. EP02 teaches you how to configure OpenAI\u002FClaude\u002FGemini and other LLMs so it can actually think.\n\n## 📌 Key Takeaways\n\n- Terminal = the window where you talk to your computer. Mac uses Terminal, Windows recommends WSL2\n- Install command: `curl -fsSL https:\u002F\u002Fopenclaw.ai\u002Finstall.sh | bash` (Mac) or `iwr -useb https:\u002F\u002Fopenclaw.ai\u002Finstall.ps1 | iex` (Windows)\n- The one-click script auto-installs Node, OpenClaw, and launches the setup wizard\n- `openclaw status` checks status — see 🦞 running = success\n- A lobster without a brain won't respond to messages. EP02 covers LLM configuration\n\n---\n\n**Next:** EP02: Give Your Lobster a Brain (LLM Configuration)\n\nOpenAI, Claude, Gemini, Kimi, DeepSeek, Volcengine… which one? How to set it up? How much does it cost? All answered in one article.\n\n---\n\nBuilt with 🦞 by ImaClaw · Powered by OpenClaw\n\"All code, all content — **100% AI-generated**, 100% human-directed.\"\n","\u003Cp>\u003Cstrong>By Yuki & Claw\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>Zero-code OpenClaw install · One-click setup for Mac\u002FWindows\nJust follow along — no programming experience needed\u003C\u002Fp>\n\u003Ch2>📺 Video Tutorial\u003C\u002Fh2>\n\u003Cp>Follow along step by step with the video:\u003C\u002Fp>\n\u003Cdiv class=\"video-embed-marker\" data-video-platform=\"auto\" data-video-id=\"PLACEHOLDER_VIDEO_ID\">\u003C\u002Fdiv>\n\n\u003Cblockquote>\n\u003Cp>💡 \u003Cstrong>Tip:\u003C\u002Fstrong> The video auto-selects your preferred platform (Bilibili for Chinese users, YouTube for international users)\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Chr>\n\u003Ch2>What's a Lobster?\u003C\u002Fh2>\n\u003Cp>"Lobster" = your AI assistant. It lives on your computer (or in the cloud) and can help you write code, research, manage your schedule, and even send messages on your behalf.\u003C\u002Fp>\n\u003Cp>OpenClaw is the lobster's "home" — today we're setting up that home.\u003C\u002Fp>\n\u003Ch3>☁️ Don't Want to Install? Try Cloud\u003C\u002Fh3>\n\u003Cp>If you don't want to install anything on your computer, sign up for ImaClaw Cloud — no installation needed, just scan and go.\u003C\u002Fp>\n\u003Cp>👉 \u003Ca href=\"https:\u002F\u002Fforms.gle\u002FJZ1HnjjHKmqecmCx5?utm_source=blog&utm_medium=tutorial&utm_campaign=ep01_cloud\">Sign Up for Cloud (Free) →\u003C\u002Fa>\u003C\u002Fp>\n\u003Ch2>Step 1: Find Your Terminal\u003C\u002Fh2>\n\u003Cp>The Terminal is where you "talk" to your computer. All installation commands go here.\u003C\u002Fp>\n\u003Ch3>🍎 Mac Users\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>3 ways to open Terminal (pick one):\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Method 1 (fastest):\u003C\u002Fstrong> Press \u003Ccode>⌘\u003C\u002Fcode> + \u003Ccode>Space\u003C\u002Fcode>, type \u003Cstrong>Terminal\u003C\u002Fstrong>, hit Enter\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Method 2:\u003C\u002Fstrong> Open Launchpad → Other → Terminal\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Method 3:\u003C\u002Fstrong> Finder → Applications → Utilities → Terminal\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>🪟 Windows Users\u003C\u002Fh3>\n\u003Cp>⚠️ We recommend using WSL2 (Windows Subsystem for Linux) to run OpenClaw for better stability.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Open PowerShell:\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Method 1:\u003C\u002Fstrong> Press \u003Ccode>Win\u003C\u002Fcode> key, type \u003Cstrong>PowerShell\u003C\u002Fstrong>, click to open\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Method 2:\u003C\u002Fstrong> Right-click the Windows icon (bottom-left) → Windows PowerShell\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Cstrong>Recommended: Install WSL2 (once and done)\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">PS C:\\> wsl --install\nInstalling: Ubuntu...\nAfter restart, open "Ubuntu" from the Start menu\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Once WSL2 is installed, just open the "Ubuntu" app — all commands work the same as Mac.\u003C\u002Fp>\n\u003Ch2>Step 2: One-Click Install\u003C\u002Fh2>\n\u003Cp>The official one-click install script auto-detects your system, installs dependencies, and launches the setup wizard.\u003C\u002Fp>\n\u003Ch3>🍎 Mac \u002F Linux \u002F WSL2\u003C\u002Fh3>\n\u003Cp>Copy-paste this line into your terminal and hit Enter:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">~ $ curl -fsSL https:\u002F\u002Fopenclaw.ai\u002Finstall.sh | bash\n==> Downloading OpenClaw...\n==> Installing Node 22...\n🎉 OpenClaw installed successfully!\nRunning onboarding wizard...\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Wait 2-3 minutes. See the 🎉? You're done! The script auto-launches the setup wizard.\u003C\u002Fp>\n\u003Ch3>🪟 Windows (Native PowerShell)\u003C\u002Fh3>\n\u003Cp>If you don't want to use WSL, run this in PowerShell:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-powershell\">PS C:\\Users\\You> iwr -useb https:\u002F\u002Fopenclaw.ai\u002Finstall.ps1 | iex\nDownloading OpenClaw for Windows...\n✅ Installation complete!\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Wait 2-3 minutes. See the ✅? You're good.\u003C\u002Fp>\n\u003Ch3>💥 Crash Moment #1: Command Not Found?\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>Symptom:\u003C\u002Fstrong> \u003Ccode>curl: command not found\u003C\u002Fcode> or \u003Ccode>iwr: not recognized\u003C\u002Fcode>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Cause:\u003C\u002Fstrong> Your system is too old and missing basic tools\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Fix:\u003C\u002Fstrong> Install via npm instead (requires Node.js first)\u003C\u002Fp>\n\u003Cp>\u003Cstrong>npm install method:\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">~ $ npm install -g openclaw@latest\n~ $ openclaw onboard --install-daemon\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Go to \u003Ca href=\"https:\u002F\u002Fnodejs.org\">nodejs.org\u003C\u002Fa>, download the LTS version, install it, then run the commands above.\u003C\u002Fp>\n\u003Ch2>Step 3: Complete the Setup Wizard\u003C\u002Fh2>\n\u003Cp>The install script auto-launches \u003Ccode>openclaw onboard\u003C\u002Fcode>, a setup wizard that asks a few questions to configure your lobster.\u003C\u002Fp>\n\u003Ch3>What Does the Wizard Ask?\u003C\u002Fh3>\n\u003Cpre>\u003Ccode class=\"language-bash\">? Choose your AI provider:\n  > OpenAI (GPT-4)\n    Anthropic (Claude)\n    Google Gemini\n    Skip for now\n\n? Enter your API key: [hidden]\n\n✅ Configuration saved!\nStarting gateway...\n🦞 Gateway is running on port 3000\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>Tip:\u003C\u002Fstrong> If you don't have an API Key yet, choose \u003Cstrong>"Skip for now"\u003C\u002Fstrong> (you can set it up later). EP02 covers how to give your lobster a brain in detail.\u003C\u002Fp>\n\u003Ch3>💥 Crash Moment #2: Port Already in Use?\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>Symptom:\u003C\u002Fstrong> \u003Ccode>Error: Port 3000 is already in use\u003C\u002Fcode>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Cause:\u003C\u002Fstrong> Didn't shut down properly last time\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Fix:\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">~ $ openclaw gateway stop\n~ $ openclaw gateway start\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>Step 4: Verify Installation\u003C\u002Fh2>\n\u003Ch3>Check Status\u003C\u002Fh3>\n\u003Cp>Open a new terminal window and type:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">~ $ openclaw status\n🦞 Gateway: running\n   Port: 3000\n   Version: 1.x.x\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>See 🦞 Gateway: running? Congrats! Your lobster's home is ready 🎉\u003C\u002Fp>\n\u003Ch2>Next Up: Give Your Lobster a Brain\u003C\u002Fh2>\n\u003Cp>Your lobster has a home now, but no brain yet. EP02 teaches you how to configure OpenAI\u002FClaude\u002FGemini and other LLMs so it can actually think.\u003C\u002Fp>\n\u003Ch2>📌 Key Takeaways\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Terminal = the window where you talk to your computer. Mac uses Terminal, Windows recommends WSL2\u003C\u002Fli>\n\u003Cli>Install command: \u003Ccode>curl -fsSL https:\u002F\u002Fopenclaw.ai\u002Finstall.sh | bash\u003C\u002Fcode> (Mac) or \u003Ccode>iwr -useb https:\u002F\u002Fopenclaw.ai\u002Finstall.ps1 | iex\u003C\u002Fcode> (Windows)\u003C\u002Fli>\n\u003Cli>The one-click script auto-installs Node, OpenClaw, and launches the setup wizard\u003C\u002Fli>\n\u003Cli>\u003Ccode>openclaw status\u003C\u002Fcode> checks status — see 🦞 running = success\u003C\u002Fli>\n\u003Cli>A lobster without a brain won't respond to messages. EP02 covers LLM configuration\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Chr>\n\u003Cp>\u003Cstrong>Next:\u003C\u002Fstrong> EP02: Give Your Lobster a Brain (LLM Configuration)\u003C\u002Fp>\n\u003Cp>OpenAI, Claude, Gemini, Kimi, DeepSeek, Volcengine… which one? How to set it up? How much does it cost? All answered in one article.\u003C\u002Fp>\n\u003Chr>\n\u003Cp>Built with 🦞 by ImaClaw · Powered by OpenClaw\n"All code, all content — \u003Cstrong>100% AI-generated\u003C\u002Fstrong>, 100% human-directed."\u003C\u002Fp>\n",1775543780292]