教程 · 部署
本地部署 OpenClaw 龙虾：Windows / macOS / Linux 三平台照抄教程
看完介绍觉得龙虾不错，想自己装一只，可一打开终端、对着满屏命令行就开始打退堂鼓——这种心情我太懂了。其实把流程拆开看，没那么吓人。这篇给“想动手但怕折腾”的人写：Windows、macOS、Linux 三个平台分开讲，每一步都配好命令，照着抄即可。真卡住的地方，八成逃不出文末那 5 个常见报错。
先确认：你要走哪条路
龙虾本体很轻，真正决定难度的是“大脑”怎么接。开始之前先想清楚一件事：
- 走 API（推荐新手）：本机不需要显卡，配置里填一个 Claude / GPT 这类的 key，模型在云端算。任何一台能上网的电脑都能跑。
- 本地跑模型：数据不出本机、长期免费，但需要一块像样的显卡（显存 8G 起步，跑得舒服建议 16G+），还要额外装一个本地推理工具。
这篇主线按“走 API”讲，因为对新手最稳；接本地模型的分支放在后面单独说。
环境准备（三平台通用）
不管哪个系统，龙虾要跑起来需要这几样：
- Python 3.10 或更新——智能体主程序的运行环境。
- Node.js——很多工具（浏览器自动化、MCP 套件）依赖它。
- Git——用来把源码拉下来。
先在终端里挨个查一下版本，有输出就说明装好了：
python --version
node --version
git --version哪个没输出就先去对应官网装哪个。下面按系统给最省事的装法。
macOS
有 Homebrew 的话一条命令搞定，没有就先装 Homebrew：
# 用 Homebrew 一次装齐
brew install python node gitLinux（以 Debian / Ubuntu 为例）
sudo apt update
sudo apt install -y python3 python3-venv python3-pip nodejs npm gitWindows
两个选择。怕麻烦就开 WSL2，然后完全按上面的 Linux 步骤走，坑最少：
# 管理员身份开 PowerShell，装好后重启
wsl --install不想用 WSL，就去 Python、Node.js、Git 三个官网各下一个安装包，装的时候记得勾上“加入 PATH”。装完重开一个终端再查版本。
把龙虾拉下来、装依赖
这一步三平台一样。先克隆源码，进目录，建一个独立的虚拟环境（避免把依赖装乱），再装依赖：
# 1. 拉源码（仓库地址以你实际找到的为准）
git clone https://github.com/<openclaw-repo>.git
cd openclaw
# 2. 建并激活虚拟环境
python -m venv .venv
# macOS / Linux:
source .venv/bin/activate
# Windows PowerShell:
.\.venv\Scripts\Activate.ps1
# 3. 装依赖
pip install -r requirements.txt
# 如果项目还带前端 / Node 工具
npm install这一步会下载一堆包，慢是正常的。中间不报红，跑到提示符回来，就算成功。
给它接一个“大脑”
龙虾本体没智商，得告诉它用哪个模型。配置一般在项目根目录的一个示例文件里，先把它复制成正式配置：
cp .env.example .env # Windows 用 copy .env.example .env然后用文本编辑器打开 .env，按你选的路填。
路 A：填闭源 API key
去模型服务商后台拿一个 key，填进去。大致长这样（字段名以项目文档为准）：
MODEL_PROVIDER=anthropic
MODEL_NAME=claude-...
API_KEY=sk-你的密钥路 B：接本地模型
先用本地推理工具把模型拉起来（比如把一个开源模型起成本地服务），再让龙虾指向那个本地地址：
MODEL_PROVIDER=local
MODEL_NAME=你拉起来的模型名
API_BASE=http://localhost:11434两条路只填一条。哪个模型当大脑更顺手，我们在 AI 模型榜 按工具调用稳定性、长任务连贯性、中文表现和成本打了分，挑之前可以先看一眼。
跑通第一条任务
配置存好，启动主程序：
python main.py # 具体入口文件看项目 README起来之后给它一句最小指令，先别上来就让它干大活：
在当前目录新建一个 hello.txt，写一行“龙虾你好”，然后读出来念给我听如果它真的建了文件、写了字、又读回来复述给你——恭喜，模型连通、工具调用、循环执行三件事全通了，剩下就是堆更复杂的任务。
常见报错 5 条
1. command not found: python / git
原因：没装，或装了但没加进 PATH（Windows 高发）。解决：重装时勾“加入 PATH”，装完重开终端。macOS 上有时是命令叫 python3 不叫 python。
2. pip install 卡住或超时
原因：默认源在境外，下载慢。解决：换一个国内镜像源再装，pip install -r requirements.txt -i 镜像地址，速度会快很多。
3. ModuleNotFoundError: No module named ...
原因：依赖没装全，或者你没激活虚拟环境就跑了主程序。解决：确认终端提示符前面有 (.venv) 字样，没有就重新 activate 一遍，再 pip install。
4. Authentication / 401 错误
原因：API key 填错、过期，或账户没额度。解决：回服务商后台核对 key 是否完整（别漏字符），看账户余额，再确认 .env 里字段名拼对了。
5. 它能聊天但不动手
原因：模型连上了，但工具没开或权限没给。解决：检查配置里工具是否启用，第一次跑很多项目会弹权限确认，得手动放行它读写文件。这不是 bug，是安全设计。
常见问题
- 没有显卡能装 OpenClaw 吗？
- 能。走 API 这条路就行——龙虾本体不吃显卡，吃显卡的是本地模型。配置里填一个闭源 API 的 key，活儿发给云端算，普通笔记本完全够用。
- Windows 上装一直报错怎么办？
- 最省事是开 WSL2 再按 Linux 步骤走，坑少很多。坚持用原生 PowerShell 也行，但要先装好 Python、Node、Git，并以管理员身份开终端。
- 装好后怎么确认它真的能用？
- 给它一条最小任务：新建文件、写一行、再读回来念给你听。这一整圈能跑通，说明连通、工具调用、循环执行都没问题。