openclaw龙虾本地部署配置要求

想在本地服务器部署OpenClaw，需要满足特定的软硬件及网络要求。本文将分项详细说明。

一、硬件配置要求

硬件是运行的基础，配置不足可能导致性能瓶颈。

CPU

起点为2个核心。为保证任务处理流畅，建议使用2核或更高配置。

内存

4GB是入门要求，仅够启动。若要运行多技能或复杂任务，建议升级至8GB或以上，以避免内存不足。

存储空间

最低需20GB SSD空间（或确保有2GB可用空间）。为应对系统、依赖及数据增长，建议预留更多空间。

推荐配置：40GB的ESSD云盘，或10GB以上的本地SSD。

二、软件与环境要求

需准备好兼容的操作系统与必要的运行工具。

1. 操作系统

支持主流系统，包括：

• Linux系：Ubuntu 20.04及以上、CentOS 8及以上
• Windows系：Windows 10或11（Win10需启用WSL2）
• macOS：版本12及以上

其中，Ubuntu 22.04 LTS或Windows 11在兼容性和稳定性上表现较佳。

2. Node.js

这是核心运行引擎。最低要求版本为18.0。

推荐使用Node.js v22 LTS（22.0.0及以上），以获得更好的性能与支持。

3. 其他必备工具

• Git：用于代码管理。
• pnpm：包管理器。

对Windows用户而言，提前配置好Git环境是必要前提。

三、网络与核心凭证

部署需确保网络连通，并配置好调用AI能力的关键凭证。

1. 网络端口

OpenClaw默认使用18789端口通信。部署时必须在防火墙中开放此端口。

2. 带宽建议

• 云端部署：公网带宽建议不低于1Mbps（底线要求）。
• 如需频繁使用联网技能（如搜索），则建议准备200Mbps或更高的带宽，以获得流畅体验。

3. 大模型API密钥

这是系统的灵魂所在。你需要：

1. 从支持OpenAI API格式的平台（如Minimax、阿里云百炼、Claude等）获取API Key。
2. 将其准确填入配置文件中。

没有此密钥，OpenClaw无法调用核心AI能力。

四、部署方式说明

根据使用场景，可选择以下部署路径。

1. 云端部署

这是目前最主流便捷的方式。

推荐配置：2vCPU + 4GiB内存 + 40GiB ESSD云盘。

部分云服务商提供预装好OpenClaw的镜像，可实现“开箱即用”。

2. 本地部署

若自有高性能主机或服务器，可在本地部署。前提是满足前文所有软硬件要求。

3. 一键安装脚本

为提升安装效率，官方提供了一键脚本：

• macOS/Linux用户：在终端执行
  curl -fsSL https://openclaw.ai/install.sh | bash
• Windows用户：在PowerShell执行
  iwr -useb https://openclaw.ai/install.ps1 | iex

脚本可自动处理部分依赖，使部署更平滑。

严格按照要求准备环境，是成功部署的关键。