OpenClaw本地部署教程准备工作推荐配置为了获得最佳体验，我们推荐：操作系统： 🍎 Mac（强烈推荐）：原生

准备工作

为什么推荐Mac？

OpenClaw在Mac上体验最好，因为：

✅ 原生支持最完善，系统集成度高
✅ 可以操作Mac日历、备忘录、提醒事项
✅ 截图功能完美支持
✅ 与iPhone、iPad无缝同步
✅ 文件管理更智能
✅ 开发环境配置简单

为什么推荐飞书（国内）？

✅ 现代化设计，用户体验好
✅ 开发者友好，API完善
✅ 支持富文本、文档、表格
✅ 消息推送稳定
✅ 免费版功能丰富

为什么推荐Telegram（国外）？

✅ 全球用户基础大
✅ API最完善，功能最强
✅ 支持Bot功能丰富
✅ 消息推送实时
✅ 隐私保护好

Mac本地部署（推荐）

🍎 最佳体验：如果你有Mac电脑，强烈推荐本地部署，体验最好、功能最全！

Mac本地部署（推荐）

优势：

✅ 系统集成：可操作日历、备忘录、文件系统
✅ 隐私安全：数据完全本地，不上传云端
✅ 响应速度快：本地运行，无网络延迟
✅ 功能最全：支持所有高级功能
✅ 成本低：无需购买云服务器
✅ 开发友好：方便调试和自定义

适合人群：

有Mac电脑的用户
注重隐私的用户
需要系统集成功能的用户
开发者和技术爱好者

系统要求

硬件要求：

CPU：M系列芯片或Intel i5以上
内存：8GB以上（推荐16GB）
硬盘：10GB以上空闲空间

系统版本：

macOS 12 Monterey 或更高版本
推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

前置软件：

Node.js 22.0.0+（会自动安装）
Homebrew（可选，用于安装依赖）

安装步骤

第一步：打开终端

按 Command + 空格 打开 Spotlight
输入 Terminal 或终端
按回车打开终端

第二步：安装 OpenClaw

在终端中执行以下命令：

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

安装过程会自动：

检测系统环境
安装Node.js（如果未安装）
下载OpenClaw
配置环境变量

预计时间：2-5分钟

第三步：验证安装

安装完成后，执行以下命令验证：

openclaw --version

如果显示版本号（如 2026.2.9），说明安装成功！

第四步：初始化配置

运行配置向导：

openclaw onboard

配置流程：

接受风险提示：选择 Yes 继续
选择启动模式：推荐选择 QuickStart 快速启动。

选择AI模型：选择你的AI供应商（支持国内外主流模型）。

国内推荐：

Kimi（Moonshot AI）：长文本专家，200万字上下文
DeepSeek：性价比之王，推理能力强
智谱GLM：中文理解好，多模态支持

输入API Key：

根据选择的模型，输入对应的API Key，参见后面的API配置

选择聊天工具：

如果要接入飞书/Telegram，选择对应选项
如果暂时不接入，选择 None（后续可配置）

Gateway端口设置：默认 18789 即可

选择Skills：使用空格键选择你需要的技能，也可以直接跳过。

API Key配置：没有的可以选择 no 跳过

启用Hooks：推荐启用这三个钩子（用于内容引导、日志和会话记录）

完成配置：配置完成后，会自动启动Gateway服务并打开Web UI（http://127.0.0.1:18789/chat）

第五步：验证安装

# 检查Gateway状态
openclaw channels status


# 应该显示：
# Gateway reachable.

基本使用

启动OpenClaw：

# 启动Gateway服务
openclaw gateway start


# 或使用systemd（推荐，开机自启）
openclaw gateway enable

访问Web UI：

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

停止服务：

openclaw gateway stop

常见问题

Q1：安装时提示权限不足？

# 使用sudo安装
curl -fsSL https://openclaw.ai/install.sh | sudo bash

Q2：如何更新OpenClaw？

openclaw update

Q3：如何卸载？

openclaw uninstall

Windows本地部署

系统要求

硬件要求：

CPU：2核以上
内存：4GB以上（推荐8GB）
硬盘：10GB以上空闲空间

操作系统：

Windows 10 或 Windows 11

前置软件：

Node.js 22.0.0+

部署方式选择

Windows有两种部署方式：

WSL2 + Ubuntu（强烈推荐）：官方推荐方式，提供完整Linux环境支持
PowerShell原生部署：纯Windows环境，适合不想使用WSL2的用户

方式一：WSL2 + Ubuntu部署（强烈推荐）

这是官方推荐的Windows部署方式，提供最完整的Linux环境支持。

第一步：启用WSL2

以管理员身份打开PowerShell，执行：

# 启用WSL功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart


# 设置WSL 2为默认版本
wsl --set-default-version 2

重启计算机。

