前言

一、安装前准备

1.1 设备配置要求

• 系统要求：Windows 10/11（64位）、macOS 14+、主流Linux发行版（如Ubuntu、CentOS），Windows系统需关闭第三方拦截软件（如杀毒软件、电脑管家），避免拦截安装脚本。

• 内存要求：最低4GB，推荐8GB及以上（8GB内存轻薄本实测可稳定运行，无卡顿）。

• 硬盘要求：至少预留10GB可用空间，用于存储安装包、依赖文件及运行缓存。

• 网络要求：安装过程中需联网（用于下载依赖文件），安装完成后可断网本地使用；建议使用家用宽带或手机热点，避免校园网、公司受限网络导致下载失败。

1.2 其他准备事项

• 权限准备：Windows用户需准备管理员权限（安装脚本需管理员权限执行，否则会报错）；macOS/Linux用户无需额外权限，直接打开终端即可。

• 命令准备：提前复制对应系统的一键安装命令（详见第二章），避免手动输入导致字符错误；国内网络下载缓慢时，可使用国内加速镜像命令（详见2.2节）。

• 可选准备：若需使用云端模型，可提前注册国内大模型账号（如MiniMax、智谱AI、阿里云百炼），获取API Key（注册后可领取免费额度，新手可先使用免费额度）；若需零Token无限使用，可提前准备Ollama本地模型工具（详见第四章进阶配置）。

二、一键安装步骤（核心流程）

2.1 Windows系统（最常用）

1. 打开管理员模式PowerShell（关键步骤）：点击电脑左下角搜索框，输入“PowerShell”，找到“Windows PowerShell”，右键选择“以管理员身份运行”；弹出“用户账户控制”提示框时，点击“是”确认（普通权限会导致安装失败，这是90%新手踩坑的主要原因）。

2. 复制并执行一键安装命令：将以下官方一键安装命令完整复制，粘贴到PowerShell蓝色窗口中，按下回车键启动安装： iwr -useb https://openclaw.ai/install.ps1 | iex 若国内网络下载缓慢、卡住不动，可替换为国内加速镜像命令： iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex。

3. 等待自动安装：安装过程全程自动，脚本会依次完成5件事：检测系统版本、安装Node.js 22.x LTS稳定版、配置国内加速源、安装小龙虾核心程序、自动配置环境变量；全程耗时3-8分钟（取决于网络速度），期间请勿关闭终端窗口、不要断网，弹出的系统弹窗全部点击“允许”。

4. 确认安装完成：当终端窗口显示“OpenClaw installed successfully”字样时，说明安装已完成；若未出现该提示，可关闭窗口重新执行安装命令，或切换网络后重试。

2.2 macOS系统

1. 打开终端：点击电脑“启动台”，找到“终端”应用并打开（无需管理员权限，直接运行即可）。

2. 复制并执行一键安装命令：将以下命令完整复制，粘贴到终端窗口中，按下回车键： curl -fsSL https://openclaw.ai/install.sh | bash。

3. 验证并等待安装：若终端提示输入电脑开机密码，直接输入（输入时不显示字符，属于正常现象），按下回车键；脚本将自动检测环境、安装依赖，全程耗时2-5分钟，期间请勿关闭终端窗口。

4. 确认安装完成：终端显示“OpenClaw installed successfully”字样，即代表安装成功；若提示权限不足，可在安装命令前添加“sudo ”（sudo curl -fsSL https://openclaw.ai/install.sh | bash），再次输入密码执行即可。

2.3 Linux系统

1. 打开终端：通过快捷键“Ctrl+Alt+T”打开终端，或在应用列表中找到“终端”并运行。

2. 复制并执行一键安装命令：将以下命令完整复制，粘贴到终端窗口中，按下回车键： curl -fsSL https://openclaw.ai/install.sh | bash。

3. 等待安装完成：脚本自动完成环境配置和程序安装，全程耗时2-5分钟；若提示权限不足，可添加“sudo ”提升权限后重新执行，安装完成后终端会显示成功提示。

三、安装验证与初始化配置

3.1 安装验证（必做步骤）

3.2 初始化配置（1分钟搞定）

1. 启动配置向导：在终端中输入命令“openclaw onboard”，按下回车键，启动交互式配置向导。

2. 按提示完成配置：

1. 接受风险提示：输入“yes”，按下回车键（部分版本无需此步骤，直接进入下一步）。

2. 选择模型接口：新手推荐选择“云端体验”（后续可随时切换成本地模型），直接按下回车键即可；若已准备好API Key，可选择对应模型供应商，粘贴API Key（密钥仅存储在本地，不会上传云端）。

3. 设置访问端口：默认端口为3000或18789（不同版本略有差异），无需修改，直接按下回车键即可；若端口被占用，后续可修改配置文件（详见第五章故障排查）。

4. 设置登录密码：输入一个简单好记的密码（用于登录小龙虾控制面板），按下回车键确认（密码需牢记，后续登录需使用）。

3. 完成配置：配置向导自动保存设置，提示“Configuration completed successfully”即代表初始化完成，小龙虾工具正式启动。

3.3 首次启动与登录

