AB
AiBoss
Tutorials

A complete guide to installing and deploying OpenClaw on both Mac and Windows systems, all in one article.

Lobsters are still incredibly popular lately. Even with such popularity, many people are still just getting their hands on lobsters, let alone raising them. Tencent has even launched a promotion offering free OpenClaw installations at the company's headquarters. ...

OpenClaw 安装部署 Mac/Win 双系统完整版指南,一文搞定

Lobster is still the hottest food lately 🦞.

Even with such popularity, many people are still only at the stage of getting lobsters 🦞, let alone raising lobsters 🦞.

Tencent even launched a live event at the entrance of its factory.freeInstall OpenClaw. We provide a one-stop service for installing and using OpenClaw.

The participants on-site ranged in age from 2 to 60 years old, and Peter, the founder of OpenClaw, even retweeted Tencent's event.

In just a few hours, hundreds of lobsters were successfully produced.

During my own deployment process, I did encounter many bottlenecks that left me completely stumped. It seems that there is a certain technical threshold required, or rather, the system/permission requirements during installation are something that ordinary beginners cannot understand.

Below are the installation steps I consulted with a tech expert; they're definitely suitable for beginners.

If you still have questions, you can follow our official WeChat account and reply with the following code:OpenClawJoin the discussion group to install, deploy, and share your experiences.

Mac system

Check and install Node.js

If you have Node.js installed, enter the following command in the terminal to check the version. It must be version 22 or higher.

node -v

If you haven't installed it, please download and install it from the official website: https://nodejs.org/zh-cn/download

Enter the command above again to check the version.

Check and install Homebrew

brew --version

Displaying the version number indicates that it is installed.

The message "command not found: brew" means that the command is not available.

Just enter the following installation command: (Using a domestic mirror will be faster.)automaticConfigure environment variables)

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

Press Enter, and you will be prompted to enter your Mac password (it's normal that it won't be displayed while you're typing it).

Follow the prompts to select the mirror image; you can directly enter 1/2 or wait for the script.automaticComplete all steps.

Enter the check command above again to verify the Homebrew installation status. If the version number is output, the installation was successful.

Windows system

Install WSL

Why install WSL?
Since OpenClaw itself does not support Windows systems, installing WSL is essentially giving you a Linux system.

Search for PowerShell, right-click and select "Run as administrator".

A prompt will appear asking if you can allow the app to make changes to the device. Select "Yes".

wsl --install

meetingautomaticDownload and install WSL2 and Ubuntu (a Linux system).Note⚠️ You need to restart your computer after installation.

After restarting the computerautomaticA window will pop up asking you to configure Ubuntu; just set any option.SimpleI can remember the username and password.

The window should display correctly like this.

Search for "Ubuntu" and open it; subsequent command interactions will take place here.

Install Node.js

This step involves installing Node.js in WSL; previously installed Node.js will likely not work here.

Then enter the commands in Ubuntu one by one.

sudo apt update

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

After completion, enter the command to verify the installation status.

node -v

Seeing the version number means it was successful.

Once the above preparations are complete, you can begin installing OpenClaw.

Installation command

MacOS:

Enter officialrecommendCommand:

curl -fsSL https://openclaw.ai/install.sh | bash

If you encounter the same insufficient permissions issue as below during installation...

This can be resolved by entering the following commands, executing them sequentially, and then executing the installation command.

sudo chown -R $(whoami) /usr/local/lib/node_modules

sudo chown -R $(whoami) /usr/local/bin
sudo chown -R 501:20 "/Users/换成你的用户名/.npm"

If that still doesn't work, then...recommendOne method is to first install NVM and then use NVM to manage [the system/service].npmThen execute the installation command.

Windows:

iwr -useb https://openclaw.ai/install.ps1 | iex

After successful installation,automaticOpen the configuration wizard. The options in the configuration wizard are system-independent and universal.

Configuration Selection

Seeing this page means the installation was successful. Continue to select configuration options.

1.Select: Yes

2.Select: QuickStart

3.Model API Configuration: Select a provider with a model API, or you can skip this step by selecting Skip. You can reconfigure it later by entering the command "openclaw onboard" or by modifying it in a local JSON file.

4.Configure chat channels: NowrecommendFor Lark, if you're unsure, you can skip this step for now. After installation, you can reconfigure it using OpenClaw channels add. Alternatively, you can have Lobster help you connect.

5.Skills configuration: Select Yes, then press Enter, press Space to skip, then press Enter again.

6.Select "No" or skip the rest.

7.Installation complete. Select the second option.automaticOpen the Web UI page.

You can send a message to test it out: "Introduce yourself." If you get a reply, it means it's okay.

If you selected "Skip" when configuring the chat channels above, you can now reconfigure them by entering the following command.

openclaw channels add

Select Yes, select Lark channel, and select download and installation.

arrive Enter App Secret This step is paused; you need to create the Lark robot first.

We open the Lark Open Platform website: https://open.feishu.cn/?lang=zh-CN

Select the developer backend, click "Create Enterprise Self-built Application", enter the application name, select an avatar, and click "Create".

Add application capabilities, select "Add Robot".

Select Permission Management, click Batch Import Permissions, copy the following JSON content, and request permission configuration.

{ “scopes”: { “tenant”: [ “contact:contact.base:readonly”, “contact:user.base:readonly”, “im:message”, “im:message.group_at_msg:readonly”, “im:message.group_msg”, “im:message.p2p_msg:readonly”, “im:message.reactions:read”, “im:message:readonly”, “im:message:recall”, “im:message:send_as_bot”, “im:message:update”, “im:resource” ], “user”: [ “docx:document:readonly” ] } }

To publish an application, select "Create Version," enter the version number and description, click "Save," and apply for online release.

chooseCertificates and Basic Information, obtain App ID and App Secret .

Return to the command line interface and enter the following commands into the terminal:

See the image below for the subsequent choices.

Then go to Lark and select...Configure event subscription,chooseLong connection,save.

Click Add Event, Search im.message.receive_v1 Check the box to add.

Create another version and release it online.

Open Lark, in the developer assistant, select "Open Application," send a message to the bot, and you're done if you get a reply.

For recentAIThe changes can be described with a vivid analogy.

Ten months of pregnancy 🫄 👉 birth 🐣 👉 nurturing 🧑‍🍼 👉 learning to express and speak 👉 being able to ask questions and think 👉 solving problems on your own 👉 learning skills (walking, running, cycling, going to school, learning life skills, social skills, etc.) 👉 then the next step is to find a job, earn money, and survive.

Looking at it from the other sideAIThat matches perfectly.

fromGPTDeepSeek and similar servicesLarge ModelThe process of implementation is like the birth of a baby; it involves continuously absorbing data, upgrading and iterating, adding capabilities, and then...Agent…and the capabilities at this stage.

Sometimes you shouldn't...AIViewed as a robot, it can be seen as a product of another kind of life. It evolves in ways that mimic human evolution, survival, and learning, but at the same time, it surpasses human evolution, survival, and learning.

The emergence and application of OpenClaw can be understood as a two-way mirror, much like the process of parents and children interacting. When you tell a child what to do or what not to do, the result may not be what you expect; it may give you something to reflect on or allow you to correct your mistakes in time.

It's less about raising shrimp and more about leading your next generation.

In the end, the student surpasses the teacher.

Original link:A comprehensive OpenClaw tutorial, including a complete installation and deployment guide for Mac/Win.