文档版本：3.0 | 适用读者：完全零基础 | 最后更新：2024年
核心原则：假设读者第一次接触电脑，每个步骤都有“为什么做”、“怎么做”、“做完会看到什么”
亲爱的同学，你好！欢迎踏上OpenClaw的探索之旅。我是你的讲师，接下来我会手把手带你完成整个安装过程。
OpenClaw是什么？
简单来说，它是一个能帮你干活的AI助手，但和你平时用的ChatGPT不同：
- ✅ 它在你自己的电脑上运行：你的数据、文件都留在本地，不会上传到云端
- ✅ 它能看到你的文件：你可以让它整理桌面、重命名文件、搜索文档
- ✅ 它能执行代码：你可以让它写个Python脚本，然后直接运行
- ✅ 它能接入聊天软件：把它拉进微信群、飞书群，它就能在群里帮你干活
但请注意：正因为它能力强大，所以安装时需要多花一点心思。别担心，跟着这份指南走，你一定能成功！
很多零基础的同学看到“命令行”、“终端”、“代码”这些词就紧张。我向你保证：
- 你不需要会编程：全程只需要复制粘贴我给你的命令
- 所有操作都有反馈：我会告诉你每一步之后应该看到什么
- 所有问题都有预案：常见错误我都提前告诉你如何处理
- 你只需要认真仔细：像做菜一样，按顺序放“调料”就行
请记住：如果过程中遇到任何和指南描述不一致的地方，不要慌，停下来仔细看报错信息，然后翻到文档最后的【故障排查】部分找解决办法。
请先找到你的操作系统，然后按照推荐方案执行：
讲师强烈建议：如果你是Windows用户并且打算长期使用OpenClaw，请直接选择方案C。虽然第一次配置多花20分钟，但后续使用会非常顺畅，不会遇到各种奇怪的兼容性问题。
OpenClaw需要一把“钥匙”才能调用AI模型。这里提供两种最友好的选择，请任选一个完成。
选择一：Google Gemini（推荐，免费，国内可访问）
特点：免费额度大，速度快，申请简单
详细步骤：
- 打开申请页面
- 打开浏览器（Chrome/Edge/ Safari都可以）
- 在地址栏输入：
- 按回车键
- 登录Google账号
- 如果已经登录，直接进入下一步
- 如果没有登录，会看到登录界面
- 输入你的Google邮箱和密码
- 如果没有Google账号，点击“创建账号”，按提示注册（需要手机号验证）
- 创建API Key
- 登录后，你会看到一个蓝色的 “Create API Key” 按钮
- 点击它
- 会弹出一个窗口，问你要不要新建项目
- 选择 “Create API key in new project” （在新项目中创建）
- 复制你的Key
- 页面会显示一串以 开头的字符
- 这就是你的API Key！
- 用鼠标选中它，按 （Mac用户按 ）复制
- 重要：把它粘贴到记事本里保存，后面要用
成功标志：你看到并复制了一串类似 的字符
注意事项：
- Google Gemini是完全免费的，每分钟可以调用60次，足够个人使用
- 虽然需要绑定信用卡（美国地区）才能开通，但不会扣费，只是验证身份
- 如果不想绑定信用卡，可以选择下面的阿里云
选择二：阿里云百炼（通义千问，中文友好）
特点：国内服务，中文支持好，新人有免费额度
详细步骤：
- 打开阿里云官网
- 浏览器输入：
- 点击右上角的“登录/注册”
- 注册/登录账号
- 如果没有账号：点击“免费注册”，按提示完成（需要手机号验证）
- 如果有账号：直接登录
- 完成实名认证（必须）
- 登录后，鼠标悬停在右上角头像上
- 点击“实名认证”
- 选择“个人认证”
- 按提示输入姓名和身份证号
- 通过支付宝扫码验证（约1分钟完成）
- 进入模型服务控制台
- 在浏览器新标签页输入：
- 如果是第一次进入，可能需要同意服务条款，勾选同意即可
- 获取API Key
- 在左侧菜单栏找到 “模型广场”
- 展开后点击 “API-KEY管理”
- 点击蓝色的 “创建API-Key”
- 在弹出的窗口中，输入名称（比如“openclaw”）
- 点击“确定”
- 复制你的Key
- 页面会显示一串以 开头的字符
- 这就是你的API Key！
- 点击“复制”按钮，粘贴到记事本保存
成功标志：你看到并复制了一串类似 的字符
注意事项：
- 新用户赠送100万tokens（约等于100万汉字），足够新手玩很久
- 用完免费额度后需要充值，否则AI会报错
⚠️ 请一定记住：
- ✅ API Key要保存在自己的记事本里
- ✅ 只在配置OpenClaw时粘贴使用
- ❌ 不要分享给任何人（包括朋友、网友）
- ❌ 不要发到任何网站、论坛、群里
- ❌ 不要把包含Key的截图发出去
如果误将Key泄露，请立即回官网删除并重新生成。
如果你是Mac电脑用户（包括Intel芯片和M1/M2/M3芯片），恭喜你，这是最简单的方案！
终端是一个黑乎乎的窗口，我们通过它来输入命令指挥电脑。
打开方法：
- 点击屏幕右上角的放大镜图标（聚焦搜索）
- 输入 “终端” （不要输入引号）
- 看到黑色的终端图标，点击它
- 你会看到：一个白色或黑色的窗口，光标在闪烁，前面有你的电脑名和用户名
小提示：以后可以把这个终端图标拖到下面的Dock栏，方便随时打开
Node.js是OpenClaw的“发动机”，必须先确认有没有装过。
在终端中输入以下命令（复制粘贴，然后按回车）：
bash
你会看到三种可能的结果：
我们使用Homebrew来安装，这是Mac上最方便的软件管理工具。
2.3.1 先安装Homebrew
在终端中复制粘贴以下命令（一整行），然后回车：
过程中你会遇到：
- 系统可能会提示输入密码（就是你开机登录的密码）
- 输入时屏幕完全没反应（不显示星号，光标也不动）——这是正常的！
- 正常输入密码，输完后按回车
- 会看到很多文字在滚动，最后出现 或类似提示
- 整个过程可能需要几分钟，取决于网速，请耐心等待
如果卡住不动了：
- 按 取消
- 重新执行上面的命令
2.3.2 使用Homebrew安装Node.js
继续在终端中输入：
你会看到：很多文字滚动，最后出现绿色的 和 图标
2.3.3 将Node.js添加到系统路径
为了让系统能找到新安装的Node.js，需要执行：
你会看到：没有输出是正常的，直接回到命令提示符
2.3.4 验证Node.js安装
输入：
你应该看到：（x是具体数字）
如果还是显示旧版本或找不到：
- 关掉终端，重新打开一个新的
- 再次输入 验证
现在可以正式安装OpenClaw了！
在终端中复制粘贴以下命令：
如果你在中国大陆，访问上述地址慢，请使用这个镜像源：
bash
你会看到：
- 很多文字在滚动
- 最后出现类似 或 的提示
安装完成后，会自动启动配置向导。如果没自动启动，手动输入：
接下来你会看到一系列问题，需要你做出选择。请严格按照下面的表格回答：
【问题1】
- 中文意思：我了解这个软件功能强大且有风险，要继续吗？
- 你应该：按 然后回车（或者直接按回车，默认就是Yes）
- 你会看到：进入下一个问题
【问题2】 下面有选项
- 选项有：QuickStart / Advanced / Custom
- 你应该：用键盘上下键移动到 ，然后按回车
- 为什么：快速启动模式会自动帮我们配置大部分选项
【问题3】 选择模型提供商
- 选项有：OpenAI / Google / Anthropic / Custom Provider 等
- 你应该：
- 如果你用的是Google Gemini的Key：选择
- 如果你用的是阿里云的Key：选择
- 怎么选：用上下键移动，按回车确认
【问题4】 接下来取决于你的选择：
情况A：你选了Google
- 会问 （选择模型）
- 选项有：gemini-pro / gemini-1.5-flash 等
- 你应该选：（速度最快，免费额度高）
- 然后直接跳到【问题5】
情况B：你选了Custom Provider
- 会问 （API地址）
- 你应该：直接按回车跳过（后面可以再配置）
- 然后会问 （模型名称）
- 你应该：直接按回车跳过
- 然后会问 （粘贴你的钥匙）
- 你应该：粘贴你在阿里云复制的Key（以sk-开头的那串）
- 粘贴方法：在终端中直接点击鼠标右键，或者按
【问题5】 （如果上面还没粘贴）
- 你应该：粘贴你在Google复制的Key（以AIzaSy开头的那串）
- 粘贴方法：在终端中直接点击鼠标右键，或者按
- 注意：粘贴后屏幕不会显示你贴的内容，这是正常的！直接按回车
【问题6】 （选择要安装的通讯渠道）
- 选项有：wechat / feishu / telegram 等，前面有 [ ]
- 你应该：确保所有选项都是空的（没有[X]）
- 如果有选项被选中，按空格键可以取消选中
- 全部取消后，按回车选择 （暂时跳过）
- 为什么：第一次安装，我们先在网页上熟悉，以后再配置接入聊天软件
【问题7】 （安装技能吗？）
- 你应该：输入 然后回车（或者直接按回车，默认是No）
- 为什么：技能是扩展功能，第一次先不装
【问题8】 （安装守护进程吗？）
- 你应该：输入 然后回车（这个很重要！ ）
- 为什么：这样OpenClaw就能在后台自动运行，即使你关掉终端窗口，它也不会“死掉”
【问题9】 （孵化方式）
- 选项有：Open the Web UI / Print connection info / Just exit
- 你应该：选择 （打开网页界面）
- 你会看到：浏览器会自动弹开
- 浏览器应该自动打开了
- 你会看到一个简洁的聊天界面，中间有一个输入框
- 输入你的第一句话：
- 按回车发送
- 你会看到：OpenClaw开始回复，介绍自己
如果浏览器没有自动打开：
- 手动在终端输入：
- 终端会显示一行网址，用浏览器打开它
在聊天框里输入以下命令，测试OpenClaw的执行能力：
测试1：让它在你的电脑上创建一个文件
你会看到：它告诉你文件已创建，并且在你当前目录下确实多了这个文件
测试2：让它帮你搜索信息（需要网络）
你会看到：它会调用搜索功能，返回结果
测试3：让它执行简单代码
你会看到：它会写一段Python代码并执行，返回计算结果
🎉 恭喜！你的OpenClaw已在macOS上成功运行！ 你可以继续阅读【第四部分：日常操作指南】，学习如何管理你的OpenClaw。
如果你是Linux用户（以Ubuntu为例），安装过程与macOS类似，但命令略有不同。
- 按 组合键
- 你会看到：一个黑色的窗口，光标在闪烁
在终端中输入：
系统会提示输入密码（就是你登录Linux的密码），输入后回车。输入时屏幕无显示，正常！
你应该看到：
验证：
你应该看到：
请完全按照【2.5节】的表格回答所有问题
浏览器会自动打开，看到聊天界面即成功。
这是Windows用户最稳定、最推荐的方案。我们将在Windows里安装一个完整的Linux系统（Ubuntu），然后在里面运行OpenClaw。
WSL2需要CPU支持虚拟化，并且要在BIOS中开启。
检查方法：
- 按 打开任务管理器
- 点击左下角的 “性能” 标签页
- 点击左侧的 “CPU”
- 在右下角找到 “虚拟化：已启用”
- 如果显示 “已启用” → ✅ 可以继续
- 如果显示 “已禁用” → 需要进入BIOS开启（见下文）
- 如果显示 “不支持” → 你的CPU太老，无法使用WSL2，请转【方案D】
如何进入BIOS开启虚拟化：
- 重启电脑
- 开机时不断按特定键（不同品牌不同）：
- Dell/联想：F2 或 F12
- HP：F10
- 华硕：F2 或 Del
- 宏碁：F2
- 进入BIOS后，找到类似配置：
- Intel CPU：Intel Virtualization Technology 或 VT-x
- AMD CPU：SVM Mode
- 设置为 Enabled
- 按F10保存退出
PowerShell是Windows下的命令行工具，我们需要用管理员权限运行它。
正确打开方法：
- 点击屏幕左下角的 “开始” 按钮
- 直接输入
- 在搜索结果中，会看到 “Windows PowerShell”
- 重要：鼠标右键点击它，选择 “以管理员身份运行”
- 如果弹出用户账户控制窗口，点击 “是”
确认是否成功：
- 窗口标题应该以 “管理员：” 开头
- 示例：
在管理员PowerShell中，复制粘贴以下命令（鼠标右键点击即可粘贴）：
你会看到：
- 很多文字滚动，显示正在安装
- 最后会提示安装成功，并可能需要重启
这个命令会自动完成：
- 启用WSL功能
- 启用虚拟机平台
- 下载并安装默认的Ubuntu系统
如果中途报错或卡住：
情况A：提示“无法解析服务器名称或地址”
- 网络问题，可以手动安装：
情况B：提示“0x”错误
- 系统版本太低，需要更新Windows
必须重启！ 让所有更改生效。
- 重启后，点击 “开始” 按钮
- 输入
- 点击出现的 “Ubuntu” 应用（紫色图标）
第一次启动需要设置用户名和密码：
- 系统会显示：
- 输入用户名：
- 输入一个你喜欢的名字（如你的英文名或拼音）
- 建议用简单好记的，比如： 或你的名字拼音
- 输完后按回车
- 输入密码（这里非常重要！ ）：
- 输入时屏幕上完全没有任何显示！ （不显示星号，光标也不动）
- 这不是电脑坏了，是Linux的安全机制
- 正常输入你想设置的密码（建议简单点，比如 ）
- 输完后按回车
- 确认密码：
- 再次输入同样的密码
- 同样屏幕无显示
- 输完后按回车
- 成功标志：
- 看到类似 的提示符
- 这表示你已经成功进入Ubuntu系统了！
如果忘记密码了怎么办：
- 回到PowerShell（管理员），执行：
- 然后重新从【4.5节】开始
现在你已经在Ubuntu系统中了，所有命令都在这个紫色的Ubuntu窗口中执行。
系统会提示输入密码，输入刚才设置的Ubuntu密码（输入时仍然无显示），按回车。
验证：
你应该看到：
验证：
你应该看到：
请完全按照【2.5节】的表格回答所有问题！ 一模一样地回答。
为了让OpenClaw能在后台自动运行，需要启用systemd。
- 编辑配置文件：
- 在打开的文件中粘贴以下内容：
- 保存退出：
- 按 （字母O），然后按回车（保存）
- 按 （退出）
- 重启WSL2：
回到Windows的PowerShell（管理员），执行：
- 重新打开Ubuntu，再次进入
- 验证systemd是否生效：
如果看到很多绿色的"●"和服务列表，说明生效
在Ubuntu终端中输入：
第一次运行可能会弹出Windows防火墙提示：
- 会看到“Windows Defender防火墙已阻止此应用的部分功能”
- 请勾选“专用网络” （Private networks）
- 不要勾选“公用网络” （Public networks）
- 点击“允许访问”
浏览器会自动打开 ，看到聊天界面即成功。
从Windows访问WSL2的文件：
- 打开文件资源管理器
- 在地址栏输入：
- 按回车，就能看到Ubuntu里的所有文件
- 你的个人文件在 目录下
从WSL2访问Windows的文件：
- 在Ubuntu终端中，Windows的C盘在
- 例如要访问桌面：
🎉 恭喜！你的OpenClaw已在Windows WSL2环境中成功运行，这是最稳定的方案！
如果你暂时不想折腾WSL2，只是想快速看看OpenClaw长什么样，可以选择这个方案。但请注意：后续安装插件时可能会遇到兼容性问题。
- 打开浏览器，访问：
- 下载Node.js：
- 页面左侧有个绿色的按钮 “LTS”
- 点击它下载（会自动识别你的系统）
- 确保下载的是64位版本（除非你的电脑是古董32位）
- 安装Node.js：
- 双击下载的安装包
- 一路点击“Next”（下一步）
- 关键步骤：当看到 时，一定要勾选！
- 继续点“Next”直到“Install”
- 点击“Finish”完成
- 验证安装：
- 按 ，输入 ，回车
- 输入
- 你应该看到：
Windows默认禁止运行脚本，需要放开限制。
以管理员身份打开新的PowerShell：
- 按 键，输入
- 右键点击“Windows PowerShell”，选“以管理员身份运行”
执行以下命令：
验证：
应该显示：
在PowerShell（普通权限即可，不一定需要管理员）中执行：
如果慢，用镜像源：
powershell
请完全按照【2.5节】的表格回答所有问题
浏览器会自动打开 ，看到聊天界面即成功。
🎉 恭喜！你的OpenClaw已在Windows PowerShell原生环境中运行！
如果你在配置向导中选择了 ：
- ✅ 已经自动配置好了，不用管
如果你用的是Windows PowerShell原生方案且没装daemon：
- 按 ，输入 ，回车
- 在打开的文件夹中右键点击，选择“新建” -> “快捷方式”
- 在位置输入：
- 点击“下一步”，输入名称“OpenClaw”，点击“完成”
方法一：重新运行配置向导（推荐新手）
方法二：直接修改配置文件
配置文件位置：
- Windows：
- macOS/Linux：
用记事本打开，找到对应项修改即可。
问题：
可能原因及解决办法：
- Node.js没安装或版本不对
如果看不到版本号，重新安装Node.js
- 安装后没重启终端
- 关掉当前终端，重新打开一个新的
- 如果还不行，重启电脑
- 安装路径不在环境变量中
- Windows：重新运行安装程序，确保勾选“Add to PATH”
- macOS/Linux：检查 或 中是否有npm路径
问题：
原因：18789端口已被其他程序占用
解决方法：
- 找到占用端口的程序
- Windows：
看到最后一列的数字是PID（进程ID）
- macOS/Linux：
- Windows：
- 结束占用进程
- Windows：
powershell
- macOS/Linux：
bash
- Windows：
- 重启网关
问题：AI不回复，或报错 /
原因：
- API Key复制错了（多了空格、少复制字符）
- API Key已过期或额度用尽
- 网络无法访问AI服务商
解决方法：
- 检查API Key是否正确
- 重新打开你保存Key的记事本
- 仔细对比：Google的Key以 开头，共39位
- 阿里云的Key以 开头
- 重新配置API Key
- 测试网络连通性
- Google：在浏览器打开
- 阿里云：在浏览器打开
- 如果打不开，说明网络不通，需要配置代理
日志是排查问题的“黑匣子”，学会看日志能解决90%的问题：
常见日志含义：
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/232642.html