OpenClaw 本地部署完整指南

从零开始，在 macOS 和 Windows 上部署你的专属 AI 助手

00 前言

OpenClaw 是一个本地优先的个人 AI 助手，你可以在自己的设备上运行它，完全掌控自己的数据和隐私。

为什么选择本地部署？

• 🔒 隐私安全：数据不上传到第三方服务器
• 💰 成本可控：使用自己的 API Key，按需付费
• ⚡ 响应快速：本地运行，无网络延迟
• 🛠️ 高度定制：自由选择模型、技能、渠道

01 系统要求

通用要求

各系统特别说明

macOS：

• 支持 Intel 和 Apple Silicon (M1/M2/M3)
• 有官方 macOS 菜单栏应用

Windows：

• 强烈推荐使用 WSL2（Windows Subsystem for Linux）
• 原生 PowerShell 也支持，但功能更完整的是 WSL2

02 macOS 部署指南

方式一：一键安装脚本（推荐）

打开终端，运行：

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

安装完成后，运行入门向导：

openclaw onboard --install-daemon

这会自动：

• 安装 Gateway 服务
• 配置认证信息
• 设置开机自启

方式二：npm 安装

如果你已经安装了 Node.js：

npm install -g openclaw@latest

然后运行入门向导：

openclaw onboard --install-daemon

验证安装

# 查看 Gateway 状态openclaw gateway status# 打开控制面板openclaw dashboard

macOS 专属：菜单栏应用

OpenClaw 提供了原生的 macOS 菜单栏应用，可以：

• 快速查看 Gateway 状态
• 一键启动/停止
• 快捷访问控制面板

从 GitHub Releases 下载 DMG 安装即可。

03 Windows 部署指南

方式一：WSL2（强烈推荐）

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

步骤 1：安装 WSL2

以管理员身份打开 PowerShell：

wsl --install

这会自动安装 Ubuntu。安装完成后重启电脑。

步骤 2：进入 WSL2

重启后，打开「Ubuntu」应用或在 PowerShell 中输入：

wsl

步骤 3：安装 Node.js

在 WSL2 中：

# 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bashsource ~/.bashrc# 安装 Node.js 24nvm install 24nvm use 24

步骤 4：安装 OpenClaw

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

步骤 5：运行入门向导

openclaw onboard --install-daemon

方式二：PowerShell 原生安装

如果不想用 WSL2，也可以用 PowerShell：

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

然后运行：

openclaw onboard --install-daemon

注意： PowerShell 版本功能可能不如 WSL2 完整。

验证安装

# 查看 Gateway 状态openclaw gateway status# 打开控制面板openclaw dashboard

04 配置 AI 模型

OpenClaw 支持多种 AI 模型提供商：

OpenAI（ChatGPT）

openclaw config set models.default openai/gpt-4o

需要在 Onboarding 时登录 OpenAI 账号。

Anthropic（Claude）

openclaw config set models.default anthropic/claude-sonnet-4

其他支持的模型

• Google Gemini
• 通义千问 (Qwen)
• DeepSeek
• 本地模型 (Ollama)

05 连接聊天渠道

OpenClaw 支持众多聊天平台：

飞书

openclaw channels add --channel feishu

Telegram

openclaw channels add --channel telegram

Discord

openclaw channels add --channel discord

WhatsApp

openclaw channels login --channel whatsapp

06 常用命令速查

07 常见问题

Q: Gateway 启动失败？

# 检查端口占用lsof -i :18789# 强制启动openclaw gateway --force

Q: Node.js 版本不对？

# 检查版本node --version# 使用 nvm 切换nvm install 24nvm use 24

Q: Windows 上 WSL2 报错？

# 重置 WSLwsl --shutdownwsl --unregister Ubuntuwsl --install

Q: 如何更新？

npm update -g openclawopenclaw doctor

08 下一步

部署完成后，你可以：

1. 安装技能：访问 https://clawhub.com^[1]
2. 阅读文档：https://docs.openclaw.ai^[2]
3. 加入社区：https://discord.com/invite/clawd^[3]

09 资源链接

• 官网：https://openclaw.ai^[4]
• GitHub：https://github.com/openclaw/openclaw^[5]
• 文档：https://docs.openclaw.ai^[6]
• 技能市场：https://clawhub.ai^[7]
• Discord：https://discord.com/invite/clawd^[8]

OpenClaw - 你的专属 AI 助手，本地运行，隐私安全 🦞

引用链接