从零开始：OpenClaw AI 个人助手完整安装指南

导语：当文字生成工具还在给你建议时，OpenClaw 已经直接为你干活了。这是一位能帮你清空收件箱、发送电子邮件、管理日历的 AI 私人助理——通过你早已在使用的所有聊天应用，如 WhatsApp、Telegram、iMessage、微信等。

什么是 OpenClaw？

OpenClaw（原名 ClawdBot）是一个开源的自主 AI 代理，专为实际工作而构建。与 ChatGPT 等停留在建议阶段的文本生成工具不同，OpenClaw 可以直接：

·✅ 操作你的邮件、文件和网站

·✅ 执行 API 调用和自动化任务

·✅ 通过自然语言接收指令并完成任务

·✅ 在你的硬件上运行，数据完全可控

核心理念：不再是提示 AI，而是让 OpenClaw 为你工作！

适用场景

系统要求

最低配置

·CPU: 2 核

·内存: 8 GB RAM

·存储: 100 GB SSD

·操作系统: macOS / Linux / Windows（需 WSL2）

推荐配置

·CPU: 4 核

·内存: 16 GB RAM

·存储: 500 GB SSD

软件要求

⚠️Windows 用户注意：强烈推荐使用WSL2（Windows Subsystem for Linux 2）运行 OpenClaw，可获得最佳体验。

快速安装指南

方法一：官方安装脚本（推荐）⭐

这是最快捷的方式，适合大多数用户。脚本会自动检测 Node.js 版本、处理依赖关系，并启动配置向导。

macOS / Linux / WSL2

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

Windows PowerShell

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

安装脚本自动执行：

1.检测系统并安装 Node.js（如需要）

2.通过 npm 全局安装 OpenClaw CLI

3.启动配置向导（Onboarding Wizard）

4.询问是否作为后台服务运行

跳过配置向导安装：

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

方法二：NPM 全局安装

如果你已经管理着自己的 Node.js 环境，可以使用这种方式：

npm install -g openclaw@latest

openclaw onboard --install-daemon

pnpm 用户注意：

pnpm add -g openclaw@latest

pnpm approve-builds -g

openclaw onboard --install-daemon

pnpm 需要显式批准带构建脚本的包，安装后运行pnpm approve-builds -g选择列出的包即可。

方法三：从源码构建（开发者）

适合想要深入了解或贡献代码的用户：

git clone https://github.com/openclaw/openclaw.git

cd openclaw

npm install -g pnpm

pnpm install

pnpm approve-builds -g

pnpm build

pnpm run start --onboard

安装后配置向导

安装完成后，运行openclaw onboard会启动交互式配置向导。以下是关键步骤详解：

1️⃣ 为你的 AI 起名字 

问题："What should we call your assistant?"

这是完全个性化的设置！常见的名字选择：

· Lobster Larry（官方吉祥物，有趣好记）

·⚡ Jarvis（钢铁侠风格）

· Alfred（蝙蝠侠管家风）

· Cortana（光环游戏角色）

·或者发挥创意，取一个属于你的独特名字！

2️⃣ 选择 AI 模型 provider 

问题："Which AI provider do you want to use?"

OpenClaw 支持多种 LLM 后端，包括：

·Ollama（本地运行，隐私安全）

·Claude（Anthropic，智能强大）

·GPT-4（OpenAI，综合能力优秀）

·Gemini（Google，多模态能力强）

推荐：对于中文用户，可以考虑 Claude 或 GPT-4，两者在理解力上表现优异。Ollama 适合需要数据隐私的场景。

3️⃣ 连接聊天平台 

你可以将 OpenClaw 连接到各种消息应用：

Telegram（推荐）

1.通过 @BotFather 创建机器人

2.获取 API Token

3.向你的 Bot 发送一条消息

4.批准配对码

微信公众号（中文用户友好）

OpenClaw 支持通过 Feishu/飞书等平台集成微信公众号，实现中国化的使用体验。

其他平台

·WhatsApp

·Discord

·Slack

·iMessage

✅ 验证安装是否成功

运行以下命令检查：

openclaw --version

预期输出示例：

OpenClaw CLI v2026.3.15

如果看到版本号，恭喜你——安装成功！��

启动控制界面

配置完成后，可以通过以下方式使用 OpenClaw：

方式一：打开 Web 控制面板

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789/

方式二：启动后台服务（守护进程）

openclaw onboard --install-daemon

这会注册 OpenClaw 作为后台服务（Linux 使用 systemd，macOS 使用 launchd），确保重启后依然运行。

