第一部分 新手入局必备资料/材料清单（提前备齐，零卡顿）

一、硬件与系统要求（无额外成本，普通电脑即可）

• 适用系统：Windows 10 及以上（64位）、macOS 10.15 及以上、主流Linux发行版

• 硬件配置：内存≥4GB（推荐8GB及以上，运行多任务不卡顿）；可用磁盘空间≥10GB；无需独立显卡，核显即可

• 网络要求：稳定家用/办公网络，安装阶段需联网下载依赖；无需公网IP，本地部署完全够用；国内用户直接用国内镜像，无需额外代理

二、必装软件依赖（核心运行基础，缺一不可）

• Node.js（版本≥22.0.0 LTS）：OpenClaw底层运行环境，版本过低直接安装失败，优先选LTS长期支持版，避免兼容问题

• 终端工具：Windows用PowerShell（管理员模式）、Mac/Linux用系统自带终端，无需额外下载

• 辅助工具：记事本/VSCode（用于查看、备份配置文件）；压缩软件（备用，无需提前安装）

三、AI模型API密钥（让OpenClaw能干活的核心）

OpenClaw本身不带大模型，需对接第三方API实现内容生成、任务处理、自动化干活，新手优先选国内平台，有免费额度，无需境外支付

• 推荐平台：阿里云百炼（新用户免费额度高，国内网络稳定）、Moonshot AI（Kimi）、通义千问、文心一言

• 获取步骤：注册账号→完成实名认证→进入API密钥管理→创建新密钥→复制保存（单独存放在文本文件，严禁泄露）

• 额度说明：新用户免费额度足够新手实操1-2周，后续充值成本极低，日常文档处理、信息汇总月消耗仅几十元

四、其他必备资料

• 官方国内镜像地址（安装加速用）：https://open-claw.org.cn

• npm国内镜像：https://registry.npmmirror.com（解决下载卡顿、超时问题）

• 前文变现场景案例（选定方向，针对性配置技能，避免盲目操作）

---

第二部分 新手零基础入局全步骤（逐行复制，零失败）

步骤1：安装Node.js（10分钟，必做第一步）

Windows系统操作

1. 打开Node.js中文官网：https://nodejs.org/zh-cn/download/，下载22.x LTS版本.msi安装包

2. 双击安装包，全程默认下一步，务必勾选Add to PATH（添加到系统环境变量），不修改安装路径

3. 安装完成后，按Win+X，选择终端(管理员)，打开后依次执行以下两条命令验证：

1. node -v  （输出版本号如v22.6.0即为成功）

2. npm -v   （输出版本号如10.8.0即为成功）

4. 验证失败重启电脑，再重新执行命令

Mac系统操作

1. 打开Launchpad搜索Terminal，打开终端

2. 已装Homebrew直接执行：brew install node@22

3. 未装Homebrew，先执行安装命令：/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”

4. 安装完成后执行：node -v 和 npm -v 验证，输出版本号即为成功

步骤2：设置国内镜像（解决下载慢、报错）

终端直接复制执行，避免依赖下载超时失败：

npm config set registry https://registry.npmmirror.com

步骤3：一键安装OpenClaw（5分钟，新手专属，无复杂配置）

Windows（管理员终端执行）

1. 先执行权限设置命令，输入Y回车确认：

1. Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 复制国内加速一键安装命令，粘贴执行，等待自动运行（3-8分钟，不要关闭终端）：

1. iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

3. 执行完成后，输入 openclaw –version 验证，显示版本号即为安装成功

Mac/Linux（终端执行）

1. 复制一键安装命令，粘贴执行，输入电脑密码（输入无显示，正常输完回车）：

1. curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

2. 安装完成后，输入 openclaw –version 验证，显示版本号即为成功

步骤4：初始化核心配置（关键，让工具正常干活）

1. 终端手动执行初始化命令：openclaw onboard

2. 出现风险提示：i understand this is powerful and inherently risky. continue?  输入 Yes 回车（确认合规使用，知晓权限风险）

3. 选择配置模式：输入 1 选择 QuickStart 快速模式（新手专用，跳过复杂手动配置）

4. 选择模型提供商：根据自己准备的API密钥选择，如阿里云百炼、Moonshot AI

5. 粘贴提前复制好的API密钥，回车确认（密钥输入无显示，直接粘贴即可）

6. 权限设置：输入 1 选择 沙盒模式（新手强制选，限制系统权限，杜绝误操作风险）

7. 等待提示 Onboarding completed successfully，初始化完成

步骤5：启动服务并进入可视化控制台

1. 终端执行启动命令，保持终端后台运行，不要关闭：

1. openclaw gateway start

2. 启动成功后，打开任意浏览器，输入地址访问：http://localhost:18789

3. 查看终端显示的临时验证码，输入控制台完成登录，后续可在设置里修改固定密码

4. 控制台关闭不影响运行，只需保持终端后台开启即可

步骤6：新手第一个实操任务（验证干活能力）

以最常用的文档转换功能为例，全程可视化，零代码：

1. 进入控制台左侧【技能管理】，点击【新建技能】

2. 技能名称：PDF转Word；技能描述：自动将PDF文件转换为Word，保留原排版

3. 触发关键词：文档转换 PDF转Word

4. 执行规则：角色设定为文档处理助手，要求转换后保留图片、表格、排版，输出docx格式文件

5. 点击【保存并启用】，技能创建完成

6. 进入左侧【自动化任务】，点击【新建任务】，选择【条件触发】

7. 触发条件：收到关键词+上传文件

8. 执行动作：选择已创建的【PDF转Word】技能

9. 通知设置：完成后自动返回文件

10. 点击【启动任务】，上传测试PDF，发送关键词，验证自动转换效果

步骤7：新手必做安全与优化设置

1. 关闭公网访问：本地使用默认关闭，严禁手动开启外网端口，避免数据泄露风险

2. API密钥备份：将密钥单独保存在本地文本，不要放在配置文件里共享，泄露会产生额外费用

3. 权限管控：始终保持沙盒模式运行，不授予系统最高权限

4. 插件管理：新手阶段不安装任何第三方不明插件，仅用官方自带功能

---

第三部分 新手常见报错解决办法（复制即用）

1. 报错：command not found（命令未找到）

1. 解决：Windows重新用管理员终端；Mac执行 sudo -i 切换管理员，重新安装

2. 报错：安装超时、下载失败

1. 解决：重新执行镜像命令 npm config set registry https://registry.npmmirror.com，重启终端再安装

3. 报错：API密钥验证失败

1. 解决：核对密钥是否复制完整，有无多余空格；检查账号是否完成实名认证，额度是否正常

4. 报错：服务启动失败

1. 解决：关闭电脑防火墙、杀毒软件，重启终端，重新执行 openclaw gateway start

第四部分 新手入局后续流程（从能用→变现）

1. 熟练基础功能：先练会文档处理、信息汇总、定时提醒等简单技能，掌握控制台操作

2. 定制变现技能：根据选定的变现场景，针对性创建专属自动化技能，搭建完整任务流程

3. 接单/运营：对接闲鱼、猪八戒等接单平台，或搭建本地社群，开始承接业务变现

4. 持续优化：根据使用反馈调整技能规则，提升干活效率，逐步拓展业务规模

---

第五部分 新手核心注意事项

• 全程按步骤操作，不跳步、不随意修改配置文件，避免运行异常

• 所有命令直接复制粘贴，不要手动打字，减少输入错误

• 不用于违法违规操作，合规使用，守住安全底线

• 初期不追求复杂功能，先实现基础自动化，熟练后再逐步拓展