OpenClaw本地部署完整教程

📅 2025-01-15 ⏱ 阅读约15分钟中等难度 AI助手

一、环境准备

在部署OpenClaw之前，需要确保你的系统满足以下基本要求：

1.1 系统要求

项目	最低要求	推荐配置
操作系统	Windows 10 / macOS / Ubuntu 20.04	Windows 11 / macOS 14 / Ubuntu 22.04
内存	4GB	8GB+
磁盘空间	2GB	10GB+
网络	需访问OpenAI API（或代理）	稳定网络连接

1.2 安装 Node.js 18+

OpenClaw基于Node.js运行，请确保已安装Node.js 18或更高版本：

# 检查Node.js版本
node -v
# 应输出 v18.x.x 或更高

# 如果未安装，推荐使用 nvm 安装
# macOS/Linux:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18

# Windows: 从 https://nodejs.org 下载安装包

1.3 安装 Git

# 检查Git是否已安装
git --version

# 未安装则从 https://git-scm.com 下载

1.4 准备 API Key

💡 提示：你需要至少一个AI模型的API Key。推荐使用OpenAI（GPT-4）或Anthropic（Claude）的API Key。

获取API Key的方式：

OpenAI：https://platform.openai.com/api-keys
Anthropic：https://console.anthropic.com/

二、安装步骤

2.1 下载安装

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

# 安装依赖
npm install

# 初始化配置
npm run init

2.2 配置环境变量

复制示例配置文件并填入你的API Key：

# 复制配置模板
cp .env.example .env

# 编辑 .env 文件，填入你的API Key
# OPENAI_API_KEY=sk-your-key-here
# ANTHROPIC_API_KEY=sk-ant-your-key-here

⚠️ 注意：切勿将API Key提交到Git仓库或公开分享。

三、配置AI模型

OpenClaw支持多种AI模型，你可以在配置文件中进行设置：

# .env 文件中的模型配置示例
AI_MODEL=gpt-4o          # 默认模型
AI_MODEL_FALLBACK=claude-sonnet-4-20250514  # 备用模型
AI_MAX_TOKENS=4096       # 最大输出token数
AI_TEMPERATURE=0.7       # 温度参数

四、启动运行

# 开发模式启动
npm run dev

# 生产模式启动
npm run start

# 查看运行状态
npm run status

启动成功后，默认访问地址为 http://localhost:3000。

五、常用命令速查

命令	说明
`npm run dev`	开发模式启动（热重载）
`npm run start`	生产模式启动
`npm run stop`	停止服务
`npm run restart`	重启服务
`npm run status`	查看运行状态
`npm run update`	更新到最新版本
`npm run logs`	查看运行日志

💡 提示：如遇问题，可查看 logs/ 目录下的日志文件获取详细错误信息。

← 返回部署教程列表下一篇：CofmyUI本地部署 →