OpenClaw入门指南：从零开始安装配置

📅 发布日期: 2026年2月24日 ⏱️ 预计时间: 20分钟 🎯 难度: 初级 🆓 类型: 免费教程

🎯 教程目标

通过本教程，你将成功安装OpenClaw并完成基础配置，拥有一个可用的AI助手。

你将完成：

✅ OpenClaw安装
✅ 基础配置设置
✅ 简单功能测试
✅ 问题排查基础

📋 系统要求

操作系统

macOS 10.15+ (推荐)
Linux (Ubuntu/Debian/CentOS)
Windows 10+ (WSL2推荐)

软件要求

Node.js 18.0.0 或更高版本
npm 8.0.0 或更高版本
Git (用于安装和更新)

🚀 安装步骤

步骤1：安装Node.js和npm

macOS (使用Homebrew)

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

# 安装Node.js
brew install node

Linux (Ubuntu/Debian)

# 更新包列表
sudo apt update

# 安装Node.js
sudo apt install nodejs npm

# 验证安装
node --version
npm --version

Windows

下载Node.js安装包从 nodejs.org
运行安装程序，选择"Add to PATH"选项
或使用WSL2安装Ubuntu，然后按Linux步骤操作

步骤2：安装OpenClaw

# 使用npm全局安装OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

如果安装成功，你应该看到类似输出：

openclaw/1.0.0 darwin-arm64 node-v18.17.0

步骤3：初始化配置

# 创建OpenClaw配置目录
mkdir -p ~/.openclaw

# 初始化配置
openclaw init

初始化过程会：

创建默认配置文件
设置工作目录
下载必要资源

⚙️ 基础配置

配置文件位置

OpenClaw的主要配置文件位于：

~/.openclaw/openclaw.json - 主配置文件
~/.openclaw/workspace/ - 工作目录

基本配置示例

打开配置文件进行编辑：

# 使用你喜欢的编辑器
nano ~/.openclaw/openclaw.json

基础配置内容：

{
  "model": "deepseek/deepseek-chat",
  "maxTokens": 2000,
  "temperature": 0.7,
  "workspace": "~/.openclaw/workspace",
  "logLevel": "info"
}

🧪 功能测试

测试1：基础对话

# 启动OpenClaw对话
openclaw chat

输入一些测试问题：

你好，我是谁？
今天天气怎么样？
1+1等于多少？

如果正常回复，说明基础功能正常。

测试2：文件操作

# 创建一个测试文件
echo "测试内容" > ~/.openclaw/workspace/test.txt

# 让OpenClaw读取文件
openclaw chat
# 输入：请读取test.txt文件内容

🔧 常见问题解决

问题1：安装失败

症状: npm install -g openclaw 失败

解决方案:

# 清理npm缓存
npm cache clean --force

# 使用管理员权限安装
sudo npm install -g openclaw

# 或使用nvm管理Node.js版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18
npm install -g openclaw

问题2：命令找不到

症状: openclaw: command not found