OpenClaw 是一款开源、本地优先的自主 AI 代理与自动化平台,旨在构建个人 AI 操作系统。不同于传统聊天机器人,它能直接控制电脑、执行系统命令、操作文件及浏览器,实现从对话到执行的转变。本文从技术原理出发,详解在 Linux、macOS 及 Windows WSL2 环境下的安装流程,涵盖网关设置、模型选择及安全沙箱配置,并提供性能优化方案。

一、技术原理概览
OpenClaw 采用创新的'微核(Microkernel)+ 插件(Skills/Channels)+ 统一网关(Gateway)'架构。Gateway 作为控制中心(默认 127.0.0.1:18789),所有消息平台和客户端通过 WebSocket 连接。这种设计实现了真正的自动化能力,配合本地优先特性,所有配置、日志和记忆均存储在本地,不上传第三方服务器,隐私完全可控。
其核心优势在于丰富的插件生态,支持 500+ 技能扩展,搭配多模型切换能力,可适配从日常办公自动化到复杂开发辅助的不同场景。
二、系统环境要求
提前确认环境兼容性能有效避免部署问题,具体要求如下:
2.1 硬件配置
- 最低要求:Node.js ≥ 22.x,内存 2GB,存储 1GB。
- 推荐配置:内存 8-16GB,存储 20GB,近 5 年 Intel 或 AMD 处理器。
- 本地模型场景:若需运行本地 AI 模型,建议内存 ≥ 64GB,存储 ≥ 500GB。
2.2 操作系统支持
- macOS:原生支持,体验最佳,无需虚拟化。
- Linux:全面支持,推荐 Ubuntu,适合生产环境。
- Windows:强烈推荐使用 WSL2 环境,原生 Windows 兼容性问题较多。
三、一键安装脚本
官方提供了一键安装脚本,无需手动配置依赖,不同系统命令如下:
3.1 Linux/macOS
curl -fsSL https://openclaw.ai/install.sh | bash
执行后自动完成 Node.js 依赖检查、包下载和基础配置。
3.2 Windows PowerShell
iwr-useb https://openclaw.ai/install.ps1 | iex
注意:Windows 用户需先开启 WSL2,若提示权限不足请右键以管理员身份运行。
四、新手引导向导
安装完成后,运行以下命令启动向导进行核心配置:
openclaw onboard --install-daemon
向导将完成环境自检、守护进程注册及交互式配置。
4.1 网关类型选择
- 本地网关:数据与计算在本机,安全性高,适合隐私优先场景。
- 远程网关:适合团队共用或跨设备访问,需额外配置网络权限。
4.2 认证方式配置
推荐使用 OAuth 方式,自动管理密钥生命周期。若使用 Anthropic Claude,可直接复用本地 CLI 凭证。
4.3 渠道连接设置
支持 WhatsApp、Telegram、Discord 等 20+ 通讯平台。以 WhatsApp 为例:


