OpenClaw 本地部署完整指南（2026 超详细版）

 

本文将详细介绍 OpenClaw 在本地环境部署的完整流程，适用于：

• Mac

• Windows

• Linux

• 本地开发环境

• AI Agent开发测试

 

整个部署流程大约 10-15分钟即可完成。

一、OpenClaw 是什么

 

OpenClaw 是一个 AI Agent 自动化平台，用于构建智能代理系统。

 

类似项目：

• AutoGPT

• OpenDevin

• CrewAI

• LangGraph

 

核心功能：

• AI Agent任务执行

• Skills技能系统

• 多模型支持

• Web管理界面

• API调用

• 自动化工作流

 

常见用途：

• 自动写代码

• 自动写文档

• 自动分析数据

• 自动执行脚本

• AI办公助手

二、本地部署环境要求

推荐配置：

项目	推荐
CPU	4核
内存	8GB
硬盘	10GB
Node	18+
Python	3.10+

 

 

 

 

 

 

 

 

 

 

三、安装基础环境

1 安装 Node.js

推荐使用 Node 18 或 Node 20

 

官网：

https://nodejs.org

检查版本：node -v

2 安装 Python

OpenClaw Agent 依赖 Python。

https://python.org

 

3 安装 Git

下载：https://git-scm.com

 

四、下载 OpenClaw 项目

克隆仓库：

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

进入项目：

cd openclaw

项目结构：

openclaw
 ├── backend
 ├── frontend
 ├── agent
 ├── skills
 ├── configs
 ├── scripts
 └── docker-compose.yml

目录说明：

目录	作用
frontend	Web界面
backend	API服务
agent	AI执行引擎
skills	技能库
configs	配置

 

五、安装项目依赖

安装 Node 依赖

进入 backend：

cd backend

安装依赖：

npm install

返回根目录：

cd ..

安装 frontend 依赖

cd frontend
npm install

安装 Agent Python 依赖

进入 agent：

cd ../agent

创建虚拟环境：

python3 -m venv venv

激活环境：

Mac / Linux

source venv/bin/activate

Windows

venv\Scripts\activate

安装依赖：

pip install -r requirements.txt

六、配置环境变量

复制配置文件：

cp .env.example .env

编辑：

OPENAI_API_KEY=sk-xxxx

LLM_PROVIDER=openai
APP_PORT=3000
API_PORT=8000

如果使用 DeepSeek

OPENAI_BASE_URL=https://api.deepseek.com

如果使用 Claude

ANTHROPIC_API_KEY=xxxx

七、启动数据库（本地）

OpenClaw 需要：

• PostgreSQL

• Redis

推荐使用 Docker。

启动：

docker run -d \
-p 5432:5432 \
-e POSTGRES_PASSWORD=postgres \
postgres

Redis：

docker run -d -p 6379:6379 redis

八、启动 Backend

进入 backend：

cd backend

运行：

npm run dev

成功日志：

Server started at http://localhost:8000

九、启动 Frontend

打开新终端：

cd frontend
运行：
npm run dev
成功：
http://localhost:3000
即可进入 OpenClaw 控制台。

十、启动 Agent 服务

进入 agent：

cd agent

启动：
python main.py
日志：
Agent runtime started

 

十一、安装 Skills

Skills 是 OpenClaw 的能力扩展。

进入 skills 目录：

cd skills

安装官方 skills：
git clone https://github.com/skills/registry

常用 skills

Skill	功能
browser	浏览器操作
filesystem	文件管理
git	Git操作
shell	执行命令
web_search	联网搜索

 

十二、创建第一个 Agent

打开：

http://localhost:3000

进入：Dashboard
点击：Create Agent
填写：Agent名称：AutoDev
描述：自动编程助手
选择 skills：
•filesystem
•git
•shell
保存。

 

十三、测试 Agent

创建任务：

示例任务：

生成一个 Vue3 博客模板

Agent 将自动：

1 搜索资料

2 编写代码

3 执行命令

4 输出结果