OpenClaw 2026保姆级安装教程(mac/win都可)

OpenClaw 2026保姆级安装教程：从零部署到飞书接入，新手避坑指南！

从此拥有7×24小时在线的私人AI助理

最近OpenClaw在开发者圈子里热度持续攀升，这个开源的个人AI助理不仅能陪你聊天，还能真正“动手做事”——处理邮件、管理日历、编写代码，甚至控制智能家居。但不少新手在安装第一步就卡住了：环境配置报错、权限不足、API连接失败...

今天我就带大家从头开始，一步步完成OpenClaw的安装和配置，全程命令可复制，关键避坑点已标注，即使是零基础的小白也能轻松上手！

windows用户安装教程（mac用户往下翻）

一、OpenClaw是什么？为什么要装？

在开始安装前，先简单了解下这个工具。OpenClaw（曾用名ClawdBot/Moltbot）是一个本地优先、开源的个人AI智能体。

它的核心优势在于强执行能力——不只是回答问题，而是能真正调用工具完成任务：帮你操作文件、管理日历、自动写公众号文章、联网搜索、控制浏览器...而且所有数据都存储在你自己的设备或服务器上，隐私安全可控。

简单来说，安装OpenClaw，就是给自己配备了一个24小时在线、随叫随到的AI数字员工。

二、安装前的灵魂拷问：本地还是云端？

在开始敲命令前，先根据你的需求选择部署方案：

小贴士：如果只是尝鲜，推荐计算巢一键部署；如果想长期稳定运行，选阿里云ECS；如果注重隐私且电脑配置还行（内存≥8GB），选本地部署。

三、本地部署详细步骤（以Windows 11为例）

1. 准备工作：解锁PowerShell权限

右键点击“开始”菜单，选择 “Windows PowerShell（管理员）” （务必是管理员模式），执行以下命令解锁权限：

```powershell

Set-ExecutionPolicy Bypass -Scope Process -Force

```

此步骤避免后续安装报错，每次打开新PowerShell都需要重新执行。

2. 一键安装OpenClaw

在管理员PowerShell中执行（二选一）：

方案一：官方beta版脚本（适配2026最新版，推荐）：

```powershell

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta

```

方案二：国内镜像脚本（网络受限时使用）：

```powershell

iwr -useb https://clawd.org.cn/install.ps1 | iex

```

安装过程约5-10分钟，系统会自动下载Node.js和依赖包。

安装完成后验证：

```powershell

openclaw --version

```

看到版本号（如“2026.3.2-beta.1”）即成功。

3. 配置并启动Gateway服务

Gateway是OpenClaw的“心脏”，必须保持运行。

```powershell

# 配置本地运行模式

openclaw config set gateway.mode local

# 安装服务（创建Windows计划任务，实现开机自启）

openclaw gateway install

# 启动服务

openclaw gateway start

# 查看服务状态（应为“Running”）

openclaw gateway status

```

4. 访问Web控制台

打开浏览器，访问：http：//127.0.0.1:18789

看到OpenClaw登录界面，恭喜你，本地部署核心步骤已完成！

5. 初始化配置（Onboarding）

在刚才的浏览器界面，或继续在PowerShell中执行：

```powershell

openclaw onboard --install-daemon

```

按向导提示完成配置：

· 安装守护进程：选 yes

· Onboarding模式：选 QuickStart

· 模型服务提供商：选 Custom Provider 或你喜欢的服务商（如阿里云百炼、Kimi等）

· 输入API Key：后续会讲到如何获取

· Skills和Hooks：新手可先选“否”或跳过，后续按需安装

四、阿里云部署（7×24小时稳定运行）

如果你不想让AI助理随着电脑关机而“下班”，云部署是更好的选择。

方案A：计算巢极速部署（3分钟，纯新手首选）

1. 准备工作：注册阿里云账号并完成实名认证，获取阿里云百炼API Key

2. 进入部署页：登录阿里云控制台，访问计算巢OpenClaw社区版部署页面（可在应用市场搜索“OpenClaw社区版”）

3. 一键部署：点击“立即部署”，地域选“中国香港”（免备案），粘贴你的百炼API Key，其他默认即可

4. 等待3分钟，系统自动生成访问地址：http：//公网IP:18789/?token=你的Token

5. 直接浏览器打开，即可使用

方案B：ECS手动部署（更灵活，适合进阶用户）

如果你已有云服务器，或想自己掌控更多配置，可参考以下命令（以Ubuntu系统为例）：

