OpenClaw专栏第三篇：环境搭建前的准备工作清单（保姆级避坑指南）
📌 目录导航
- ⚠️ 重要提醒：搭建前必读
- 💻 硬件配置要求详解（含性价比推荐）
- 🖥️ 操作系统选择指南（Windows/Linux/macOS对比）
- 📦 依赖软件清单（版本号+下载地址）
- 🌐 网络环境准备（端口/防火墙/代理）
- 🔑 账号与密钥准备（OpenAI/Claude/Ollama）
- 📋 完整检查清单（打印版）
- 💡 下期预告：Windows系统保姆级安装教程
⚠️ 重要提醒：搭建前必读
🚨 新手常见误区
表格
| 误区 | 正确做法 | 后果 |
|---|---|---|
| 直接开始安装，不做准备 | 先对照本清单逐项检查 | 安装失败、中途卡住 |
| 使用过时的软件版本 | 严格按照推荐版本安装 | 兼容性问题、报错频出 |
| 忽略网络环境检查 | 提前测试网络连接 | 下载失败、连接超时 |
| 随意选择硬件配置 | 根据实际需求选择 | 性能不足或资源浪费 |
📊 本篇价值
✅ 节省时间：避免因准备不足导致的反复折腾
✅ 降低门槛：即使是零基础小白也能顺利搭建
✅ 提高成功率：按照清单操作，安装成功率99%+
✅ 避免踩坑：提前规避90%的常见问题
💻 硬件配置要求详解（含性价比推荐）
📋 最低配置要求（仅测试用）
表格
| 组件 | 最低要求 | 说明 |
|---|---|---|
| CPU | 双核 2.0GHz | 仅支持基础功能 |
| 内存 | 2GB RAM | 多任务会卡顿 |
| 存储 | 10GB 可用空间 | 仅够安装基础环境 |
| 网络 | 10Mbps | 下载速度慢 |
⚠️ 警告：最低配置仅适合测试，不推荐生产环境使用！
✅ 推荐配置（流畅运行）
表格
| 组件 | 推荐配置 | 适用场景 |
|---|---|---|
| CPU | 四核 3.0GHz+ | 多任务并发处理 |
| 内存 | 8GB RAM | 流畅运行+基础模型 |
| 存储 | 50GB SSD | 模型缓存+日志存储 |
| 网络 | 100Mbps | 快速下载依赖 |
性价比推荐硬件：
- 🖥️ 台式机：Intel i5-12400 / AMD Ryzen 5 5600X
- 💻 笔记本：联想ThinkPad E14 / 戴尔灵越14
- 🍎 Mac：MacBook Air M1（8GB+256GB）
🚀 高性能配置（专业开发/模型训练）
表格
| 组件 | 高性能配置 | 适用场景 |
|---|---|---|
| CPU | 八核 3.5GHz+ | 复杂任务处理 |
| 内存 | 16GB+ RAM | 大模型运行 |
| GPU | NVIDIA RTX 3060+ | 本地模型加速 |
| 存储 | 256GB NVMe SSD | 大量模型存储 |
| 网络 | 1Gbps | 高速数据传输 |
专业级推荐硬件：
- 🖥️ 工作站：联想ThinkStation P360 / 戴尔Precision 3660
- 🍎 Mac Pro：MacBook Pro M2 Pro（16GB+512GB）
- 📱 服务器：树莓派5（8GB版）- 7×24小时运行
🌟 2026年最佳性价比方案推荐
方案一：入门级（预算<2000元）
✅ 树莓派5（8GB） + 64GB SD卡 + 散热套件
💰 总成本：约1800元
🎯 适用场景：轻量级自动化任务、个人助手
💡 优势：功耗低、静音、可7×24小时运行
⚠️ 注意：需要搭配云API使用（本地模型性能有限）方案二：标准级（预算3000-5000元）
✅ 二手Mac mini M1（8GB+256GB）
💰 总成本：约3500元
🎯 适用场景：日常办公自动化、文件处理
💡 优势：性能稳定、macOS生态完善
⚠️ 注意：需自行安装系统方案三：高性能级（预算5000-8000元）
✅ 全新联想ThinkPad E14 Gen 5（i5-1340P/16GB/512GB）
💰 总成本：约6500元
🎯 适用场景：开发测试、本地模型运行
💡 优势：扩展性强、维护方便
⚠️ 注意：需要额外配置GPU（可选）🖥️ 操作系统选择指南（Windows/Linux/macOS对比）
📊 三大系统对比表
表格
特性 Windows Linux macOS
安装难度 ⭐⭐⭐ 简单 ⭐⭐⭐⭐ 需基础 ⭐⭐⭐ 简单
兼容性 ⭐⭐⭐⭐ 优秀 ⭐⭐⭐⭐⭐ 最佳 ⭐⭐⭐⭐ 优秀
性能表现 ⭐⭐⭐ 良好 ⭐⭐⭐⭐⭐ 最优 ⭐⭐⭐⭐ 优秀
资源占用 ⭐⭐ 较高 ⭐⭐⭐⭐ 低 ⭐⭐⭐ 中等
社区支持 ⭐⭐⭐ 良好 ⭐⭐⭐⭐⭐ 最强 ⭐⭐⭐ 良好
推荐指数 ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐
🪟 Windows系统（适合新手）
支持版本
✅ Windows 11（64位，推荐）
✅ Windows 10（2004+版本）
❌ 不支持Windows 7/8
优势
🎯 图形化操作，上手快
📦 软件生态丰富
🛠️ 问题解决资源多
劣势
🔋 资源占用较高
🐌 性能略逊于Linux
🔒 需要激活正版
🐧 Linux系统（推荐开发者）
推荐发行版
✅ Ubuntu 22.04 LTS（最稳定）
✅ Debian 12（最纯净）
✅ CentOS Stream 9（企业级）
优势
⚡ 性能最优，资源占用低
🆓 完全免费，开源生态
🔧 高度可定制化
📈 适合7×24小时运行
劣势
📚 需要基础命令行知识
🖥️ 图形界面可选（非必需）
🍎 macOS系统（适合苹果用户）
支持版本
✅ macOS Sonoma 14+（推荐）
✅ macOS Ventura 13+
✅ M系列芯片（M1/M2/M3）
✅ Intel芯片（2015年后机型）
优势
🎨 界面美观，体验流畅
🔋 续航优秀（笔记本）
🚀 M系列芯片性能强劲
📱 与iOS生态无缝衔接
劣势
💰 硬件成本高
🔧 部分软件需适配
📦 依赖软件清单（版本号+下载地址）
🔧 核心依赖（必须安装）
. Python（推荐3.10+）
# 推荐版本：Python 3.10.12 / 3.11.8 / 3.12.3
# 下载地址：
# - 官方：https://www.python.org/downloads/
# - 镜像：https://mirrors.tuna.tsinghua.edu.cn/python/
# 安装后验证：
python --version
# 应显示：Python 3.10.12 或更高版本
pip --version
# 应显示：pip 23.0+ 或更高版本安装要点：
- ✅ 勾选"Add Python to PATH"
- ✅ 选择"Customize installation"
- ✅ 安装pip和IDLE（可选）
2. Node.js（推荐22.0.0+）
# 推荐版本：Node.js 22.0.0 LTS 或更高
# 下载地址：
# - 官方：https://nodejs.org/
# - 镜像：https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/
# 安装后验证：
node -v
# 应显示：v22.0.0 或更高版本
npm -v
# 应显示：10.5.0+ 或更高版本安装要点：
✅ 下载LTS版本（长期支持）
✅ 自动安装npm
✅ 验证环境变量配置
. Git（版本控制工具）
# 推荐版本：Git 2.40+
# 下载地址：
# - 官方：https://git-scm.com/
# - 镜像：https://mirrors.tuna.tsinghua.edu.cn/git/
# 安装后验证：
git --version
# 应显示：git version 2.40.0 或更高版本安装要点：
✅ 选择默认编辑器（推荐VS Code）
✅ 配置SSH密钥（后续需要）
✅ 设置用户名和邮箱
🐳 可选依赖（按需安装）
Docker（容器化部署）
# 推荐版本：Docker Desktop 4.25+ / Docker Engine 24.0+
# 下载地址：
# - 官方：https://www.docker.com/products/docker-desktop
# - 镜像：国内可使用阿里云镜像加速
# 安装后验证：
docker --version
# 应显示：Docker version 24.0.0 或更高版本
docker-compose --version
# 应显示：Docker Compose version v2.20.0 或更高版本适用场景：
✅ 快速部署，避免环境冲突
✅ 多版本测试
✅ 生产环境部署
. Visual Studio Code（代码编辑器）
# 推荐版本：VS Code 1.85+
# 下载地址：https://code.visualstudio.com/
# 推荐插件：
# - Python（Microsoft）
# - Pylance
# - Docker
# - GitLens
# - Remote - SSH. Ollama（本地大模型运行）
# 推荐版本：Ollama 0.1.34+
# 下载地址：https://ollama.com/download
# 支持：Windows / macOS / Linux
# 安装后验证：
ollama --version
# 应显示：ollama version 0.1.34 或更高版本适用场景：
- ✅ 本地运行大模型（无需API）
- ✅ 隐私保护需求
- ✅ 离线使用
📋 完整依赖清单表格
表格
| 软件 | 必需性 | 推荐版本 | 下载地址 | 验证命令 |
|---|---|---|---|---|
| Python | ⭐⭐⭐ 必需 | 3.10.12+ | 官网 | python --version |
| Node.js | ⭐⭐⭐ 必需 | 22.0.0+ | 官网 | node -v |
| Git | ⭐⭐⭐ 必需 | 2.40.0+ | 官网 | git --version |
| Docker | ⭐⭐ 推荐 | 24.0.0+ | 官网 | docker --version |
| VS Code | ⭐⭐ 推荐 | 1.85+ | 官网 | 手动验证 |
| Ollama | ⭐ 可选 | 0.1.34+ | 官网 | ollama --version |
🌐 网络环境准备（端口/防火墙/代理）
🚪 必需端口清单
表格
| 端口 | 用途 | 协议 | 是否必需 |
|---|---|---|---|
| 7860 | OpenClaw WebUI | TCP | ⭐⭐⭐ 必需 |
| 8000 | API服务 | TCP | ⭐⭐ 推荐 |
| 22 | SSH远程访问 | TCP | ⭐⭐ 推荐 |
| 443 | HTTPS加密 | TCP | ⭐ 可选 |
| 80 | HTTP访问 | TCP | ⭐ 可选 |
🔥 防火墙配置
Windows防火墙
# 以管理员身份运行PowerShell
# 允许OpenClaw端口
New-NetFirewallRule -DisplayName "OpenClaw WebUI" -Direction Inbound -Protocol TCP -LocalPort 7860 -Action Allow
# 允许API端口
New-NetFirewallRule -DisplayName "OpenClaw API" -Direction Inbound -Protocol TCP -LocalPort 8000 -Action Allow
# 验证规则
Get-NetFirewallRule -DisplayName "OpenClaw*"Linux防火墙（ufw）
# Ubuntu/Debian系统
sudo ufw allow 7860/tcp
sudo ufw allow 8000/tcp
sudo ufw allow 22/tcp
sudo ufw enable
# 验证
sudo ufw statusLinux防火墙（firewalld）
# CentOS/RHEL系统
sudo firewall-cmd --permanent --add-port=7860/tcp
sudo firewall-cmd --permanent --add-port=8000/tcp
sudo firewall-cmd --permanent --add-service=ssh
sudo firewall-cmd --reload
# 验证
sudo firewall-cmd --list-all🌍 代理设置（国内用户必备）
npm代理配置
# 设置淘宝镜像（推荐）
npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry
# 应显示：https://registry.npmmirror.compip代理配置
# 临时使用镜像
pip install openclaw -i https://pypi.tuna.tsinghua.edu.cn/simple
# 永久配置
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simpleGit代理配置
# HTTP代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy https://127.0.0.1:7890
# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy📶 网络连通性测试
# 测试GitHub连接
ping github.com
# 测试PyPI连接
curl https://pypi.org
# 测试npm连接
curl https://registry.npmjs.org
# 测试端口可用性
telnet localhost 7860
# 或
nc -zv localhost 7860🔑 账号与密钥准备（OpenAI/Claude/Ollama）
🤖 AI模型API密钥
. OpenAI API Key
📝 申请地址：https://platform.openai.com/api-keys
💰 费用：$0.01/1K tokens（GPT-4o）
✅ 推荐模型：gpt-4o、gpt-4-turbo、gpt-3.5-turbo
⚠️ 注意：需要绑定信用卡，建议设置使用限额获取步骤：
注册OpenAI账号
进入API Keys页面
点击"Create new secret key"
opic 复制并妥善保存（只显示一次！）
. Anthropic Claude API Key
📝 申请地址：https://console.anthropic.com/settings/keys
💰 费用：$3/1M tokens（Claude 3.5 Sonnet）
✅ 推荐模型：claude-3-5-sonnet-20260620
⚠️ 注意：需要企业邮箱验证获取步骤：
注册Anthropic账号
完成身份验证
进入API Keys页面
创建新密钥并保存
. Ollama本地模型（免费）
📝 官网：https://ollama.com/
💰 费用：完全免费
✅ 推荐模型：llama3、qwen2.5、mistral
⚠️ 注意：需要较高硬件配置常用模型命令：
# 拉取模型
ollama pull llama3
ollama pull qwen2.5
ollama pull mistral
# 查看已安装模型
ollama list🔐 密钥安全管理
环境变量配置（推荐）
创建 .env 文件：
# OpenAI配置
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o
# Claude配置
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx
ANTHROPIC_MODEL=claude-3-5-sonnet-20260620
# Ollama配置
OLLAMA_HOST=http://localhost:11434
OLLAMA_MODEL=llama3
# 其他配置
PORT=7860
DEBUG=false安全提醒：
- ✅ 将
.env加入.gitignore - ✅ 不要在代码中硬编码密钥
- ✅ 定期更换API密钥
- ✅ 设置API使用限额
📋 完整检查清单（打印版）
✅ 硬件检查
- CPU：至少双核2.0GHz（推荐四核3.0GHz+）
- 内存：至少2GB（推荐8GB+）
- 存储：至少10GB可用空间（推荐50GB+ SSD）
- 网络：稳定互联网连接（推荐100Mbps+）
✅ 操作系统检查
- Windows：Windows 10 2004+ 或 Windows 11
- Linux：Ubuntu 20.04+ / Debian 11+ / CentOS 8+
- macOS：macOS 10.15+（推荐Sonoma 14+）
- 系统更新：已安装最新系统补丁
✅ 软件依赖检查
- Python：3.10.12+ 已安装并验证
- Node.js：22.0.0+ 已安装并验证
- Git：2.40.0+ 已安装并验证
- Docker：24.0.0+ 已安装（推荐）
- VS Code：1.85+ 已安装（推荐）
- Ollama：0.1.34+ 已安装（可选）
✅ 网络环境检查
- 端口7860：未被占用，防火墙已放行
- 端口8000：未被占用（推荐）
- SSH端口22：已配置（推荐远程访问）
- 网络连接：可访问GitHub、PyPI、npm
- 代理设置：已配置镜像源（国内用户）
✅ 账号密钥检查
- OpenAI账号：已注册，API Key已获取
- Claude账号：已注册，API Key已获取（可选）
- Ollama模型：已下载至少一个模型（可选）
- 环境变量：
.env文件已创建并配置
✅ 安全配置检查
- 防火墙规则：已添加OpenClaw相关端口
- 系统密码：已设置强密码
- 备份方案：已规划数据备份策略
- 日志监控：已了解日志查看方法
💡 下期预告：Windows系统保姆级安装教程
在下一篇博客中，我们将进入实战安装环节！内容包括：
✅ Windows 11系统详细安装步骤（图文并茂）
✅ Python 3.11.8完整安装指南（含环境变量配置）
✅ Node.js 22.0.0一键安装教程
✅ Git 2.40.0配置与SSH密钥生成
✅ Docker Desktop 4.25安装与配置
✅ VS Code插件推荐与配置
✅ 常见安装问题解决方案（附错误代码对照表）
预计发布时间：2026年7月7日
难度等级：⭐⭐ 入门进阶
预计时长：30分钟（跟着做就能成功）
📝 本篇总结
表格
| 准备项目 | 关键要点 | 推荐配置 |
|---|---|---|
| 硬件 | 根据需求选择，避免过度配置 | 8GB内存+50GB SSD |
| 系统 | Linux最佳，Windows最易上手 | Ubuntu 22.04 / Win11 |
| 软件 | Python+Node.js+Git必备 | 严格按照版本号安装 |
| 网络 | 端口放行+代理配置 | 7860端口+镜像源 |
| 密钥 | 安全存储，避免泄露 | 环境变量+.gitignore |
💬 互动环节
欢迎在评论区留言讨论：
- 你准备使用什么硬件配置搭建OpenClaw？
- 你选择哪个操作系统？为什么？
- 在准备过程中遇到了什么问题？
点赞+收藏+关注，不错过每一篇保姆级教程！
下期预告：《OpenClaw Windows系统保姆级安装教程（附完整截图）》
小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用
更多推荐
4
0- 0
已为社区贡献2条内容
所有评论(0)