🚀 OpenClaw 完全安装指南 - 小白入门教程

适用于 Windows、Linux、macOS 用户 版本：2026 年 3 月更新

📋 目录

1. 什么是 OpenClaw？
2. 安装前准备
3. Windows 安装教程
4. Linux 安装教程
5. macOS 安装教程
6. 常用指令大全
7. 技能安装指南
8. 常见问题解答

什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手框架，让你可以：

• 🤖 拥有自己的 AI 助手
• 📦 安装各种技能（搜索、天气、文件管理等）
• 💬 通过微信、Telegram、Discord 等聊天
• 🖥️ 控制电脑、浏览器、摄像头等设备
• 🧠 拥有长期记忆和个性化配置

安装前准备

系统要求

必须安装的软件

所有系统都需要：

• Node.js (v18 或更高版本)
• Git (用于克隆技能仓库)

检查是否已安装：

# 检查 Node.js 版本
node -v

# 检查 npm 版本
npm -v

# 检查 Git 版本
git --version

Windows 安装教程

步骤 1：安装 Node.js

1. 访问 nodejs.org
2. 下载 LTS 版本 (长期支持版)
3. 双击安装包，一路点击 “Next”
4. 安装完成后，打开 命令提示符 或 PowerShell
5. 验证安装：

   node -v
   npm -v
   

步骤 2：安装 Git

1. 访问 git-scm.com
2. 下载 Windows 版本
3. 运行安装程序，使用默认选项
4. 验证安装：

   git --version
   

步骤 3：安装 OpenClaw

打开 PowerShell (以管理员身份运行)，输入：

# 全局安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

步骤 4：初始化工作区

# 创建工作区（默认在用户目录）
openclaw init

# 工作区位置：C:\Users\你的用户名\.openclaw\workspace

步骤 5：启动 OpenClaw

# 启动 Web 界面
openclaw web

# 或启动网关服务
openclaw gateway start

步骤 6：配置（可选）

# 配置 API 密钥
openclaw configure

# 配置网络搜索
openclaw configure --section web

Linux 安装教程

步骤 1：更新系统

# Ubuntu/Debian
sudo apt update
sudo apt upgrade -y

# CentOS/RHEL
sudo yum update -y

步骤 2：安装 Node.js

方法 A：使用包管理器 (Ubuntu 20.04+)

# 安装 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

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

# 验证
node -v
npm -v

方法 B：使用 nvm (推荐)

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载配置
source ~/.bashrc

# 安装最新 LTS 版本
nvm install --lts

# 验证
node -v
npm -v

步骤 3：安装 Git

# Ubuntu/Debian
sudo apt install -y git

# CentOS/RHEL
sudo yum install -y git

# 验证
git --version

步骤 4：安装 OpenClaw

# 全局安装
sudo npm install -g openclaw

# 验证
openclaw --version

步骤 5：初始化工作区

# 初始化
openclaw init

# 工作区位置：~/.openclaw/workspace

步骤 6：启动服务

# 启动 Web 界面
openclaw web

# 或后台启动网关
openclaw gateway start

macOS 安装教程

步骤 1：安装 Homebrew (如果没有)

# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 验证
brew --version

步骤 2：安装 Node.js

# 使用 Homebrew 安装
brew install node

# 验证
node -v
npm -v

步骤 3：安装 Git

# 使用 Homebrew 安装
brew install git

# 验证
git --version

步骤 4：安装 OpenClaw

# 全局安装
sudo npm install -g openclaw

# 验证
openclaw --version

步骤 5：初始化工作区

# 初始化
openclaw init

# 工作区位置：~/.openclaw/workspace

步骤 6：启动服务

# 启动 Web 界面
openclaw web

# 或后台启动网关
openclaw gateway start

常用指令大全

🔧 基础指令

# 查看版本
openclaw --version

# 查看帮助
openclaw --help
openclaw <命令> --help

# 查看状态
openclaw status

🚀 网关管理

# 启动网关服务
openclaw gateway start

# 停止网关
openclaw gateway stop

# 重启网关
openclaw gateway restart

# 查看网关状态
openclaw gateway status

🌐 Web 界面

# 启动 Web 界面
openclaw web

# 指定端口
openclaw web --port 3000

⚙️ 配置管理

# 打开配置编辑器
openclaw configure

# 配置特定部分
openclaw configure --section web
openclaw configure --section messaging
openclaw configure --section ai

# 查看配置
openclaw config show

📦 技能管理

# 列出已安装技能
openclaw skills list

# 安装技能（从 GitHub）
openclaw skill install <GitHub-URL>

# 卸载技能
openclaw skill uninstall <技能名>

# 启用/禁用技能
openclaw skill enable <技能名>
openclaw skill disable <技能名>