```bash

# 更新系统并安装Docker

sudo apt update -y && sudo apt upgrade -y

sudo apt install -y docker.io docker-compose

sudo systemctl enable docker

sudo systemctl start docker

# 拉取OpenClaw镜像并启动

docker pull openclaw/openclaw:2026-latest

mkdir -p /opt/openclaw/{config,data,logs}

docker run -d \

--name openclaw \

--restart always \

-p 18789:18789 \

-v /opt/openclaw/config:/app/config \

-v /opt/openclaw/data:/app/data \

-v /opt/openclaw/logs:/app/logs \

-e TZ=Asia/Shanghai \

-e ALIYUN_BAILIAN_API_KEY="你的百炼API Key" \

openclaw/openclaw:2026-latest

# 生成管理员Token

docker exec -it openclaw openclaw token generate --admin

```

记得在阿里云控制台安全组中放行18789端口。

五、关键配置：获取API Key

OpenClaw需要连接大语言模型才能“思考”和“回答”。这里以阿里云百炼为例（国内用户首选，速度稳定）：

1. 访问阿里云百炼大模型服务平台，注册或登录

2. 进入“密钥管理”，点击“创建API-Key”

3. 复制生成的Key（格式如 sk-...）

4. 在OpenClaw配置向导中粘贴此Key

其他选择：Kimi、DeepSeek、OpenAI等也支持，按需选择即可。

六、扩展功能：接入飞书/钉钉/企业微信

安装完基础版，怎么在手机上和AI聊天？接入即时通讯工具是关键。

以飞书为例（企业微信和钉钉类似）：

1. 安装飞书插件

在OpenClaw控制台或命令行执行：

```powershell

openclaw plugins install @m1heng-clawd/feishu

```

2. 飞书开放平台创建应用

· 登录飞书开放平台，点击“创建应用”→ “自建应用”

· 开启“机器人能力”

· 获取 App ID 和 App Secret

3. 配置OpenClaw

```powershell

openclaw config set channels.feishu.enabled true --json

openclaw config set channels.feishu.app_id "你的AppID" --json

openclaw config set channels.feishu.app_secret "你的Secret" --json

openclaw config set channels.feishu.verification_token "你的Token" --json

openclaw channel restart feishu

openclaw gateway restart

```

4. 配置事件订阅

在飞书应用后台的“事件与回调”页面：

· 订阅方式选择“使用长连接接收事件”

· 添加事件 im.message.receive_v1（必选，否则收不到消息）

· 发布版本

完成后，在飞书中搜索你的机器人，发送消息即可配对使用。

七、常用命令速查（排错必备）

遇到问题别慌，这些命令能帮你快速定位：

命令作用

openclaw gateway status 查看网关运行状态

openclaw gateway restart 重启网关（刷新配置后常用）

openclaw logs follow 实时查看日志（排错首选）

openclaw doctor 全面健康检查

openclaw config 查看/修改配置

openclaw models status 检查模型API Key是否有效

openclaw channels list 列出已配置的通讯渠道

八、避坑指南（新手最容易卡住的地方）

1. PowerShell权限：务必以管理员身份运行，否则会报错

2. Node.js版本：OpenClaw 2026要求Node.js ≥ v22.0.0，用 node -v 检查

3. 端口占用：如果18789端口被占用，可在配置中修改

4. API Key无效：检查是否有多余空格，密钥格式是否正确

5. 飞书收不到消息：检查事件订阅是否添加 im.message.receive_v1，以及是否发布版本

九、装完后能做什么？

安装只是开始，OpenClaw的真正威力在于插件生态（ClawHub已有3000+技能包）。装完基础版后，你可以：

· 安装 SerpAPI 实现联网搜索（每月100次免费）

· 安装 Chrome无头浏览器，让AI帮你打开网页、截图

· 安装 wechat-article-fetcher，自动获取公众号文章并总结

· 配置 content-auto-flow，实现“一句话写公众号文章+配图+存草稿箱”全自动

苹果用户专属：MacBook安装OpenClaw全攻略，打造你的本地AI助理！

程序员和创作者都在用的开源AI智能体，M芯片优化加持

无论你是搭载M1/M2/M3芯片的新款MacBook，还是Intel芯片的Mac，这篇文章都将带你一步步搭建属于自己的AI助理。全程命令可复制，避坑点已标注，15分钟搞定！

一、为什么Mac特别适合运行OpenClaw？

在开始之前，先说个好消息：Apple Silicon（M系列芯片）运行OpenClaw有天然优势——ARM架构与Node.js完美兼容，相比同级别Intel Mac性能提升约30%，而且功耗更低，你的MacBook即使不插电也能长时间运行AI服务。

OpenClaw（曾用名Clawdbot/Moltbot）作为一个本地优先的开源AI智能体，在Mac上能充分发挥硬件潜力——既能用本地模型保障隐私，也能调用云端API获得更强能力。

二、部署方案选择：本地还是云端？

小贴士：只是想快速体验选Ollama方案；注重隐私选本地部署；需要7×24小时在线选阿里云。

三、方案一：Mac本地部署（稳定首选，隐私保障）

第一步：基础环境配置

打开Mac的「终端」（Terminal），按顺序执行以下命令：

1. 安装Homebrew（Mac必备包管理器）

```bash

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

```

安装完成后，根据终端提示执行后续命令（Intel和M芯片的命令可能不同，终端会有提示）。验证安装：

```bash

brew --version

```

2. 安装Node.js（核心依赖）

OpenClaw 2026版本要求Node.js ≥ v22.0.0，推荐使用nvm管理版本：

```bash

# 安装nvm（Node版本管理器）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 刷新环境变量（如果是zsh，使用~/.zshrc；bash使用~/.bashrc）

source ~/.zshrc

# 安装Node.js最新LTS版（v24.x）

nvm install --lts

nvm use --lts

# 验证安装

node --version # 应显示v24.x.x及以上

npm --version # 应显示10.x.x及以上

```

避坑提示：不要直接用Homebrew安装Node.js，用nvm可以随时切换版本，避免版本冲突。

3. 安装Git（已预装可跳过）

```bash

brew install git

git --version

```

4. 安装Redis（可选但推荐）

部分技能和消息队列依赖Redis：

```bash

brew install redis

brew services start redis # 后台运行

redis-cli ping # 应返回PONG

```

第二步：安装OpenClaw（二选一）

方式A：npm全局安装（版本控制清晰，推荐）

```bash

# 全局安装

sudo npm install -g openclaw@latest

# 解决Git下载协议问题（如果安装报错）

git config --global url."https://github.com/".insteadOf ssh://git@github.com/

# 重新执行安装（如果上一步报错）

sudo npm install -g openclaw@latest

# 验证安装

openclaw --version # 应显示2026.3.x及以上

```

方式B：官方一键脚本（更自动化）

```bash

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

```

安装脚本会自动处理依赖和路径配置。

第三步：初始化配置向导

这是最关键的步骤，将引导你完成模型、渠道等设置：

```bash

openclaw onboard --install-daemon

```

按终端提示逐步操作（避坑点已加粗）：

步骤选项说明

安装守护进程 yes 必选，让OpenClaw后台常驻

Onboarding模式 QuickStart 快速开始模式，适合新手

模型服务提供商 Custom Provider 或具体平台选择你的AI模型来源

API Key配置粘贴你的密钥输入时不可见，粘贴后回车即可

消息渠道 Skip for now 后续单独配置飞书/Telegram等

技能安装 No 或选择性安装新手先跳过，后续按需添加

完成配置 Open the Web UI 浏览器自动打开控制台

配置完成后，浏览器自动打开http：//127.0.0.1：18789，看到OpenClaw界面即核心部署成功！

第四步：验证服务状态

```bash

# 查看Gateway服务状态

openclaw gateway status # 应显示Running

# 查看实时日志（排错用）

openclaw logs follow

```

M芯片专属优化：验证Node.js是否以arm64原生运行：

```bash

node -p "process.arch" # 应输出arm64，不是x64

```

如果显示x64，说明Node.js运行在Rosetta转译模式下，重新安装arm64版Node.js即可获得更好性能。

四、方案二：Ollama一键部署（新手福音，免费云模型）

如果你觉得上面步骤还是太复杂，Ollama推出了革命性的一键安装方案——不仅步骤极简，还提供免费云模型额度，每周重置，新手友好度拉满！

前置准备

1. 安装Ollama：访问Ollama官网下载安装

2. 注册Ollama账号（免费）

一键安装

打开终端，执行：

```bash

ollama launch openclaw

```

系统会自动检测并安装OpenClaw，然后进入交互式配置：

1. 选择模型类型：选择Cloud model（免费云模型）或Local model（本地模型，需25GB以上显存）

