目录导航⚠️ 重要提醒搭建前必读 硬件配置要求详解含性价比推荐️ 操作系统选择指南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 / 戴尔灵越14MacMacBook Air M18GB256GB高性能配置专业开发/模型训练表格组件高性能配置适用场景CPU八核 3.5GHz复杂任务处理内存16GB RAM大模型运行GPUNVIDIA RTX 3060本地模型加速存储256GB NVMe SSD大量模型存储网络1Gbps高速数据传输专业级推荐硬件️工作站联想ThinkStation P360 / 戴尔Precision 3660Mac ProMacBook Pro M2 Pro16GB512GB服务器树莓派58GB版- 7×24小时运行2026年最佳性价比方案推荐方案一入门级预算2000元✅ 树莓派58GB 64GB SD卡 散热套件 总成本约1800元 适用场景轻量级自动化任务、个人助手 优势功耗低、静音、可7×24小时运行 ⚠️ 注意需要搭配云API使用本地模型性能有限方案二标准级预算3000-5000元✅ 二手Mac mini M18GB256GB 总成本约3500元 适用场景日常办公自动化、文件处理 优势性能稳定、macOS生态完善 ⚠️ 注意需自行安装系统方案三高性能级预算5000-8000元✅ 全新联想ThinkPad E14 Gen 5i5-1340P/16GB/512GB 总成本约6500元 适用场景开发测试、本地模型运行 优势扩展性强、维护方便 ⚠️ 注意需要额外配置GPU可选️ 操作系统选择指南Windows/Linux/macOS对比 三大系统对比表表格特性 Windows Linux macOS安装难度 ⭐⭐⭐ 简单 ⭐⭐⭐⭐ 需基础 ⭐⭐⭐ 简单兼容性 ⭐⭐⭐⭐ 优秀 ⭐⭐⭐⭐⭐ 最佳 ⭐⭐⭐⭐ 优秀性能表现 ⭐⭐⭐ 良好 ⭐⭐⭐⭐⭐ 最优 ⭐⭐⭐⭐ 优秀资源占用 ⭐⭐ 较高 ⭐⭐⭐⭐ 低 ⭐⭐⭐ 中等社区支持 ⭐⭐⭐ 良好 ⭐⭐⭐⭐⭐ 最强 ⭐⭐⭐ 良好推荐指数 ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ Windows系统适合新手支持版本✅ Windows 1164位推荐✅ Windows 102004版本❌ 不支持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/ # 推荐插件 # - PythonMicrosoft # - 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 --versionNode.js⭐⭐⭐ 必需22.0.0官网node -vGit⭐⭐⭐ 必需2.40.0官网git --versionDocker⭐⭐ 推荐24.0.0官网docker --versionVS Code⭐⭐ 推荐1.85官网手动验证Ollama⭐ 可选0.1.34官网ollama --version网络环境准备端口/防火墙/代理必需端口清单表格端口用途协议是否必需7860OpenClaw WebUITCP⭐⭐⭐ 必需8000API服务TCP⭐⭐ 推荐22SSH远程访问TCP⭐⭐ 推荐443HTTPS加密TCP⭐ 可选80HTTP访问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-port7860/tcp sudo firewall-cmd --permanent --add-port8000/tcp sudo firewall-cmd --permanent --add-servicessh 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 tokensGPT-4o ✅ 推荐模型gpt-4o、gpt-4-turbo、gpt-3.5-turbo ⚠️ 注意需要绑定信用卡建议设置使用限额获取步骤注册OpenAI账号进入API Keys页面点击Create new secret keyopic 复制并妥善保存只显示一次. Anthropic Claude API Key 申请地址https://console.anthropic.com/settings/keys 费用$3/1M tokensClaude 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_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx OPENAI_MODELgpt-4o # Claude配置 ANTHROPIC_API_KEYsk-ant-xxxxxxxxxxxxxxxxxxxxxxxx ANTHROPIC_MODELclaude-3-5-sonnet-20260620 # Ollama配置 OLLAMA_HOSThttp://localhost:11434 OLLAMA_MODELllama3 # 其他配置 PORT7860 DEBUGfalse安全提醒✅ 将.env加入.gitignore✅ 不要在代码中硬编码密钥✅ 定期更换API密钥✅ 设置API使用限额完整检查清单打印版✅硬件检查CPU至少双核2.0GHz推荐四核3.0GHz内存至少2GB推荐8GB存储至少10GB可用空间推荐50GB SSD网络稳定互联网连接推荐100Mbps✅操作系统检查WindowsWindows 10 2004 或 Windows 11LinuxUbuntu 20.04 / Debian 11 / CentOS 8macOSmacOS 10.15推荐Sonoma 14系统更新已安装最新系统补丁✅软件依赖检查Python3.10.12 已安装并验证Node.js22.0.0 已安装并验证Git2.40.0 已安装并验证Docker24.0.0 已安装推荐VS Code1.85 已安装推荐Ollama0.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软件PythonNode.jsGit必备严格按照版本号安装网络端口放行代理配置7860端口镜像源密钥安全存储避免泄露环境变量.gitignore互动环节欢迎在评论区留言讨论你准备使用什么硬件配置搭建OpenClaw你选择哪个操作系统为什么在准备过程中遇到了什么问题点赞收藏关注不错过每一篇保姆级教程下期预告《OpenClaw Windows系统保姆级安装教程附完整截图》