故障排查

❌ 问题：命令找不到command not found: openclaw

原因：npm 全局 bin 目录未添加到 PATH 环境变量。

解决方案：

macOS / Linux

# 将以下行添加到 ~/.zshrc 或 ~/.bashrc

export PATH="$(npm prefix -g)/bin:$PATH"

# 重新加载配置

source ~/.zshrc # 或 source ~/.bashrc

Windows

# 添加 npm 全局路径到环境变量

$npmPath = $(npm prefix -g) + "\bin"

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$npmPath", "User")

然后重新打开终端。

❌ 问题：sharp 包安装失败

错误信息：sharp: Please add node-gyp to your dependencies

解决方案：

# macOS（安装 Xcode CLT）

xcode-select --install

# 或者强制使用预编译二进制文件

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

❌ 问题：VPS 内存不足导致安装中断

场景：2GB 以下 RAM 的 VPS，npm 安装时 OOM（Out of Memory）

解决方案：创建交换文件

# 分配 4GB 交换空间

sudo fallocate -l 4G /swapfile

sudo chmod 600 /swapfile

sudo mkswap /swapfile

sudo swapon /swapfile

# 使交换永久生效

echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

更新与卸载

更新 OpenClaw

openclaw onboard --install-daemon

这会自动拉取最新版本并重新启动服务。

卸载 OpenClaw

# 通过 npm 卸载

npm uninstall -g openclaw

# 停止并移除后台服务（如已安装）

systemctl stop openclaw # Linux

launchctl unload ~/Library/LaunchAgents/openclaw.plist # macOS

性能优化建议

对于低配 VPS

·必须创建交换文件，防止内存不足

·优先使用轻量级模型（如 Ollama 中的小型模型）

·定期清理日志文件释放空间

对于本地部署

·将~/.openclaw目录放在 SSD 上提升性能

·监控 Node.js 进程内存占用

·考虑使用 pnpm 替代 npm，安装更快、占用更少磁盘空间

进阶玩法：ClawHub 技能库

安装完成后，可以通过ClawHub扩展 OpenClaw 的能力：

# 查看可用的技能

openclaw skills list

# 安装特定技能（如图像处理、数据分析等）

openclaw skills install image-processor

openclaw skills install data-analyzer

热门技能推荐：

·image-generator- AI 图像生成

·markdown-converter- Markdown/HTML 互转

·wechat-poster- 微信公众号发布

·web-researcher- 深度网页研究

实战应用场景

场景一：IoT 设备告警推送（物联网架构师专用）

OpenClaw 可连接你的 IoT 平台，当监测到异常情况时自动通过微信/Telegram 发送告警：

# 配置消息通知

openclaw configure --section channels

# 测试告警推送

openclaw message send --channel telegram --target "+1234567890" \

--message "⚠️ 设备 BMS 异常：电池电压过高，请立即检查！"

场景二：技术文档自动化生成

利用 OpenClaw 的联网研究能力，自动生成竞品分析报告或技术白皮书初稿。

场景三：社交媒体内容发布

通过集成的技能，一键将 Markdown 文章发布到微信公众号、微博等平台。

官方资源

常见问题 FAQ

Q: OpenClaw 安全吗？数据会泄露吗？

A: OpenClaw 运行在你的本地硬件或你控制的服务器上，所有数据都在你的掌控之中。开源项目代码透明，无后门风险。

Q: 需要月费订阅吗？

A: OpenClaw 本身完全免费！你只需支付 AI 模型 provider 的费用（如使用 GPT-4、Claude 等），或本地运行则零成本。

Q: 如何从其他系统迁移数据？

A: OpenClaw 的配置都在~/.openclaw目录下，复制该目录到新机器并运行openclaw onboard即可迁移。

Q: 支持中文吗？

A: 完全支持！OpenClaw 界面和命令均支持中文输入，推荐搭配 Claude 或 GPT-4 获得更好的中文理解能力。

开始你的 AI 助理之旅

恭喜你完成了 OpenClaw 的安装！现在你已经拥有了一个能真正为你干活的智能助手。

下一步建议：

1.✅ 在 Web 控制面板中浏览各个功能模块

2.✅ 尝试让 OpenClaw 执行简单任务（如搜索信息、生成报告）

3.✅ 探索 ClawHub，安装适合你工作流的技能

4.✅ 加入 Discord 社区，与其他用户交流使用经验

记住：OpenClaw 越用越聪明，从今天开始，让它成为你最得力的数字伙伴！