第二步：安装Ubuntu

方法一：Microsoft Store安装（推荐）

打开Microsoft Store
搜索「Ubuntu 22.04 LTS」或「Ubuntu 24.04 LTS」
点击「获取」并安装
首次启动设置用户名和密码

安装完成后会自动打开Ubuntu终端，按提示设置用户名和密码。

第三步：更新Ubuntu系统

在Ubuntu终端中执行：

# 更新软件包列表
sudo apt update && sudo apt upgrade -y


# 安装基础工具
sudo apt install -y curl git wget build-essential

第四步：安装Node.js 22+

# 添加NodeSource仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -


# 安装Node.js
sudo apt install -y nodejs


# 验证版本（必须≥22.x）
node -v
npm -v

第五步：安装 OpenClaw

方法A：一键脚本安装

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

第六步：验证安装

# 查看版本
openclaw --version


# 查看帮助
openclaw --help


# 查看系统状态
openclaw status

第七步：配置Windows访问WSL2服务

由于OpenClaw运行在WSL2中，需要配置端口转发以便Windows访问。

创建启动脚本 start-openclaw.bat：

@echo off
echo Starting OpenClaw Gateway in WSL2...
wsl -d Ubuntu-22.04 -u root service openclaw start
timeout /t 3
start http://localhost:18789

或直接在WSL2中启动：

# 在WSL2 Ubuntu终端中
openclaw gateway run --port 18789

然后在Windows浏览器访问 http://localhost:18789

方式二：PowerShell原生部署

适合不想使用WSL2的纯Windows用户。

第一步：安装Node.js 22+

方法一：官网下载安装

访问 nodejs.org/zh-cn
下载Windows安装包（LTS版本22.x）
运行安装程序，勾选「自动安装必要的工具」

第二步：验证Node.js安装

# 打开PowerShell
node -v
npm -v

第三步：以管理员身份安装 OpenClaw

重要：必须以管理员身份运行PowerShell。

# 安装最新稳定版
npm install -g openclaw@latest


# 或安装汉化版
npm install -g @qingchencloud/openclaw-zh@latest

第四步：解决安装权限问题

如果遇到权限错误：

# 方法A：启用PowerShell脚本执行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser


# 方法B：修改npm安装目录
npm config set prefix "C:\npm"
npm config set cache "C:\npm-cache"


# 将目录添加到PATH
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\npm", "User")

第五步：验证安装

openclaw --version
openclaw --help

第六步：解决常见问题

问题：sharp模块加载失败

# 清理npm缓存
npm cache clean --force


# 重新安装
npm install -g openclaw@latest --force

问题：Windows Defender阻止

将OpenClaw安装目录添加到Windows Defender排除项：

C:\Users\你的用户名\AppData\Roaming\npm
C:\Users\你的用户名.openclaw

初始化配置

安装完成后，需要运行初始化向导。

启动初始化向导

openclaw onboard --install-daemon

配置AI模型提供商

OpenClaw需要对接AI模型才能工作。

以配置Anthropic Claude（推荐）为例：

📖 详细说明: 完整的 API Key 配置方式和优先级说明请参考 API Key 配置完整指南

# WSL2或PowerShell
openclaw models auth add
# 按提示选择 anthropic
# 输入 API Key: sk-ant-xxx

绑定消息渠道

创建Bot：

在Telegram搜索 @BotFather
发送 /newbot 创建机器人
保存Bot Token

配置：

openclaw channels add telegram
openclaw config set channels.telegram.botToken "your-bot-token"
openclaw gateway restart

# 登录WhatsApp（显示二维码）
openclaw channels login whatsapp


# 用手机WhatsApp扫码

企业微信（国内推荐）

# 安装企业微信插件
openclaw plugins install @m1heng-clawd/wework


# 配置
openclaw config set channels.wework '{"enabled":true,"corpId":"xxx","agentSecret":"xxx"}' --json

飞书（国内推荐）

# 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu


# 配置
openclaw config set channels.feishu '{"enabled":true,"appId":"cli_xxx","appSecret":"xxx"}' --json

Windows常用命令速查

系统管理：

命令	功能
openclaw --version	查看版本
openclaw status	查看系统状态
openclaw health	健康检查
openclaw update	更新OpenClaw
openclaw doctor	诊断系统问题

配置管理：

命令	功能
openclaw onboard	初始化向导
openclaw configure	交互式配置
openclaw config get	查看配置项
openclaw config set	修改配置项
openclaw config unset	删除配置项

Linux本地部署

系统要求

推荐发行版：

Ubuntu 20.04+
Debian 11+
CentOS 8+

安装步骤

第一步：安装Node.js

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


# 验证安装
node --version

第二步：安装 OpenClaw

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

第三步：验证安装

openclaw --version

第四步：初始化配置

openclaw onboard