部署前,先想清楚走哪条
两条路,选一条:
本地部署——装在自己电脑上,权限最大,能控制本地文件、浏览器、剪贴板。完整版。
云端部署——装在服务器上,7×24在线,手机也能随时调用。适合不想开着电脑的人。
本地部署解锁100%能力。云端大约只有20%。
想认真用,选本地。想先体验,选云端。
下面两条路都讲,按你的情况看。






路线一:本地部署(Windows / Mac / Linux 通用)
第一步:确认环境
打开终端(Windows用PowerShell,Mac用Terminal),输入:
node -v
显示版本号就行,要求 Node.js 18以上。
没装Node?去 nodejs.org 下载LTS版本,装完重新打开终端。
第二步:安装OpenClaw
Windows用户,在PowerShell里运行:
iwr -useb https://openclaw.ai/install.ps1 | iex
Mac / Linux用户,在Terminal里运行:
curl -fsSL https://openclaw.ai/install.sh | sh
国内网络慢?先配一下npm镜像:
npm config set registry https://registry.npmmirror.com
然后再手动装:
npm install -g openclaw@latest
安装完后,终端输入 openclaw 能出帮助信息,说明装好了。
第三步:初始化配置(最关键的一步)
运行:
openclaw onboard
会进入交互式向导,用键盘上下键选择,回车确认。
第一个提示:风险告知
I understand this is powerful and inherently risky. Continue?
选 Yes,继续。
第二个提示:启动模式
选 Quick Start(快速开始)
第三个提示:选择大模型
这里是关键。按你的情况选:
有科学上网Claude / GPT-4
纯国内环境阿里云百炼 / 智谱Z.AI / Kimi
想省钱Minimax(有包月,稳定)
选完会让你输入API Key。
粘贴你的Key,回车确认。
Key怎么拿?去对应平台官网注册,找"API密钥"或"密钥管理",创建一个复制就行。
第四步:后续选项,新手全选跳过
安装完模型配置后,会问你:
是否安装Skills技能包?→ No(先跳过)
是否接入Telegram/Discord?→ No(先跳过)
端口设置?→ 直接回车默认18789
这些在图形界面里都能后续调整,别被这步卡住。
第五步:启动并验证
配置完成后,启动控制台:
openclaw dashboard
浏览器自动打开控制台界面。
测试一下,输入:
帮我新建一个叫test的文件夹
如果电脑上真的出现了这个文件夹——
部署完成。


路线二:云端部署(零基础最省事版)
用Zeabur,最低$2起
第一步:去 图片找地址 注册账号,支持支付宝/微信。
第二步:进控制台 → 新建项目 → 选模板 → 搜索 openclaw → 直接部署。
第三步:等项目激活(约1-2分钟),点击终端,输入:
openclaw onboard
后续流程和本地一样,按上面路线一的第三步操作。
用阿里云,官方镜像更省心
阿里云已经出了OpenClaw专属镜像,依赖全部预装好了。
:aliyun.com/activity/ecs/clawdbot
选配置:
镜像:OpenClaw (Moltbot)
地域:美国弗吉尼亚(国内服务器联网搜索受限)
配置:最低的那档够用
部署完成后,三步收尾:
进入"应用详情":
放通端口:放行18789端口,一键操作
配置API Key:填入你的百炼或其他模型Key
生成Token:执行命令,复制访问Token
打开控制台链接,能对话就完成了。
装完之后,先做这一件事
打开控制台,找到Workspace目录下的 USER.md 文件。
这是你告诉小龙虾"你是谁"的地方。
写几行:你的身份、你的工作、你常用的任务类型。
比如:
我是加密货币内容创作者,每天需要整理链上数据、写Alpha日报、分析热门代币。
常用平台:币安广场、Twitter。
语言风格:简洁,不废话,有观点。
写完之后,它会越用越懂你。
这个文件,是它的"记忆起点"。




常见报错,对照处理
报错:No API key found
别在 openclaw.json 里直接写Key,新版本不认。
正确做法:
openclaw config set zai:default.secret sk-你的Key
或者手动创建文件:
路径:C:\Users\用户名\.openclaw\agents\main\agent\(Windows)
文件内容:
{ "zai:default": { "secret": "sk-你的Key" } }
服务突然断了,网页打不开
不要刷新。
重新打开终端,依次执行:
# 先停掉
Ctrl + C
# 重启网关
openclaw gateway
# 重新打开控制台
openclaw dashboard
网络超时,依赖装不上
先设置国内镜像:
npm config set registry https://registry.npmmirror.com
如果还是慢,开TUN模式的科学上网,让终端流量也走代理。
小龙虾有真实的系统权限。
它能删文件,能发邮件,能操作你的浏览器。
所以:
给它创建专用的次级账号(专用Gmail、专用飞书Bot),不要用主账号
设置工作目录限制,别让它乱跑
API Key不要给全权限,按需开通
云端部署后,关闭公网直接访问,设好Token验证
如果不相信可以去看看前段时间给人转了十几万u的老哥
最后

装好之后,第一个任务建议是这个:
帮我搜索今天BTC的主要新闻,整理成5条要点
跑通了,你就明白为什么25万人给它点了星。
币安大赛截止3月18日,时间够。