OpenClaw 安装教程：从零开始搭建你的 AI 助手

共计 2042 个字符，预计需要花费 6 分钟才能阅读完成。

什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手平台，让你可以在自己的设备上运行 AI 代理。它支持多种 AI 模型，可以连接各种工具和服务，打造属于你的个性化 AI 助手。

相比其他 AI 服务，OpenClaw 的优势在于：

• 数据隐私：所有数据保存在本地，不上传云端
• 高度可定制：支持自定义技能、工具和工作流
• 多模型支持：可切换不同的 AI 模型
• 开源免费：完全免费，代码透明

安装前准备

系统要求

• 操作系统：Windows 10/11、macOS、Linux
• 内存：至少 4GB RAM（推荐 8GB）
• 存储：至少 2GB 可用空间
• 网络：需要联网下载依赖

需要安装的软件

1. Node.js（版本 18 或更高）
2. Git（用于克隆代码）

第一步：安装 Node.js

Windows 用户

1. 访问 Node.js 官网：https://nodejs.org
2. 下载 LTS 版本（长期支持版）
3. 双击安装包，一路点击”下一步”
4. 安装完成后，打开命令提示符（CMD）或 PowerShell
5. 输入以下命令验证安装：

node -v
npm -v

如果显示版本号，说明安装成功。

macOS 用户

1. 打开终端（Terminal）
2. 安装 Homebrew（如果还没有）：

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

3. 使用 Homebrew 安装 Node.js：

brew install node

4. 验证安装：

node -v
npm -v

Linux 用户

以 Ubuntu/Debian 为例：

# 更新软件包列表
sudo apt update

# 安装 Node.js
sudo apt install nodejs npm

# 验证安装
node -v
npm -v

第二步：安装 Git

Windows 用户

1. 访问 Git 官网：https://git-scm.com/download/win
2. 下载并安装
3. 安装时保持默认选项即可

macOS 用户

brew install git

Linux 用户

sudo apt install git

第三步：下载 OpenClaw

1. 打开终端（Windows 用 PowerShell，macOS/Linux 用 Terminal）
2. 选择一个目录存放 OpenClaw，例如桌面：

# Windows
cd Desktop

# macOS/Linux
cd ~/Desktop

3. 克隆 OpenClaw 仓库：

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

4. 进入项目目录：

cd openclaw

第四步：安装依赖

在项目目录中运行：

npm install

这个过程可能需要几分钟，取决于你的网络速度。请耐心等待。

第五步：配置 OpenClaw

1. 复制配置文件模板：

cp config.example.json config.json

2. 编辑配置文件：

# Windows
notepad config.json

# macOS
open -e config.json

# Linux
nano config.json

3. 在配置文件中添加你的 AI 模型 API 密钥（以 OpenAI 为例）：

{
  "models": {
    "openai": {
      "apiKey": "你的 OpenAI API 密钥"
    }
  }
}

提示：如果没有 API 密钥，可以先使用本地模型（如 Ollama）。

第六步：启动 OpenClaw

运行以下命令启动：

npm start

如果一切正常，你会看到类似这样的输出：

OpenClaw is running on http://localhost:3000

现在打开浏览器，访问 http://localhost:3000，就能看到 OpenClaw 的界面了！

第七步：配置本地模型（可选）

如果你想使用免费的本地模型，可以安装 Ollama：

1. 访问 https://ollama.ai 下载安装
2. 下载一个模型（以 Llama 2 为例）：

ollama pull llama2

3. 在 OpenClaw 配置中添加：

{
  "models": {
    "ollama": {
      "baseUrl": "http://localhost:11434",
      "model": "llama2"
    }
  }
}

常见问题

1. 启动时报错 “port already in use”

说明 3000 端口被占用，修改配置文件中的端口：

{
  "port": 3001
}

2. 无法连接 AI 模型

检查 API 密钥是否正确，网络是否通畅。

3. 安装依赖很慢

可以切换 npm 镜像源：

npm config set registry https://registry.npmmirror.com

下一步

安装完成后，你可以：

• 探索内置的技能和工具
• 配置更多 AI 模型
• 创建自定义工作流
• 接入各种外部服务

更多高级用法请参考官方文档：https://docs.openclaw.ai

祝你使用愉快！如果有问题，欢迎在评论区留言交流。