
【限时免费】专栏原价299元在2026年3月享受免费订阅专栏赶紧关注博主并关注专栏有任何疑问均可联系博主微信微信号NeumannAI作者将亲自解答并持续优化文章内容确保读者能快速上手变现赚钱虽然当前网络中部署OpenCode的教程很多但不仅包含了各种系统本地部署、服务器部署等方式还问题速查与避坑指南助力读者快速上手OpenClaw一、零代码10分钟部署Windows/Mac/Linux全攻略如果你只想在本地电脑上跑不想买服务器以下三种方式最适合你。方式一本地一键脚本最推荐新手OpenClaw官方提供了自动安装脚本自动处理环境变量和依赖。MacOS / Linuxcurl-fsSLhttps://openclaw.ai/install.sh|bashWindows (PowerShell 管理员模式)iwr-useb https://openclaw.ai/install.ps1|iex方式二Docker 部署最干净跨平台Docker部署可以隔离环境避免污染本地系统且支持一键更新 [citation:4]。# 创建持久化目录mkdir-p~/openclaw-data# 运行容器dockerrun-d\--nameopenclaw\--restartunless-stopped\-p18789:18789\-v~/openclaw-data:/app/data\-v~/openclaw-config:/app/config\-eTZAsia/Shanghai\openclaw/openclaw:latest方式三阿里云镜像部署国内加速如果Docker拉取镜像缓慢可以使用国内镜像源 [citation:4]# 拉取国内镜像示例dockerpull docker.xuanyuan.run/alpine/openclaw:2026.2.22-beta.1dockertag docker.xuanyuan.run/alpine/openclaw:2026.2.22-beta.1 openclaw:latestdockerrun-d--nameopenclaw-p18789:18789 openclaw:latest二、10分钟速通阿里云/腾讯云部署OpenClaw喂饭级教程如果你希望OpenClaw能够7x24小时运行例如用于自动化交易或全天候监控云服务器部署是首选。目前阿里云和腾讯云均提供了一键镜像部署方案全程无需写代码。1. 服务器选购指南为什么推荐2核4GOpenClaw 基于 Node.js 运行其内存消耗主要取决于加载的Skill技能数量。如果你计划安装agent-browser浏览器自动化或进行复杂的深度检索内存不足会导致进程被系统杀死OOM Kill。配置推荐2核CPU 4GiB内存 40GiB系统盘。避坑1核2G的配置仅适合测试运行agent-browser这类Skill时会明显卡顿甚至崩溃 [citation:2]。地域选择关键国内地域如北京、上海、杭州必须完成ICP备案才能通过公网域名访问Web UI。此外国内地域的轻量应用服务器联网搜索功能受限可能导致Tavily Search等Skill无法正常返回结果 [citation:2][citation:4]。推荐地域香港、新加坡、美国弗吉尼亚。这些地域无需备案且网络环境对OpenClaw的联网搜索能力更友好。阿里云默认的“美国弗吉尼亚”镜像已做好优化 [citation:3]。2. 实战演示阿里云一键部署与端口放行Step 1购买并选择镜像访问阿里云/腾讯云控制台购买轻量应用服务器。在镜像选择时直接勾选“OpenClaw (Moltbot)”应用镜像。系统会自动安装好所有依赖 [citation:1][citation:4]。Step 2放行端口防火墙配置OpenClaw默认使用18789作为Gateway端口3000作为部分旧版Web UI端口。在云服务器的“防火墙”或“安全组”规则中添加如下规则用途端口协议建议策略OpenClaw Gateway18789TCP仅允许特定IP访问如仅允许家庭IP或临时开放用于测试Web UI3000TCP同上注阿里云轻量应用服务器在“应用详情”页面通常有一键放通的按钮点击即可完成配置 [citation:3][citation:7]。Step 3配置进程守护Systemd——防止服务中断云服务器可能会重启或者OpenClaw进程可能意外崩溃。我们需要配置守护进程以确保服务自动恢复。如果使用官方镜像守护进程通常已自动配置。如果是手动安装可以使用以下命令创建Systemd服务# 创建服务文件sudotee/etc/systemd/system/openclaw.serviceEOF [Unit] DescriptionOpenClaw Gateway Service Afternetwork.target [Service] ExecStart/usr/bin/openclaw gateway start Restartalways RestartSec10 Userroot EnvironmentNODE_ENVproduction [Install] WantedBymulti-user.target EOF# 重载配置并启用开机自启sudosystemctl daemon-reloadsudosystemctlenableopenclaw.servicesudosystemctl start openclaw.service# 查看服务状态sudosystemctl status openclaw.serviceStep 4生成访问Token安全必做OpenClaw默认需要Token认证。在服务器上执行以下命令生成Token# 生成强随机Tokenopenclaw token generate--admin将生成的Token复制下来访问http://你的服务器IP:18789/?token刚才生成的Token即可进入管理界面。三、核心配置API Key与模型接入以通义千问/百炼为例要让“龙虾”具备智能必须接入大模型API。这里以阿里云百炼平台通义千问为例因为它支持OpenAI兼容接口且国内访问稳定 [citation:8]。1. 获取 API Key登录阿里云百炼控制台。点击右上角头像 -密钥管理。点击创建API-Key复制生成的Key注意关闭弹窗后无法再次查看建议保存到记事本 [citation:3]。2. 配置环境变量最安全方式为了避免API Key泄露建议将其写入环境变量或.env文件。# 编辑 OpenClaw 的环境变量文件nano~/.openclaw/.env# 在文件中添加以下内容替换成你的KeyANTHROPIC_API_KEYsk-xxxxx# 如果使用ClaudeOPENAI_API_KEYsk-xxxxx# 如果使用OpenAIDASHSCOPE_API_KEYsk-xxxxx# 百炼专用# 保存后重启服务使变量生效openclaw gateway restart3. 修改配置文件接入百炼由于百炼API地址不是标准的OpenAI地址需要修改~/.openclaw/openclaw.json[citation:8]。{models:{providers:{bailian:{baseUrl:https://dashscope.aliyuncs.com/compatible-mode/v1,apiKey:${DASHSCOPE_API_KEY},api:openai-completions,models:[{id:qwen-plus,name:Qwen Plus,reasoning:false,contextWindow:131072}]}}},agents:{defaults:{model:{primary:bailian/qwen-plus}}}}注意务必关闭reasoning思考模式否则可能导致回复为空 [citation:8]。四、避坑指南与常见报错解决方案1. 国内地域的ICP备案问题现象通过公网IP访问Web UI时被阻断或者云服务商提示未备案。解决方案如果你已经购买了国内服务器且不想备案可以利用Cloudflare Tunnel或frp内网穿透或者干脆重装系统选择香港/海外地域的镜像。联网搜索功能在国内受限严重强烈建议海外地域[citation:2][citation:4]。2. API调用限额与费用问题明明配置了Key却返回“额度不足”或“限流”。避坑阿里云百炼新用户有90天免费额度需要在控制台手动领取 [citation:8]。如果频繁调用建议订阅Coding Plan按次收费比按Token计费更省 [citation:7]。3. Docker 环境与端口占用报错Error: listen EADDRINUSE: address already in use :::18789原因旧进程未完全杀死变成了僵尸进程。解决方法# 查找占用端口的PIDlsof-i:18789# Linux/Macnetstat-ano|findstr :18789# Windows# 强制杀死进程kill-9PID# Linux/Mactaskkill /PIDPID/F# Windows如果是Docker容器记得docker stop openclaw后再docker rm openclaw再重新运行 [citation:5]。4. 命令找不到openclaw: command not found问题明明安装成功了重启终端后输入openclaw提示找不到命令。原因npm全局安装路径未加入系统PATH。解决# 查找npm全局安装路径npmroot-g# 通常在 /usr/local/bin 或 ~/.npm-global/bin# 将该路径添加到 ~/.bashrc 或 ~/.zshrcexportPATH$PATH:/usr/local/bin5. 历史命令兼容性问题执行openclaw dashboard提示command not found。原因由于项目经历了从 Clawdbot - Moltbot - OpenClaw 的更名部分旧指令可能依然有效。解决尝试使用旧指令clawdbot dashboard或moltbot dashboard代替 [citation:8]。五、维护与重启如何让龙虾“永生”场景操作指令说明后台模式启动openclaw gateway start启动网关服务关闭终端不影响运行需配合守护进程前台调试模式openclaw gateway serve前台运行用于查看实时日志CtrlC即关闭重启服务openclaw gateway restart加载新配置或更新后使用重置对话记忆在聊天窗口发送/reset清空当前会话上下文但不重启服务 [citation:5]查看日志journalctl -u openclaw -f如果配置了Systemd用此命令实时查看日志结语至此你已经完成了从选购服务器到配置AI大脑的全过程。无论是想在云上养一只7x24小时的“龙虾”还是在本地体验AI Agent的魅力上述指南都提供了明确的路径。下一步就是接入飞书、钉钉或QQ让你的OpenClaw真正开始“干活”赚钱了 [citation:6]。