📌目录导航

1. ⚠️ 重要提醒：搭建前必读
2. 💻 硬件配置要求详解（含性价比推荐）
3. 🖥️ 操作系统选择指南（Windows/Linux/macOS对比）
4. 📦 依赖软件清单（版本号+下载地址）
5. 🌐 网络环境准备（端口/防火墙/代理）
6. 🔑 账号与密钥准备（OpenAI/Claude/Ollama）
7. 📋 完整检查清单（打印版）
8. 💡 下期预告：Windows系统保姆级安装教程

⚠️重要提醒：搭建前必读

🚨新手常见误区

表格

📊本篇价值

✅节省时间：避免因准备不足导致的反复折腾
✅降低门槛：即使是零基础小白也能顺利搭建
✅提高成功率：按照清单操作，安装成功率99%+
✅避免踩坑：提前规避90%的常见问题

💻硬件配置要求详解（含性价比推荐）

📋最低配置要求（仅测试用）

表格

⚠️警告：最低配置仅适合测试，不推荐生产环境使用！

✅推荐配置（流畅运行）

表格

性价比推荐硬件：

• 🖥️台式机：Intel i5-12400 / AMD Ryzen 5 5600X
• 💻笔记本：联想ThinkPad E14 / 戴尔灵越14
• 🍎Mac：MacBook Air M1（8GB+256GB）

🚀高性能配置（专业开发/模型训练）

表格

专业级推荐硬件：

• 🖥️工作站：联想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）
• ✅ 隐私保护需求
• ✅ 离线使用

📋完整依赖清单表格

表格

🌐网络环境准备（端口/防火墙/代理）

🚪必需端口清单

表格

🔥防火墙配置

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 status

Linux防火墙（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.com

pip代理配置

# 临时使用镜像 pip install openclaw -i https://pypi.tuna.tsinghua.edu.cn/simple # 永久配置 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

Git代理配置

# 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分钟（跟着做就能成功）

📝本篇总结

表格

💬互动环节

欢迎在评论区留言讨论：

1. 你准备使用什么硬件配置搭建OpenClaw？
2. 你选择哪个操作系统？为什么？
3. 在准备过程中遇到了什么问题？

点赞+收藏+关注，不错过每一篇保姆级教程！

下期预告：《OpenClaw Windows系统保姆级安装教程（附完整截图）》