硬件 & 软件前置要求
硬件
- 内存：最低 4GB，推荐 8GB 及以上
- 磁盘：至少 2GB 空闲存储空间
- 网络：可访问外网（有能力的话最好，没也行）
必备环境
- Node.js ≥ v22，版本过低会直接安装失败
- Windows：PowerShell（管理员模式）
- windows/Mac / Linux：系统终端
准备工作
提前申请一个大模型 API Key（智谱、硅基流动、阶跃星辰等国内平台均可），龙虾本身免费，但调用大模型需要 API Key。我以deepseek为例
网址：https://www.deepseek.com/
方式一：一键脚本安装（新手推荐）
Windows 系统
右键开始菜单，以管理员身份打开 PowerShell。
设置 PowerShell 执行策略（允许运行安装脚本）。
Windows 默认禁止运行脚本，必须修改，否则安装脚本无法执行。
在管理员 PowerShell 中输入以下命令，按回车：Set-ExecutionPolicy-ExecutionPolicyRemoteSigned-ScopeCurrentUser复制下面整条命令粘贴，回车执行：
iwr-useb https://openclaw.ai/install.ps1|iex等待 3‑10 分钟，网络不同耗时不一样。
看到
OpenClaw installed successfully代表安装完成。
Mac / Linux
打开系统终端，执行一键脚本：
curl-fsSLhttps://openclaw.ai/install.sh|bash验证是否安装成功
终端输入：
openclaw-v输出版本号，说明安装成功。
方式二：NPM 命令安装（已有 Node.js 22+ 环境）
适合已经装好 Node.js v22 以上的用户，直接全局安装最新版：
npminstall-gopenclaw@latest初始化配置（安装后必做）
打开龙虾控制台，命令行输入：
openclaw onboardWindows 终端粘贴注意：Ctrl+V 大概率无效，鼠标右键窗口，选择编辑，粘贴，避免带入多余空格导致报错。
然后会出现以下画面：
操作终端输入 yes 回车，开始初始化向导
向导会引导你填入 API Key（OpenAI / Anthropic Claude），设置 Agent 基础配置。
注意：输入 yes 代表你同意安全声明，Agent 可以操作本机文件系统。
输入 yes 后会出现这个画面：
输入 yes 程序会进入配置向导，让你填入大模型服务商 API Key（OpenAI / Anthropic Claude）。
键盘↑ ↓ 件选择，Enter确定
找到先前准备好的大模型（智谱、硅基流动、阶跃星辰等）如果没有就选择more
选择你的大模型，我选择deepseek
然后会出现一个大致是这样的界面，现在要下载插件尽量选择npm下载（Download from npm）
安装完成后会让你填写API Key复制你的API Key
如果ctrl+v没有用就鼠标右键窗口，选择编辑，粘贴，避免带入多余空格导致报错。
这里会让你选择你的模型如果不想用这个模型就选第三个选项
我这里还选deepseek-v4-flash
测试龙虾是否正常工作
在控制台输入指令测试：
帮我在桌面新建一个测试文档，写一段测试文字。龙虾如果自动完成新建文
件、写入内容，代表部署全部完成。
常见报错与排错
| 问题 解决办法 |
| 安装失败、依赖报错 确认 Node 版本≥22，卸载旧版本 Node 重装 |
| API 调用失败 检查 Key 是否复制多余空格，确认平台有可用额度 |
| Windows 脚本被拦截 PowerShell 管理员运行，放开系统执行策略 |
| 启动后无响应 切换国内大模型，不要直接使用海外模型 |
| openclaw 命令找不到 重启终端，重启电脑刷新环境变量 |
启动教程
- 先新建一个power shell窗口
- 输入
openclaw gateway run - 等待出现
- 然后新建power shell窗口输入
openclaw dashboard - 千万不要自己输网址！！！！！！！
- 千万不要自己输网址！！！！！！！
- 千万不要自己输网址！！！！！！！
安全重要提示
OpenClaw 拥有操作本地文件、浏览器、软件的权限，不要运行陌生第三方技能脚本，防止文件被篡改、泄露密钥。
个人本地使用，不要把龙虾暴露到公网，避免被远程访问。
API 密钥属于敏感信息，不要分享、不要上传到网上。
有问题欢迎在评论区讨论