1. 启动工具：在终端中输入命令“openclaw start”，按下回车键，启动小龙虾服务。

2. 登录控制面板：启动成功后，浏览器会自动打开小龙虾控制面板（若未自动打开，可手动打开浏览器，在地址栏输入“http://localhost:3000”或“http://localhost:18789”，根据初始化时的端口确定），输入设置的登录密码，点击登录即可进入操作界面，开始使用各类功能。

四、进阶配置（可选）

4.1 本地模型配置（零Token无限用）

1. 安装Ollama工具：打开浏览器，访问Ollama官方网站（https://ollama.com/），下载对应系统的安装包，全程默认安装（和安装普通软件一样简单）。

2. 拉取轻量本地模型：打开终端（PowerShell/终端），输入命令“ollama pull qwen:7b”，按下回车键，等待模型下载完成（模型体积适中，普通电脑可带动）；也可选择其他轻量模型（如llama3:8b），替换命令中的模型名称即可。

3. 修改小龙虾配置文件：

1. Windows系统：找到路径“C:\Users\你的用户名\.openclaw\openclaw.json”（替换为自己的电脑用户名）。

2. macOS/Linux系统：找到路径“~/.openclaw/openclaw.json”。

4. 编辑配置文件：打开配置文件，在“models”部分添加以下内容（复制完整，不要写错格式）： "ollama" : { "baseUrl" : "http://localhost:11434" , "models" : [ { "id" : "qwen:7b" , "name" : "本地通义千问7B" , "contextWindow" : 8192, "maxTokens" : 4096 } ] }

5. 重启小龙虾：在终端输入命令“openclaw restart”，按下回车键，重启服务；重启后登录控制面板，选择本地模型，即可实现零Token无限使用。

4.2 第三方平台绑定（微信/飞书）

1. 微信绑定：在终端输入命令“openclaw connect --platform wechat”，按下回车键，弹出二维码；用微信扫码登录，即可完成绑定，后续可通过微信发送指令，控制小龙虾执行任务（如整理文件、写文档）。

2. 飞书绑定：在终端输入对应绑定命令，按提示完成飞书机器人配置，即可实现飞书深度集成（如创建表格、上传文件、写入内容），具体命令可参考小龙虾官方文档。

五、常见故障排查（新手必看）

5.1 安装类故障

• 故障1：提示“脚本无法运行”“禁止执行脚本” 解决方案：打开管理员PowerShell，输入命令“Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser”，弹出提示后输入“Y”并回车，再重新执行一键安装命令。

• 故障2：提示“openclaw 不是内部或外部命令” 原因：Node.js环境变量未生效 解决方案：重启电脑，重新打开管理员PowerShell，输入“node -v”，若显示版本号则正常；若仍异常，重新执行一键安装脚本，自动修复环境变量。

• 故障3：安装到一半卡住、下载失败 原因：网络波动或被拦截 解决方案：关闭终端窗口重新执行安装命令；切换为国内加速镜像命令；暂时关闭杀毒软件、防火墙，避免拦截脚本；切换手机热点重试。

• 故障4：中文用户名导致路径乱码、报错 解决方案：修改npm路径到纯英文盘（如D盘），在终端输入以下两条命令，依次回车： npm config set prefix "D:\npm-global" npm config set cache "D:\npm-cache"，修改完成后重新安装。

5.2 启动与使用类故障

• 故障1：启动后打不开控制面板网页 原因：默认端口（3000/18789）被其他软件占用 解决方案：1. 管理员PowerShell输入命令“netstat -ano | findstr :端口号”（替换为实际端口）；2. 查看最后一列PID，输入命令“taskkill /f /pid 数字”（替换为实际PID），关闭占用端口的程序；3. 重新输入“openclaw start”启动服务。

• 故障2：本地模型不生效 原因：Ollama未启动或配置文件格式错误 解决方案：确认Ollama在后台运行；检查配置文件中的标点、括号是否正确，重新编辑后重启小龙虾服务（openclaw restart）。

• 故障3：绑定微信/飞书失败 解决方案：关闭终端，重新执行绑定命令；检查网络是否正常；确认微信/飞书已登录，且未拦截二维码扫描；若仍失败，重启电脑后重试。

• 故障4：启动后提示“网关无法启动” 解决方案：重启电脑；卸载Node.js及相关依赖，删除残留文件后重新安装；更换安装方式（如使用clawx、Cherry Studio软件一键安装），重新执行安装流程。

六、基础使用指引（新手入门）

• 场景1：自动整理电脑文件 在控制面板或微信中输入指令，如“帮我把桌面文件按类型分类到D盘”“把下载文件夹里的图片全部归类”“批量重命名所有文件”，小龙虾会自动执行操作，无需手动干预。

• 场景2：自动办公写文档 输入指令，如“帮我写一份300字工作总结”“把这段文字做成表格”“帮我生成会议纪要”，支持导出Word、PDF格式，直接使用无需修改。

• 场景3：浏览器自动干活 输入指令，如“帮我查今天的热点新闻并汇总”“帮我打开3个常用网站”“帮我填写表单信息”，小龙虾会自动操作浏览器，完成对应任务，节省手动操作时间。