先回答一个很多人实际遇到的困惑网上聊OpenClaw的人很多但教程写得太散了要么只讲原理不给步骤要么给了一堆命令但跑不通。我自己第一次部署也折腾了快两个小时卡在各种小细节上——Node版本不对、APIKey填错位置、baseURL少了个尾巴、装上之后不知道怎么确认它真的活了。后来在华为云上反复试了几次把流程理顺之后发现真正要动手的步骤就那么几步。这篇文章就把完整流程写清楚从华为云服务器准备、百炼平台APIKey获取到OpenClaw安装、模型接入、后台守护一次讲透。先说结论只要服务器和APIKey提前备好从执行安装命令到OpenClaw正常应答确实可以在1分钟内跑通。下文所有命令我都按当前主流版本实测过你照着操作就行。1. 先别急着装OpenClaw解决什么问题以及为什么必须上云1.1 一句话理解OpenClaw能动手干活的AI代理而不是聊天框很多第一次接触OpenClaw的朋友容易把它和ChatGPT、通义千问这类对话机器人搞混。插一句我在实际测试中的理解OpenClaw本身不提供大模型能力它是一个代理框架负责调度各种工具核心差异在于它可以直接执行命令、读写文件、调用外部接口再配合一个大模型的推理能力形成一个感知—决策—行动的闭环。打个比方普通聊天机器人像一个只会给建议的顾问你问它帮我整理一下当前目录的文件它只会告诉你该用什么命令然后让你自己复制粘贴去执行OpenClaw则像一个真的会动手的助理你吩咐完之后它会自己调用Shell工具去查看目录、分析文件内容、按你的要求处理然后把结果汇报给你。它的价值就在这个动手上——这也是为什么很多人叫它AI Agent框架而不是聊天机器人。1.2 为什么我建议把它部署在云服务器而不是自己电脑上第一次尝试OpenClaw大多数人会在自己电脑上装。我之前也这么干过然后很快就发现几个现实问题笔记本一合上服务就断了任何定时任务、消息响应全部失效即使不关电脑家里的宽带IP不固定后续接入IM机器人、Webhook这类场景时很不好配置另外本地电脑运行AI代理会持续占用CPU和内存风扇呼呼转办公的时候体验很糟。转去云服务器之后这些问题一次性全解决了。以华为云为例买一台最基础的2核4G弹性云服务器跑OpenClaw加操作系统资源完全够用。它有固定的公网IP只要服务器不欠费服务就是7x24小时在线你在任何地方通过终端访问它晚上睡觉时它照样能处理任务。至于为什么是华为云而不是别家我的判断就三条新用户活动价便宜国内访问稳定控制台自带CloudShell不用在本地装额外的SSH工具也能登录服务器。服务器厂商跟大模型平台本来就是两回事你完全可以用华为云的服务器去接任何一家大模型的API本文就是用华为云服务器接阿里云百炼平台的大模型接口。2. 部署前准备华为云服务器、百炼APIKey和环境检查2.1 华为云ECS选购选什么规格、开哪些端口登录华为云控制台搜索弹性云服务器ECS进入购买页。新手最容易在镜像、规格这些选项上纠结我直接给你一套经过验证的配置组合配置项推荐选择说明计费模式按需计费先按小时付费练手跑通后再转包年包月省钱区域离你最近的城市节点例如你在华南就选广州延迟低一些镜像Ubuntu 22.04 LTS比CentOS包管理更省心后续装Node.js少踩坑规格2核4G跑OpenClaw模型调用足够1核2G会比较紧张登录凭证设置root密码别用密钥新手用密码登录最直观安全组入方向放行22、300022是SSH登录用3000是OpenClaw管理界面备用这里重点说下安全组。安全组相当于云服务器的防火墙很多人部署完了发现服务有问题排查半天最后发现是安全组没放行端口。入方向规则里至少要把22端口SSH远程登录和3000端口放行如果你后续还会给OpenClaw配Web面板或API服务再把80和443也加上。只放行你用得到的端口就好别图省事全部放开安全习惯要养好。购买完成后云服务器会给一个公网IP。下面所有操作都需要用到这个IP建议直接复制保存到备忘录。2.2 百炼平台APIKey从注册到拿到密钥的完整路径OpenClaw本身没有大模型能力你必须给它接一个大模型的API才能让它思考。国内使用我最推荐的还是阿里云百炼平台。百炼上能直接用通义千问的qwen系列和DeepSeek系列模型接口兼容OpenAI格式OpenClaw原生支持不需要额外写适配层。获取APIKey的完整流程用阿里云账号登录百炼控制台。没有账号就先用手机号注册需要实名认证提前准备好身份证信息。进入控制台后找到API-KEY管理页面。通常在右上角头像下拉菜单或左侧菜单里能找到。点击创建API-KEY系统会生成一串以sk-开头的字符串。立刻复制保存。这串Key只在创建时完整显示一次关掉页面再想看就只能删了重建。同时记下百炼的baseURL接口地址https://dashscope.aliyuncs.com/compatible-mode/v1这个地址末尾的/v1非常关键OpenClaw和很多AI工具都按照OpenAI的/v1接口规范去拼接地址漏掉末尾的/v1请求会直接404。APIKey就是你的调用凭证相当于银行卡密码谁拿到它就能用它调用模型产生费用务必不要写进博客、GitHub仓库或者聊天对话里。2.3 服务器登录后的第一轮检查准备工作做完了下一步是登录服务器。这里我不推荐本地再装一个Xshell之类的工具华为云控制台自带的CloudShell足够用了——浏览器里就能打开终端免去了本地配置SSH客户端的功夫。登录之后先确认三件事whoami node -v npm -v第一条确认当前是root用户华为云默认是后面两条确认Node.js和npm是否已安装。OpenClaw是Node.js生态的项目对运行时版本有要求最好在Node 20以上。如果node -v报错或版本低于18先不用继续往下看直接跳到下一节把Node环境装好再回来。3. 实操部署两条命令装好OpenClaw3.1 装Node.js版本对了后面才不折腾如果你检查完发现没装Node或者版本太老用下面这套命令装最新LTS版本。注意这套命令针对Ubuntu系统CentOS请自行去找对应的安装方式curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt-get install -y nodejs第一条命令是把NodeSource的软件源添加进系统第二条是安装。整个过程大概几十秒到一两分钟取决于服务器带宽。装完再验证一次node -v npm -v看到v20.x.x这样的输出就说明环境正常了。3.2 npm安装OpenClaw网络慢就切镜像源Node环境就绪后调用npm全局安装OpenClawnpm install -g openclaw就这么一条命令。因为OpenClaw依赖的包数量不少首次安装可能耗时稍长。如果你发现进度条很慢或者直接卡住大概率是npm默认源在国内访问不畅先切到国内镜像源再装npm config set registry https://registry.npmmirror.com再重新执行安装命令。镜像源只影响下载速度不影响OpenClaw本身的功能可以放心用。装完之后验证一下openclaw --version能输出版本号说明主程序已经装好。到这里其实你已经完成了整个部署流程最核心的一步从执行安装命令到验证通过确实用不了1分钟。3.3 首次启动交互面板里该怎么选OpenClaw安装好之后直接在服务器上运行openclaw首次启动会进入一个交互式引导面板类似打字机的效果让你配置基础选项。因为不同版本界面会有些差异我重点说下几个关键选项的选择思路渠道/Channel这是OpenClaw连接外部世界的通道。第一次跑通选Terminal终端就够了先让服务跑起来再说。微信、Telegram这类IM渠道可以后续再加。模型提供商/Provider选OpenAI兼容模式或者叫自定义API。我们把百炼当作一个OpenAI兼容的接口接入所以选这个最匹配。模型名称/Model填百炼上的具体模型名比如qwen-plus。这个字段千万别乱填模型名不对后面调用必然报错。引导完成之后OpenClaw会进入一个带输入框的交互面板看起来像一个终端版的聊天界面。到这里程序已经跑起来了但如果你用的是百炼的APIKey还差最关键的一步——把APIKey和baseURL告诉OpenClaw。IS第4节做的事。4. 接入百炼大模型APIKey、baseURL和模型选择4.1 环境变量写入OPENAI_API_KEY和OPENAI_BASE_URL缺一不可OpenClaw默认是按OpenAI官方的API地址来请求的也就是https://api.openai.com/v1。我们在国内用百炼需要把它的请求地址改到百炼的兼容接口同时把APIKey换成自己的。在OpenClaw中这两项通过环境变量管理。直接在终端里用命令设置openclaw env set OPENAI_API_KEY sk-你的百炼APIKey openclaw env set OPENAI_BASE_URL https://dashscope.aliyuncs.com/compatible-mode/v1第一条命令把APIKey写进OpenClaw的配置第二条把接口地址重定向到百炼。这两个变量缺一个都不行不写APIKey鉴权过不了不改baseURL请求会发到OpenAI官方海外地址本地网络大概率超时。设置完后重启OpenClaw先CtrlC停掉再重新运行openclaw配置才会重新加载。4.2 模型选择qwen-plus、qwen-max、deepseek怎么选百炼平台上可选的模型很多我在实际使用中的经验是模型适合场景特点qwen-turbo高频、简单任务便宜、响应快qwen-plus日常对话、工具调用、绝大多数场景性价比最高我主力用它qwen-max复杂推理、代码生成、长文本效果最好价格也最高deepseek-v3系列需要DeepSeek风格回复时在百炼上也能直接调用如果你不确定选哪个先从qwen-plus开始。它能力均衡OpenClaw这种工具调用密集型场景下表现稳定不容易因为模型太弱导致Agent执行任务时逻辑混乱。后面跑熟了再用/model命令在会话中随时切换模型对比效果。4.3 配置生效检查改完环境变量怎么判断接没接通重启OpenClaw进入交互面板后先不要急着安排任务做一次最基础的连通性测试。在输入框里输入hey openclaw这是OpenClaw的唤醒词。如果安装配置正常它会自动进入监听状态。接着输入你好简单介绍一下你自己如果模型接入成功OpenClaw会基于qwen或deepseek的能力生成一段自我介绍并显示在面板上。如果你看到的是超时、404、401类的报错按5.3小节的排查表逐项检查八成是baseURL末尾漏了/v1或者APIKey多了个空格。5. 部署完的收尾验证运行、后台常驻与排错5.1 完整链路验证让OpenClaw动手做第一个任务连通性测试通过后做一次真正的动手测试。在交互面板里输入hey openclaw看看当前目录下有哪些文件列出来这句话会触发OpenClaw的完整工作链路它先让模型理解你的意图然后调用Shell工具执行ls命令工具调用再把命令结果返回给模型整理成人类可读的回复结果摘要最后输出到面板。看到它能正确列出目录内容并且回复里带了对文件的分析说明说明整条链路完全跑通了。我再多做一个更强的测试——让它执行一个有副作用的操作比如创建文件hey openclaw在 /tmp 目录下创建一个叫 test.txt 的文件内容写hello执行完用cat /tmp/test.txt确认文件确实存在。这一步能验证OpenClaw不只是嘴上说说而是真的在调用工具操作服务器。5.2 让OpenClaw在服务器上稳定常驻nohup和systemd两种保活方案在交互面板里跑着的OpenClaw一旦终端断开、SSH会话结束进程就会跟着退出。所以部署的最后一步是让它脱离当前终端作为后台服务长期运行。想尽快跑起来用nohup最简单的方案nohup openclaw /root/openclaw.log 21 这条命令的意思是让OpenClaw在后台运行日志统一写到/root/openclaw.log里就算关掉SSH窗口它也不会停。更正规的方案是注册成systemd服务好处是开机自启、崩溃自动重启。创建服务文件vim /etc/systemd/system/openclaw.service写入以下内容[Unit] DescriptionOpenClaw AI Agent Afternetwork.target [Service] Typesimple Userroot WorkingDirectory/root/.openclaw ExecStart/usr/bin/openclaw Restarton-failure RestartSec10 [Install] WantedBymulti-user.target注意ExecStart的路径。可以用which openclaw命令查一下实际路径不同安装方式可能路径不一样填错了服务会启动失败。保存后依次执行systemctl daemon-reload systemctl enable openclaw systemctl start openclaw查看运行状态systemctl status openclaw显示active (running)就说明服务常驻成功。以后这台华为云服务器里的OpenClaw就会一直在线断电重启也会自动拉起。5.3 高频报错新手必踩的5个坑和处理办法我在反复部署和帮朋友排查的过程中把这几个最常见的坑汇总成了一张表遇到问题直接对着查症状根因解决办法openclaw: command not foundnpm全局bin目录没加到PATH重开终端或执行export PATH$PATH:$(npm prefix -g)/bin请求超时/连接失败baseURL没设置或指向海外地址执行openclaw env set OPENAI_BASE_URL https://dashscope.aliyuncs.com/compatible-mode/v1返回404baseURL末尾漏了/v1确认baseURL以/compatible-mode/v1结尾返回401/InvalidApiKeyAPIKey复制多了空格或已过期重新执行openclaw env set OPENAI_API_KEY注意去空格报model not found模型名写错通道里没有对应模型到百炼控制台确认模型名称再使用/model切换还有一个升级场景容易踩旧版本OpenClaw升级后可能提示legacy exec approvals exist at /root/.openclaw/exec-approvals.json这类信息。这说明你本地有一份旧格式的执行审批配置系统在等你迁移。按提示运行openclaw migrate它会自动把旧配置转换成新格式。手动删除这个文件也行但会丢失你之前设置过的所有命令审批规则所以建议还是乖乖执行迁移命令。最后提醒一点APIKey是花钱的百炼控制台里有消费额度设置建议给自己设一个每月消费上限比如50块钱到达阈值就停止计费。毕竟AI代理跑起来之后它自动执行任务产生的token消耗会比手动聊天快得多这一步别省。我自己的实际体会是OpenClaw这类AI代理框架最值钱的用法不是拿它当高级聊天机器人而是把那些重复性的、需要看一眼-想一想-动一下的工作交给它。部署只是第一步跑通之后可以慢慢扩展渠道、接自定义工具、配定时任务让这个数字员工真正干起活来。