2. 选择具体模型：推荐选minimax-m2.5：cloud或kimi-k2.5：cloud，响应速度快

3. 授权登录：浏览器自动打开Ollama登录页，确认连接

等待几分钟，终端显示完成信息，复制显示的Web UI地址（如http：//localhost：18789）到浏览器打开——全程不到5分钟，你的AI助理就跑起来了！

免费额度查看：登录Ollama官网后台的Usage页面，每周赠送的云模型额度通常只消耗1-2%，非常慷慨。

五、配置AI模型：获取API Key

OpenClaw需要接入大模型才能“思考”。以下以阿里云百炼为例（国内用户首选，速度快稳定）：

1. 访问阿里云百炼控制台，登录阿里云账号

2. 进入「密钥管理」，点击「创建API-Key」

3. 复制生成的Key（格式如sk-...）

4. 在OpenClaw中配置：

```bash

openclaw config set models.providers.bailian.apiKey "你的API-Key"

openclaw config set agents.defaults.model.primary "bailian/qwen3-max-2026-01-23"

openclaw gateway restart

```

其他选择：Kimi（国内）、DeepSeek（国内）、OpenAI（海外）等也支持，配置方式类似。

六、进阶：接入飞书/Telegram/iMessage

接入飞书（推荐办公场景）

```bash

# 安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

# 启动配置

openclaw config

```

按提示选择「Channels」→「Configure/link」→「Feishu/Lark」，输入从飞书开放平台获取的App ID和App Secret即可。

权限必开：在飞书应用后台的「权限管理」中，开启所有im：开头的消息权限；在「事件订阅」中添加im.message.receive_v1事件并发布版本，否则收不到消息。

接入iMessage（苹果生态专属）

如果你想让iPhone/iPad通过iMessage与AI对话，需额外配置：

1. Mac端安装imsg工具：

```bash

brew install steipete/tap/imsg

```

2. 授予完全磁盘访问权限：

「系统设置」→「隐私与安全性」→「完全磁盘访问」→添加「终端」

3. 配置内网穿透（因iMessage仅本地通信）：

推荐使用ngrok或frp将本地服务映射到公网，具体配置参考阿里云开发者社区的详细教程。

七、Mac用户专属避坑指南

1. 权限问题（最常见）

症状：EACCES： permission denied

解决：避免用sudo npm install，改用sudo chown -R $(whoami) ~/.npm修复权限

2. 端口占用

症状：Error： listen EADDRINUSE： address already in use :::18789

解决：

```bash

lsof -i :18789 # 查看占用进程

kill -9 PID # 替换为实际进程ID

```

3. Node.js版本不匹配

症状：启动报错或功能异常

解决：用nvm切换正确版本

```bash

nvm install 24

nvm use 24

```

4. 开机自启动配置

创建LaunchAgent实现登录自动启动：

```bash

# 创建配置文件

cat > ~/Library/LaunchAgents/com.openclaw.agent.plist << 'EOF'

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<dict>

<key>Label</key>

<string>com.openclaw.agent</string>

<key>ProgramArguments</key>

<array>

<string>/usr/local/bin/openclaw</string>

<string>gateway</string>

<string>start</string>

</array>

<key>RunAtLoad</key>

<true/>

<key>KeepAlive</key>

<true/>

</dict>

</plist>

EOF

# 加载服务

launchctl load ~/Library/LaunchAgents/com.openclaw.agent.plist

```

八、常用命令速查

命令作用

openclaw gateway status 查看服务状态

openclaw gateway restart 重启服务（配置修改后）

openclaw logs follow 实时查看日志（排错首选）

openclaw doctor 全面健康检查

openclaw plugins list 查看已安装插件

openclaw config 交互式配置管理

openclaw tui 启动终端交互界面

九、装完能做什么？

成功部署只是开始，OpenClaw的真正威力在于插件生态（ClawHub已有3000+技能包）：

· 安装 @openclaw/search-engine 实现联网搜索

· 安装 @openclaw/browser-automation 让AI帮你操作网页

· 安装 @openclaw/calendar 管理你的日程

· 安装 @openclaw/file-organizer 自动整理Mac文件

---

现在，你的Mac已经拥有了一位24小时待命的AI数字员工。无论是处理文件、查询信息，还是自动执行重复工作，它都能帮你搞定。

如果在安装过程中遇到问题，欢迎在评论区留言交流。点赞、收藏、转发给同样在用Mac的朋友，一起拥抱AI生产力革命！

你的第一个AI助理，就从今天开始！