🧠 会话管理

# 列出会话
openclaw sessions list

# 查看会话历史
openclaw sessions history <会话 ID>

# 创建新会话
openclaw sessions spawn --task "任务描述"

# 发送消息到会话
openclaw sessions send --session <会话 ID> --message "消息内容"

📁 工作区管理

# 打开工作区
openclaw workspace open

# 工作区路径
openclaw workspace path

🔍 搜索和记忆

# 搜索记忆
openclaw memory search "关键词"

# 查看记忆
openclaw memory get <路径>

🌐 网络工具

# 网页搜索
openclaw web search "关键词"

# 抓取网页内容
openclaw web fetch <URL>

📱 消息工具

# 发送消息
openclaw message send --channel <渠道> --message "内容"

# 广播消息
openclaw message broadcast --message "内容"

🖥️ 浏览器控制

# 启动浏览器
openclaw browser start

# 打开网页
openclaw browser open <URL>

# 截图
openclaw browser screenshot

# 关闭浏览器
openclaw browser stop

📷 节点设备

# 列出节点
openclaw nodes list

# 节点状态
openclaw nodes status

# 发送通知
openclaw nodes notify --title "标题" --body "内容"

🎙️ 语音合成

# 文字转语音
openclaw tts "要转换的文字"

技能安装指南

方法 1：从 GitHub 安装

# 克隆技能仓库
cd ~/.openclaw/workspace
git clone https://github.com/用户名/技能名.git

# 复制到技能目录
cp -r 技能名 ~/.openclaw/skills/

# 或使用 openclaw 命令
openclaw skill install https://github.com/用户名/技能名.git

方法 2：从本地安装

# 复制本地技能包
cp -r /路径/到/技能文件夹 ~/.openclaw/skills/技能名

# Windows PowerShell
xcopy /E /I /Y "C:\路径\到\技能" "C:\Users\用户名\AppData\Roaming\npm\node_modules\openclaw\skills\技能名"

方法 3：从 ClawHub 安装

1. 访问 clawhub.ai
2. 浏览技能市场
3. 点击技能页面的 “安装” 按钮
4. 按照提示完成安装

已安装的热门技能

常见问题解答

❓ 安装失败怎么办？

问题：npm install -g openclaw 失败

解决方案：

# Windows (以管理员身份运行 PowerShell)
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
npm install -g openclaw --force

# Linux/macOS
sudo npm install -g openclaw --unsafe-perm

❓ 找不到 openclaw 命令？

问题： 输入 openclaw 提示 “command not found”

解决方案：

# 检查 npm 全局路径
npm config get prefix

# Windows: 添加到 PATH
# C:\Users\用户名\AppData\Roaming\npm

# Linux/macOS: 添加到 ~/.bashrc 或 ~/.zshrc
export PATH=$PATH:$(npm config get prefix)/bin
source ~/.bashrc

❓ 网关启动失败？

问题：openclaw gateway start 失败

解决方案：

# 检查端口占用
# Windows
netstat -ano | findstr :8080

# Linux/macOS
lsof -i :8080

# 更换端口
openclaw gateway start --port 3000

# 查看日志
openclaw gateway logs

❓ 技能无法加载？

问题： 技能安装后无法使用

解决方案：

# 检查技能目录结构
ls ~/.openclaw/skills/技能名/

# 必须有 SKILL.md 文件
# 重启网关
openclaw gateway restart

❓ 如何重置配置？

# 备份配置
cp ~/.openclaw/config.json ~/.openclaw/config.json.bak

# 删除配置（会重新生成默认配置）
rm ~/.openclaw/config.json

# Windows PowerShell
Remove-Item "$env:APPDATA\openclaw\config.json"

❓ 如何卸载 OpenClaw？

# 卸载 npm 包
npm uninstall -g openclaw

# 删除工作区（谨慎！会删除所有数据）
rm -rf ~/.openclaw

# Windows PowerShell
Remove-Item -Recurse -Force "$env:APPDATA\openclaw"

🎯 快速开始 - 5 分钟上手

# 1. 安装（选择你的系统）
npm install -g openclaw

# 2. 初始化
openclaw init

# 3. 启动
openclaw web

# 4. 打开浏览器访问
# http://localhost:8080

# 5. 开始对话！

💡 小贴士

1. 定期更新
   : npm update -g openclaw
2. 备份配置
   : 定期备份 ~/.openclaw/config.json
3. 技能管理
   : 只安装需要的技能，避免资源浪费
4. 安全第一
   : 不要随意安装来源不明的技能
5. 社区贡献
   : 欢迎提交 Issue 和 Pull Request

祝你使用愉快！🎉

如有问题，欢迎在社区提问或查看官方文档。