安装与配置

📋 系统要求

要求	最低	推荐
Node.js	18.x	20.x+
内存	512MB	2GB+
存储	200MB	1GB+
系统	Windows/macOS/Linux	任意

---

🚀 安装步骤

方法一：使用 npx（推荐新手）

打开终端，运行：

npx openclaw

首次运行会自动安装，然后启动交互界面。

方法二：全局安装

# 使用 npm
npm install -g openclaw

# 或使用 pnpm（更快）
pnpm add -g openclaw

# 或使用 yarn
yarn global add openclaw

安装完成后，运行：

openclaw

方法三：从源码安装

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install

# 运行
pnpm start

---

⚙️ 配置 AI 模型

OpenClaw 需要连接 AI 模型才能工作。支持多种模型：

OpenAI（最简单）

1. 获取 API Key：https://platform.openai.com/api-keys
2. 创建配置文件：

openclaw config set openai.apiKey sk-xxxxx

Claude（推荐）

1. 获取 API Key：https://console.anthropic.com/
2. 配置：

openclaw config set claude.apiKey sk-ant-xxxxx
openclaw config set model claude-3-sonnet

本地模型（免费）

使用 Ollama 运行本地模型：

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 下载模型
ollama pull llama3

# 配置 OpenClaw
openclaw config set model ollama:llama3

---

📁 配置文件位置

OpenClaw 的配置文件位于：

系统	路径
macOS/Linux	~/.openclaw/config.json
Windows	%USERPROFILE%\.openclaw\config.json

手动编辑配置

{
  "model": "claude-3-sonnet",
  "providers": {
    "openai": {
      "apiKey": "sk-xxxxx"
    },
    "claude": {
      "apiKey": "sk-ant-xxxxx"
    }
  },
  "workspace": "~/.openclaw/workspace"
}

---

✅ 验证安装

运行以下命令检查是否安装成功：

openclaw --version
openclaw status

如果看到版本号和状态信息，说明安装成功！

---

🔧 常见问题

Q: 安装时提示权限错误？

# macOS/Linux
sudo npm install -g openclaw

# 或使用 npx（不需要全局安装）
npx openclaw

Q: Windows 上找不到命令？

确保 Node.js 已添加到 PATH，或使用：

npx openclaw

Q: 如何更新 OpenClaw？

npm update -g openclaw
# 或
pnpm update -g openclaw

---

📝 小练习

动手试试

1. 完成安装
2. 运行 openclaw --version 查看版本
3. 运行 openclaw status 检查状态

---

➡️ 下一步

安装完成后，让我们进行 第一次对话！