1. 为什么大家都在折腾 OpenClaw 这只“龙虾”OpenClaw社区里习惯叫它“龙虾”是一款开源的 AI 智能体框架它能帮你处理邮件、管理日程、写代码、做数据分析甚至自动完成一些重复性的办公任务。和普通聊天机器人最大的区别在于它不只是“回答问题”而是能调用工具、读写文件、连接外部服务真正把一件事从头做到尾。适合谁适合想拥有一个 7×24 小时在线私人助理的普通用户也适合想研究 Agent 架构的开发者。但很多人卡在第一步部署。官方文档偏工程化小白看到一堆命令行就懵了。我试过从零开始在一台干净机器上跑通也踩过端口占用、API Key 配错、云端连不上的坑。这篇指南就按“本地先跑通再平滑迁到云端”的思路把每一步拆到能直接复制粘贴。核心检索词先记住OpenClaw 部署、AI 智能体本地部署、云端部署。你不需要懂多少运维跟着做就行。整条路径分三段本地环境准备 → 本地跑通并验证 → 迁移到云服务器实现常驻。中间会用到模型 API 来给“龙虾”装上大脑这里我用 TaoToken 作为统一接入层因为它把多家模型的 Key 和 Base URL 收敛成一套配置本地和云端可以共用同一份配置迁移时几乎不用改代码。下面从环境准备开始。2. 部署前的环境准备与模型接入前置2.1 系统要求与依赖清单OpenClaw 本体是个 Node.js 应用所以第一件事是确认你的机器满足最低要求。下面这张表是我实测下来比较稳的配置低于“最低”会频繁报错建议直接按“推荐”来。项目最低配置推荐配置CPU2 核心4 核心内存4GB8GB磁盘10GB 可用20GB SSD网络稳定连接带宽 ≥10Mbps系统Win10/11、macOS 12、Ubuntu 20.04同左Node.jsv18.0v20.0Node.js 版本一定要检查很多人失败就是因为系统自带的是 v16。用下面命令确认node -v npm -v如果低于 v18去 Node.js 官网下 LTS 版本重装。Windows 用户注意安装脚本必须在管理员模式的 PowerShell 里跑否则依赖装不进去。2.2 给“龙虾”装大脑模型 API 怎么选OpenClaw 本身只是框架不接大模型它不会干活。你需要一个模型 API Key。选择上有两条路一是用各家云厂商的免费额度二是用本地 Ollama 跑开源模型完全免费但吃硬件。不管选哪条最终都要在 OpenClaw 里填三样东西Base URL、API Key、Model ID。这里我推荐用 TaoToken 做统一接入。原因很实际本地部署时你填一次配置迁到云端时同一份配置直接复用不用因为换了机器就重新对一遍各家平台的文档。TaoToken 的 API 地址是https://taotoken.net/api兼容 OpenAI 的接口格式OpenClaw 里选 “OpenAI Compatible” 就能接。先去控制台创建一个 API Key路径是登录后进入 API Keys 页面新建。拿到 Key 之后先别关页面后面配置要用。如果你想先验证模型通不通可以用模型对话页面直接发一条测试消息确认 Key 有效再往下走。注意API Key 只显示一次复制后存到安全的地方。不要直接写进会提交到 Git 的配置文件里后面我会讲怎么用环境变量隔离。2.3 终端工具准备Windows 用 PowerShell管理员模式macOS 和 Linux 用自带终端即可。如果你打算用 Docker 部署还需要提前装好 Docker Desktop 或 Docker Engine。这些装完前置就齐了。3. 本地部署一键脚本与可复制配置3.1 Windows 一键部署以管理员身份打开 PowerShell执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex如果下载慢可以换镜像源。等待 3–5 分钟脚本会自动完成环境检测、依赖安装和路径配置。装完后初始化openclaw onboard --install-daemon交互过程里几个关键选择风险提示选 Yes模式选 Quick Start模型服务商选 “OpenAI Compatible”因为我们用 TaoToken 统一接入粘贴刚才创建的 API Key其余选项先选 No最后选 “Open the Web UI”。浏览器会自动打开http://localhost:3000看到龙虾面板就说明本地跑通了。3.2 macOS / Linux 一键部署终端里执行curl -fsSL https://openclaw.ai/install.sh | bash看到 “OpenClaw installed successfully” 即成功。接着同样跑openclaw onboard --install-daemon完成初始化然后启动服务openclaw gateway start openclaw dashboard访问http://localhost:3000即可使用。3.3 核心配置文件把模型接进来OpenClaw 的模型配置集中在一个 JSON 文件里路径通常是~/.openclaw/config.jsonWindows 在%USERPROFILE%\.openclaw\config.json。下面这份是我实测可用的片段把apiKey换成你自己的即可。注意 Base URL 用的是 TaoToken 的 API 地址Model ID 按你实际开通的模型填{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: YOUR_TAOTOKEN_API_KEY, api: openai-completions, models: [ { id: claude-sonnet-4-5, name: claude-sonnet-4-5, contextWindow: 200000, maxTokens: 64000, input: [text, image] }, { id: gpt-4.1, name: gpt-4.1, contextWindow: 128000, maxTokens: 32000, input: [text, image] } ] } } }, agents: { defaults: { model: { primary: taotoken/claude-sonnet-4-5 }, models: { taotoken/claude-sonnet-4-5: {}, taotoken/gpt-4.1: {} } } }, gateway: { mode: local } }三件套对照记牢Base URLhttps://taotoken.net/apiAPI Key 你在控制台创建的那串Model ID 上面 models 数组里的id字段。三者缺一不可写错任何一个都会在启动时报错。3.4 用环境变量隔离密钥推荐直接把 Key 写进 config.json 有泄露风险。更稳的做法是用环境变量然后在配置里引用。Linux/macOS 在~/.bashrc或~/.zshrc里加export TAOTOKEN_API_KEY你的KeyWindows 在系统环境变量里新建同名变量。然后把 config.json 里的apiKey改成${TAOTOKEN_API_KEY}。这样配置文件可以安全地备份或分享Key 不会跟着跑出去。3.5 启动并确认服务状态配置改完后重启网关让配置生效openclaw gateway restart openclaw gateway status状态显示 running 就对了。如果显示 stopped先看日志再排查别急着重装。4. 验证请求确认“龙虾”真的能干活配置写完不代表能用必须发一次真实请求验证。有三种验证方式从简到繁。4.1 命令行快速验证OpenClaw 自带 doctor 命令会检查配置、依赖和模型连通性openclaw doctor --fix如果模型配置有问题这一步会直接报出来比如401 Unauthorized就是 Key 错了model not found就是 Model ID 写错了。这是最快的排障入口。4.2 Web UI 对话验证打开http://localhost:3000在对话框里发一句“你好帮我列一下今天可以做的三件事”。如果龙虾正常回复说明模型链路通了。如果转圈很久最后报错去终端看日志openclaw logs日志里会明确告诉你卡在哪一步。4.3 用 curl 直接打 API 验证想更底层地确认 TaoToken 这条链路通不通可以直接 curlcurl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: ping}] }返回里有choices字段和内容就说明 Key、Base URL、Model ID 三件套全部正确。这一步过了本地部署基本就稳了。4.4 本地跑通后的收尾本地验证通过后建议做两件事一是把 config.json 备份一份云端迁移时直接复用二是记下你用的 Model ID云端配置要保持一致。到这里本地阶段完成可以进入云端迁移。5. 云端部署与常见报错排查5.1 云服务器准备以阿里云 ECS 为例腾讯云、华为云操作类似。购买时选 2 核 4GB、Ubuntu 22.04 系统、带宽 1Mbps 以上。关键一步是安全组放行端口3000Web UI、18789API 网关、4317监控。不放行的话本地能跑云端访问不了这是最常见的“部署成功但打不开”的原因。用 SSH 连上服务器后安装脚本和本地一样curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon初始化时模型配置直接粘贴本地那份 config.json 的内容或者把本地文件 scp 上去。设置开机自启sudo openclaw gateway install openclaw --version然后浏览器访问http://服务器公网IP:3000。能打开面板云端就通了。5.2 常见报错对照排查下面这几个是我和社区里出现频率最高的错误对照着查能省很多时间。401 Unauthorized / invalid api keyAPI Key 错了或过期。检查 config.json 里的 Key 是否和 TaoToken 控制台一致注意别把前后空格复制进去。用环境变量的话确认变量在当前 shell 里echo $TAOTOKEN_API_KEY有值。local proxy failed / connection refusedBase URL 写错或者网络到不了。确认写的是https://taotoken.net/api不是首页地址。云端服务器如果出网受限检查安全组出方向规则。reading choices: unexpected end of JSON input请求发出去了但返回体不完整通常是 Model ID 不存在或该模型没开通。去 TaoToken 控制台确认模型列表把 config.json 里的id改成实际可用的。OAuth / token expired如果你用的是带 OAuth 的模型服务token 过期了。重新走一遍授权或者换成 API Key 方式接入后者更省心。端口占用lsof -i:3000查出占用进程kill -9 进程ID干掉或者改端口openclaw config set gateway.port 18789。Web UI 加载慢清浏览器缓存或换 Chrome。云端的话检查带宽是不是被占满了。5.3 Docker 部署稳定隔离方案如果你不想污染宿主机环境Docker 是最省心的docker pull openclaw/openclaw:latest docker run -d -p 3000:3000 -p 18789:18789 --name openclaw openclaw/openclaw:latest docker exec -it openclaw bash openclaw onboard容器里配置模型时同样填 TaoToken 三件套。Docker 的好处是迁移时把镜像和配置一打包换台机器直接跑环境差异带来的坑少很多。5.4 安全与优化建议云端常驻意味着暴露在公网几件事必须做API Key 用环境变量隔离别硬编码安全组只放行必要端口3000 端口建议加访问白名单或套一层反向代理定期备份 config.json关掉用不到的 Skills 减少攻击面。做到这几条7×24 小时在线就比较安心了。6. 把“龙虾”用起来接入与长期使用建议本地和云端都跑通之后接下来就是让它真正帮你干活。如果你主要在终端里写代码、跑 Agent 任务可以看看 Coding Plan它把常用编码模型的额度打包长期用比单次调用划算。配置方式还是那三件套Base URL 填https://taotoken.net/apiKey 用你创建的Model ID 按套餐里开通的填。如果你更想先体验模型能力再决定直接去模型对话页面发几条消息确认响应速度和效果符合预期。接入过程中遇到配置问题接入文档里有各客户端的完整示例包括 Claude Code、Cline 这类工具的填法照着改 Base URL 和 Key 就行。最后给一个实用技巧本地和云端共用同一份 config.json用环境变量区分 Key。这样你在本地调试好的 Agent 行为迁到云端后表现完全一致不会出现“本地好好的云端就抽风”的情况。部署这件事一次配好、处处复用才是真的省心。