OpenClaw 安装指南
什么是 OpenClaw？
OpenClaw 是一个开源的个人 AI 助手，运行在你自己的设备上。它通过你已经在使用的通信渠道（QQ、Telegram、Discord、WhatsApp 等）与你对话，可以帮你处理消息、执行任务、管理文件。简单说，就是给你一个专属的 AI 管家！这篇文章基本是让ai抄官方文档的，你也可以直接访问官方教程
🚀 推荐安装方式：安装器脚本
OpenClaw 官方推荐使用安装器脚本，这是最快最简单的安装方式：
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
安装器脚本会自动：
- 检测你的操作系统
- 安装 Node.js（如果需要）
- 安装 OpenClaw
- 启动 onboarding 向导
不运行 onboarding 向导
如果你只想安装而不运行向导：
# macOS/Linux/WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
# Windows PowerShell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
📋 系统要求
操作系统
- macOS (推荐)
- Linux (所有主流发行版)
- Windows (原生 Windows 或 WSL2，WSL2 更稳定)
软件要求
- Node.js 24 (推荐) 或 Node.js 22.14+
- npm、pnpm 或 bun 包管理器
- 仅从源码构建时需要
pnpm
🔧 其他安装方法
1. 本地前缀安装器 (install-cli.sh)
当你希望 OpenClaw 和 Node.js 都安装在本地前缀（如 ~/.openclaw）下，不依赖系统级 Node.js：
curl -fsSL https://openclaw.ai/install-cli.sh | bash
支持 npm 安装和 git checkout 安装。
2. 使用包管理器
npm (推荐)
npm install -g openclaw@latest
openclaw onboard --install-daemon
pnpm
pnpm add -g openclaw@latest
pnpm approve-builds -g # 首次安装需要批准构建
openclaw onboard --install-daemon
bun
bun add -g openclaw@latest
openclaw onboard --install-daemon
注意：Bun 仅支持 CLI 安装路径，Gateway 运行时仍推荐使用 Node.js。
3. 从源码安装
适合贡献者或希望从本地 checkout 运行的用户：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
或者跳过 link，直接从仓库内使用 pnpm openclaw ...。
4. 从 GitHub main 分支安装
npm install -g github:openclaw/openclaw#main
验证安装
安装完成后，验证一切正常：
# 确认 CLI 可用
openclaw --version
# 检查配置问题
openclaw doctor
# 验证 Gateway 运行状态
openclaw gateway status
⚙️ 安装后管理
托管启动（推荐）
安装后，设置托管启动以确保 OpenClaw 在系统启动时自动运行：
macOS
通过 LaunchAgent 托管：
openclaw onboard --install-daemon
# 或
openclaw gateway install
Linux/WSL2
通过 systemd 用户服务托管：
openclaw onboard --install-daemon
# 或
openclaw gateway install
原生 Windows
- 首先创建计划任务
- 如果任务创建被拒绝，回退到每用户 Startup 文件夹登录项
手动启动
如果你不想设置托管启动，可以手动启动：
# 启动 Gateway
openclaw gateway start
# 停止 Gateway
openclaw gateway stop
# 查看状态
openclaw gateway status
# 查看日志
openclaw gateway logs --follow
🐛 故障排除
openclaw 命令未找到
如果安装成功但 openclaw 命令不可用：
# 检查 Node.js 是否安装
node -v
# 检查全局包安装位置
npm prefix -g
# 检查 PATH 环境变量
echo "$PATH"
如果 $(npm prefix -g)/bin 不在你的 PATH 中，添加到 shell 启动文件：
# 对于 bash/zsh
export PATH="$(npm prefix -g)/bin:$PATH"
# 然后打开新终端
sharp 构建错误 (npm)
如果 sharp 包因全局安装的 libvips 失败：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
pnpm 构建批准
pnpm 需要对有构建脚本的包进行显式批准：
# 首次安装后运行
pnpm approve-builds -g
Start
1. 运行 onboarding 向导
openclaw onboard
向导会引导你完成：
- 网关设置
- 工作空间配置
- 通信渠道连接
- 技能安装
2. 访问 Web 界面
启动后访问：http://localhost:18789
3. 配置通信渠道
通过配置文件或向导添加：
- QQ 机器人
- Telegram 机器人
- Discord 机器人
- 其他支持的渠道
4. 安装技能(Skills)
# 查看可用技能
openclaw skills list
# 安装技能
openclaw skills install weather
openclaw skills install calendar
💡 实际生产环境配置建议
安全建议
保护配置文件
chmod 600 ~/.openclaw/openclaw.json使用环境变量存储敏感信息
export OPENAI_API_KEY="your-key"定期备份配置
openclaw backup create
性能优化
调整日志级别
openclaw config set logging.level "warn"监控资源使用
openclaw stats
📚 资源链接
- 官方网站: https://openclaw.ai
- 官方文档: https://docs.openclaw.ai
- GitHub 仓库: https://github.com/openclaw/openclaw
- Discord 社区: https://discord.gg/clawd
- 探索技能市场: ClawHub
- 学习技能开发: Skills Guide
- 配置更多渠道: Channels