阿里云部署：从零跑通模型接入与Skill配置)
把OpenClaw也就是大家说的Clawdbot部署到阿里云这件事我前后折腾了三遍才真正理解官方文档想表达什么。老实说项目本身装起来并不难真正难的是第一次上手时面对一堆不熟悉的名词Skill、Agent、Companion、模型接入、Dashboard很容易在环境准备阶段就被劝退。这篇我用最直白的方式把从零起步到跑通完整流程的记录给你理一遍目标很明确跟着操作让OpenClaw在阿里云上跑起来并且能接到你想要的大模型上。如果你是第一次接触这篇会帮你少走我踩过的弯路如果你已经装过但某些环节一直卡着直接跳到后面的问题排查部分大概率能找到对应的解法。1. OpenClaw与Clawdbot是什么为什么值得折腾1.1 这个项目到底解决了什么问题OpenClaw项目里也常写作Clawdbot本质上是一个AI代理Agent编排框架你可以把它理解成一个中间人它负责连接大模型和你的实际任务然后以对话、定时任务、脚本等方式把模型输出的能力落到底层系统上。很多人第一次听到它的反应是这不就是个套壳聊天机器人吗实际用下来完全不是一回事。它能做的典型事情包括给Agent挂上各种工具型Skill让Agent在收到指令后自动执行脚本、读取本地文件、调用外部API、按照固定节奏跑数据抓取甚至配合桌面客户端去操作本地应用。我为什么专门说它解决了问题因为普通的对话式AI产品只能停在回答问题这一层。而OpenClaw的价值在于把回答你变成帮你去执行。比如你可以给它布置一个任务每天早上9点检查服务器磁盘使用率超过80%就在钉钉群里发一条告警消息。这种任务不需要人盯着配置好之后它自己会跑。所以它最适合的人群有两类一是重度使用AI但受不了反复复制粘贴的人二是像我这样喜欢把AI接入自动化流程、想省掉大量重复操作的开发者。1.2 为什么部署到阿里云而不是本地电脑我最早是在本地Windows上试着跑的后来发现还是放服务器上更香。原因很现实本地环境下电脑一关、网络一断或者那个烦人的WSL2环境出点问题服务就跟着断了。放到阿里云上之后它变成了一台7×24小时在线的服务我随时用浏览器登录后台不用操心电脑睡眠、重启、休眠这些破事。另外还有一个关键原因OpenClaw这类工具最终是要调用模型的。如果你在本地部署模型API的请求要从你自己的网络出去稳定性完全取决于你的宽带而部署在阿里云上云服务器到各家模型API服务的网络链路通常更稳响应速度也更可控。再加上阿里云本身有百炼平台、通义千问系列模型可以直接对接整个生态是闭环的。成本上也不用担心一台2核4G的ECS按量付费一天也没多少钱比在本地折腾半天浪费的时间划算多了。2. 安装前需要准备的几样东西2.1 服务器规格与系统选择很多人在第一步选配置上就犹豫半天。我的建议很简单个人玩或小团队试用选2核4G的ECS实例就够了系统镜像用Ubuntu 22.04 LTS或者Alibaba Cloud Linux 3。别一上来就买4核16GOpenClaw本身是个Node.js/Python混合生态的服务不吃资源真正吃资源的是你挂载的模型推理而那个一般不在OpenClaw进程里跑。如果你打算用Ollama在服务器本地跑模型比如跑Qwen2.5-3B这种小参数模型那建议把内存加到8G其余保持默认。这里再补充一个对比配置项轻量应用服务器ECS云服务器适合场景个人尝鲜、低并发正经使用、要长期跑任务面板易用性自带简单防火墙、图形面板需要自己理解安全组规则升级灵活性固定套餐扩展有限随时升配、降配折腾价值适合纯新手快速起项目适合后续加域名、加服务我的结论如果你只是看个新鲜轻量服务器便宜省心但如果打算正儿八经长期跑直接用ECS。两个都能装OpenClaw只是安全组规则放行的位置不同。2.2 从SSH登录到换源关键准备步骤服务器拿到手第一件事不是急着装OpenClaw而是把系统基础环境收拾利索。我用的是Ubuntu 22.04登录时直接用控制台的远程连接或者本地终端SSH进去都可以。第一次登录建议做两件事更新系统包然后顺手把软件源换成阿里云镜像源。很多人在这一步懒了后面拉包慢到怀疑人生。国内服务器上配置阿里云镜像源的标准做法是把/etc/apt/sources.list里的软件源地址替换成阿里云镜像地址。替换完执行sudo apt update sudo apt upgrade -y这一步会把系统补丁和基础依赖都装好后面装Docker或者Node.js时能省掉不少报错。另外记得创建一个非root用户来跑日常任务别全程root操作后面权限问题会少很多。2.3 安全组端口放行这个坑几乎每个第一次用阿里云的人都踩过服务明明在服务器里跑起来了浏览器就是打不开。原因基本都是安全组没放行端口。阿里云的服务器有两层防火墙概念第一层是实例安全组规则第二层才是系统内部的iptables/ufw。OpenClaw默认的管理后台端口是3000所以你在控制台的安全组规则里必须手动添加一条方向协议端口授权对象入方向TCP30000.0.0.0/0建议改成你本机IP这里我额外提醒一句如果只是自己管理后台授权对象别无脑填0.0.0.0/0最好填你自己家里的公网IP或者使用阿里云的云防火墙白名单策略。因为OpenClaw管理后台是有权限配置模型API Key的端口被全网扫描到不算什么好事。我自己的习惯是先用0.0.0.0/0快速验证功能验证完立刻改回指定IP。3. 核心安装流程Docker与原生两种方式3.1 方式ADocker快速部署最省心所谓2分钟安装指的就是这个流程。前提是服务器上已经装好了Docker环境。如果你还没装Docker用下面这套官方获取脚本的方式两三条命令就能搞定curl -fsSL https://get.docker.com | bash sudo systemctl enable --now docker sudo usermod -aG docker $USER装完重进一次SSH让用户组生效。然后拉取OpenClaw镜像并启动容器。官方镜像名以项目Releases页公布为准不同版本tag会有变化我用通用写法做示例mkdir -p ~/openclaw/data docker run -d \ --name openclaw \ --restart unless-stopped \ -p 3000:3000 \ -v ~/openclaw/data:/app/data \ -e OPENCLAW_MODEL_PROVIDERopenai \ -e OPENCLAW_MODEL_NAMEqwen-max \ -e OPENCLAW_API_KEY你的模型API密钥 \ openclaw/openclaw:latest这串命令干了几件事创建了数据持久化目录、把容器的3000端口映射到服务器、设置了容器随宿主机自启、并通过环境变量预置了模型接入信息。跑完docker ps能看到容器状态是Up这时候在浏览器输入http://服务器公网IP:3000就能看到管理后台了。注意第一次拉镜像如果发现速度很慢不一定是网络问题也可能是镜像比较大。这里有个小技巧给Docker配置阿里云镜像加速器在控制台或者文档里找到你的专属加速地址写进/etc/docker/daemon.json的registry-mirrors字段重启Docker之后拉取速度会明显改善。如果你在海外地域比如新加坡、美西开机器那这步可以跳过海外节点拉Docker Hub本来就快。3.2 方式BNode.js原生部署流程不喜欢容器、或者想直接看代码运行逻辑的人可以用Node.js原生方式部署。OpenClaw的底层依赖Node.js官方对Node的版本一般要求20以上建议直接装22 LTScurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs node -v然后通过npm全局安装OpenClaw的CLI工具具体包名以官方文档为准sudo npm install -g openclaw openclaw init my-agent cd my-agent openclaw start原生方式的好处是能用openclaw命令行直接把Agent项目初始化到一个目录里代码结构、Skills文件夹、配置文件全都在眼前调试起来更透明。坏处是你得手动管进程。我推荐用systemd写一个服务单元文件让它在后台常驻sudo nano /etc/systemd/system/openclaw.service写入[Unit] DescriptionOpenClaw Agent Service Afternetwork.target [Service] Typesimple User你的用户名 WorkingDirectory/home/你的用户名/my-agent ExecStart/usr/bin/openclaw start Restartalways RestartSec5 EnvironmentNODE_ENVproduction [Install] WantedBymulti-user.target然后执行sudo systemctl daemon-reload sudo systemctl enable --now openclaw这套写出来之后进程只要崩了会自动拉起来服务器重启也会自动带上。对于原生部署的人来说这股配置比挂个nohup靠谱太多强烈建议照做。3.3 用Ollama把Qwen2.5-3B本地模型接进来很多朋友在搜OpenClaw只能用接入API的方式使用算力吗这里我统一回答不是。OpenClaw本身只是编排层不产生模型推理能力它既可以选择云端模型API也可以选择接本地推理引擎。如果你有一台显卡服务器或者即使没有GPU、只想用小参数模型跑个轻度任务接Ollama就很合适。在阿里云服务器上装Ollama很简单官方一行脚本curl -fsSL https://ollama.com/install.sh | sh装完之后拉一个轻量模型比如Qwen2.5-3Bollama run qwen2.5:3b先手动跑一下确认能正常对话然后把它作为OpenClaw的模型后端。配置里把provider指向ollamabase_url填本机地址model: provider: ollama base_url: http://127.0.0.1:11434 name: qwen2.5:3b这种方案对没买API额度的人来说特别友好。Qwen2.5-3B这种模型在纯CPU上跑确实不算快但处理一些简单指令、定时任务、文本摘要完全够用关键是省钱、数据不出服务器隐私上心里也踏实一些。4. 启动后的配置与上手使用4.1 接入通义千问等模型的完整步骤OpenClaw启动后第一件事是配置模型这一步配不好后面页面开得再花哨也没用。我用接入通义千问举例。先去阿里云的百炼平台也称模型服务灵积DashScope开通模型服务拿到属于你自己的API Key。然后回到OpenClaw管理后台在模型设置里选择DashScope/阿里云百炼这个Provider填入API Key和模型名。常见的通义千问模型名有qwen-max、qwen-plus、qwen-turbo等。日常对话和任务编排我推荐qwen-plus速度和效果平衡如果你追求复杂推理的稳定性就选qwen-max只是想快速测试流程通不通选qwen-turbo响应快还便宜。还有一些第三方配置习惯把Provider写成openai然后自己填一个兼容OpenAI协议的base_url指向DashScope的兼容端点这种方式也能跑通但建议用官方原生Provider配置更简洁。配好模型之后管理后台会有一个测试对话框。先发一条简单的你好确认链路是通的再发一条相对复杂的指令比如请帮我分析当前目录下日志文件中频率最高的错误类型一步步验证模型理解能力和工具调用能力是否正常。4.2 创建Agent并配置Skills技能模型通了之后OpenClaw的玩法才开始真正展开。它的核心工作单位叫Agent你可以创建多个不同职责的Agent比如运维助手写作助理数据收集员每个Agent可以指定不同的模型、系统提示词和可用技能。Skills是OpenClaw的重头戏你可以理解为给Agent装上插件。系统内置的Skill直接能用包括读文件、执行Shell命令、调用HTTP接口、定时任务等。而自定义Skill也很简单一个Skill本质上是一个包含描述文件SKILL.md和你提供的脚本/程序包的目录。我把官方samples里的目录扒了一遍之后自己写了一个服务器状态检查的Skill结构大致是这样的my-agent/skills/server-status/ ├── SKILL.md └── scripts/ └── status.sh其中SKILL.md用Markdown格式写清楚这个Skill是干什么的以及Agent什么时候该调用它--- name: server-status description: 检测当前服务器的CPU使用率、内存占用和系统负载适用于运维监控场景。 --- 执行脚本 scripts/status.sh脚本会输出CPU、内存和1分钟/5分钟负载直接返回这些文本结果。而scripts/status.sh就是纯粹的Shell脚本#!/bin/bash echo CPU 使用率: $(top -bn1 | grep Cpu(s) | awk {print $2 $4})% echo 内存使用: $(free -h | awk /Mem:/{print $3 / $2}) echo 系统负载: $(uptime | awk -Fload average: {print $2})配置好之后你只需要在对话里让Agent看一下服务器状态它会自动识别这个Skill并执行脚本、返回结果。这种模式等于把各种手工运维命令封装成了可对话的原子操作用习惯之后就回不去了因为很多事情你不再需要自己敲命令、翻文档说一句话就够了。4.3 数据目录、日志与日常维护OpenClaw跑起来之后数据和日志都存在你映射的持久化目录里容器方式就是~/openclaw/data。我建议每周花两分钟做三件事看一眼磁盘占用、检查容器日志有没有异常刷屏、确认模型API额度是否足够。管理后台里通常也能看到任务执行历史但服务器层面的日志才是最完整的。容器方式的日志查看方法docker logs openclaw --tail 100里面主要关注两类问题一类是模型调用超时一类是Skill执行报错堆栈。如果你发现日志里反复出现某个Skill的报错先别急着看代码逻辑先确认脚本的可执行权限有没有加这是我在Linux部署时遇到的最常见的低级坑。日常升级也很关键。OpenClaw这种还在快速迭代的开源项目升级频率不低。容器方式升级是标准的拉新镜像重建容器流程docker pull openclaw/openclaw:latest docker stop openclaw docker rm openclaw docker run -d ...复用之前的参数因为我用-v把数据目录单独挂载在外面所以重建容器并不会丢配置和任务数据。这也是我一再强调要用volume持久化的原因谁都不想升级一次丢一次数据。5. 部署中常见的坑与排查方法5.1 服务起来了但网页访问不了这是问的人最多的问题而且九成是安全组或者镜像里端口映射搞错了。排查顺序我一般是这样先看Docker容器有没有正常起来docker ps看状态是不是Up然后用curl -I http://127.0.0.1:3000在服务器本地测一下端口到底通不通本地通但外网不通去ECS控制台看安全组规则里有没有3000这条入方向规则最后才是看系统防火墙sudo ufw status确认没有额外拦截。我遇到过一个很冷门的情况安全组和服务器本机都放行了但依然打不开后来发现是容器启动参数里-p 3000:3000写成了-p 30000:3000宿主机端口映射错了一位。这种小错误最隐蔽因为容器日志一切正常只有仔细看映射关系才能发现。5.2 模型API报错与Key配置问题模型接不上报错信息千奇百怪但归纳起来就几类错误现象常见原因解决思路401 UnauthorizedAPI Key错误或没有对应模型权限检查Key前后有没有空格、有没有填错模型名404 Model Not Found模型名不对或地域Endpoint不对到百炼控制台确认模型名称与接入地域超时/连接失败网络链路问题或服务地域限制确认服务器地域与模型服务地域线路必要时换地域限额报错账户余额不足或QPS超限查看额度、升级套餐或调整频率配置完模型后如果你改了Key或者模型名一定要重启服务让配置重新加载不要只在前端点保存就完成任务。容器方式重启是docker restart openclaw原生方式则是重启systemd服务。很多改了没用的案例都是因为配置没有重新加载。5.3 Windows本地Companion与WSL2的坑如果你不是在服务器上远程管理而是在Windows上启动OpenClaw本地版或者安装官方Companion客户端大概率会碰到一类报错提示类似于无法安全验证WSL2环境下面还跟着一句让你在PowerShell里运行wsl --status。这个报错的原因很直接OpenClaw的本地组件依赖WSL2环境来做跨进程协作但Windows上可能根本没有启用WSL2或者装了老版本子系统的内核组件。处理方式我在PowerShell里跑wsl --status看了一眼发现提示的是没有内核组件然后执行wsl --update补一下再重开终端就通过了。如果你是第一次配WSL2流程是wsl --install装完重启Windows。这个坑和阿里云服务器端没有关系纯粹是本地方案的老大难所以我的观点很明确能用远程服务器部署就别跟Windows本地环境较劲省下来的时间够研究好几个Skill了。5.4 外部服务接入短信等的通用排查思路还有人尝试在OpenClaw里接入阿里云短信API时一直发不出去我看到提问的频次不低。这类问题我建议按下面的顺序排查第一步确认AccessKey对应的用户有没有赋予短信发送权限很多人的Key是主账号Key权限还能用但不建议这么做最好单独建一个RAM用户只授权短信发送权限第二步看签名和模板的审核状态审核不通过的情况下API不会报权限错误而会提示签名或模板不存在第三步检查Region参数短信API的Region如果跟你的AccessKey归属地不匹配也会出现发不出去但日志里看不到明确头绪的情况。这种排查思路其实可以平移到OpenClaw接入任意外部API的场景。不要第一反应就怀疑OpenClaw有Bug先拿API工具curl或者Postman直接调用原始接口如果原始接口通了再回来看OpenClaw里的配置这样能快速圈定问题到底在项目侧还是在你的应用侧。最后再分享一个实战中的小经验给OpenClaw配置任务指令时尽量把指令写具体不要用帮我看看服务器这种模糊说法改成请执行server-status技能返回CPU、内存、负载三项数据如果CPU使用率连续两次超过80%在回复中额外给出TOP3占用进程。因为Agent虽然有模型能力但还是需要清晰的输入才能稳定发挥。调试Skill时多试几种表达方式的差别你会发现模型对任务指令的表述精度非常敏感。这套东西用到现在最大的体会是它把百分之八十的重复性操作变得像聊天一样简单值得你花一个晚上认真玩透。
把OpenClaw也就是大家说的Clawdbot部署到阿里云这件事我前后折腾了三遍才真正理解官方文档想表达什么。老实说项目本身装起来并不难真正难的是第一次上手时面对一堆不熟悉的名词Skill、Agent、Companion、模型接入、Dashboard很容易在环境准备阶段就被劝退。这篇我用最直白的方式把从零起步到跑通完整流程的记录给你理一遍目标很明确跟着操作让OpenClaw在阿里云上跑起来并且能接到你想要的大模型上。如果你是第一次接触这篇会帮你少走我踩过的弯路如果你已经装过但某些环节一直卡着直接跳到后面的问题排查部分大概率能找到对应的解法。1. OpenClaw与Clawdbot是什么为什么值得折腾1.1 这个项目到底解决了什么问题OpenClaw项目里也常写作Clawdbot本质上是一个AI代理Agent编排框架你可以把它理解成一个中间人它负责连接大模型和你的实际任务然后以对话、定时任务、脚本等方式把模型输出的能力落到底层系统上。很多人第一次听到它的反应是这不就是个套壳聊天机器人吗实际用下来完全不是一回事。它能做的典型事情包括给Agent挂上各种工具型Skill让Agent在收到指令后自动执行脚本、读取本地文件、调用外部API、按照固定节奏跑数据抓取甚至配合桌面客户端去操作本地应用。我为什么专门说它解决了问题因为普通的对话式AI产品只能停在回答问题这一层。而OpenClaw的价值在于把回答你变成帮你去执行。比如你可以给它布置一个任务每天早上9点检查服务器磁盘使用率超过80%就在钉钉群里发一条告警消息。这种任务不需要人盯着配置好之后它自己会跑。所以它最适合的人群有两类一是重度使用AI但受不了反复复制粘贴的人二是像我这样喜欢把AI接入自动化流程、想省掉大量重复操作的开发者。1.2 为什么部署到阿里云而不是本地电脑我最早是在本地Windows上试着跑的后来发现还是放服务器上更香。原因很现实本地环境下电脑一关、网络一断或者那个烦人的WSL2环境出点问题服务就跟着断了。放到阿里云上之后它变成了一台7×24小时在线的服务我随时用浏览器登录后台不用操心电脑睡眠、重启、休眠这些破事。另外还有一个关键原因OpenClaw这类工具最终是要调用模型的。如果你在本地部署模型API的请求要从你自己的网络出去稳定性完全取决于你的宽带而部署在阿里云上云服务器到各家模型API服务的网络链路通常更稳响应速度也更可控。再加上阿里云本身有百炼平台、通义千问系列模型可以直接对接整个生态是闭环的。成本上也不用担心一台2核4G的ECS按量付费一天也没多少钱比在本地折腾半天浪费的时间划算多了。2. 安装前需要准备的几样东西2.1 服务器规格与系统选择很多人在第一步选配置上就犹豫半天。我的建议很简单个人玩或小团队试用选2核4G的ECS实例就够了系统镜像用Ubuntu 22.04 LTS或者Alibaba Cloud Linux 3。别一上来就买4核16GOpenClaw本身是个Node.js/Python混合生态的服务不吃资源真正吃资源的是你挂载的模型推理而那个一般不在OpenClaw进程里跑。如果你打算用Ollama在服务器本地跑模型比如跑Qwen2.5-3B这种小参数模型那建议把内存加到8G其余保持默认。这里再补充一个对比配置项轻量应用服务器ECS云服务器适合场景个人尝鲜、低并发正经使用、要长期跑任务面板易用性自带简单防火墙、图形面板需要自己理解安全组规则升级灵活性固定套餐扩展有限随时升配、降配折腾价值适合纯新手快速起项目适合后续加域名、加服务我的结论如果你只是看个新鲜轻量服务器便宜省心但如果打算正儿八经长期跑直接用ECS。两个都能装OpenClaw只是安全组规则放行的位置不同。2.2 从SSH登录到换源关键准备步骤服务器拿到手第一件事不是急着装OpenClaw而是把系统基础环境收拾利索。我用的是Ubuntu 22.04登录时直接用控制台的远程连接或者本地终端SSH进去都可以。第一次登录建议做两件事更新系统包然后顺手把软件源换成阿里云镜像源。很多人在这一步懒了后面拉包慢到怀疑人生。国内服务器上配置阿里云镜像源的标准做法是把/etc/apt/sources.list里的软件源地址替换成阿里云镜像地址。替换完执行sudo apt update sudo apt upgrade -y这一步会把系统补丁和基础依赖都装好后面装Docker或者Node.js时能省掉不少报错。另外记得创建一个非root用户来跑日常任务别全程root操作后面权限问题会少很多。2.3 安全组端口放行这个坑几乎每个第一次用阿里云的人都踩过服务明明在服务器里跑起来了浏览器就是打不开。原因基本都是安全组没放行端口。阿里云的服务器有两层防火墙概念第一层是实例安全组规则第二层才是系统内部的iptables/ufw。OpenClaw默认的管理后台端口是3000所以你在控制台的安全组规则里必须手动添加一条方向协议端口授权对象入方向TCP30000.0.0.0/0建议改成你本机IP这里我额外提醒一句如果只是自己管理后台授权对象别无脑填0.0.0.0/0最好填你自己家里的公网IP或者使用阿里云的云防火墙白名单策略。因为OpenClaw管理后台是有权限配置模型API Key的端口被全网扫描到不算什么好事。我自己的习惯是先用0.0.0.0/0快速验证功能验证完立刻改回指定IP。3. 核心安装流程Docker与原生两种方式3.1 方式ADocker快速部署最省心所谓2分钟安装指的就是这个流程。前提是服务器上已经装好了Docker环境。如果你还没装Docker用下面这套官方获取脚本的方式两三条命令就能搞定curl -fsSL https://get.docker.com | bash sudo systemctl enable --now docker sudo usermod -aG docker $USER装完重进一次SSH让用户组生效。然后拉取OpenClaw镜像并启动容器。官方镜像名以项目Releases页公布为准不同版本tag会有变化我用通用写法做示例mkdir -p ~/openclaw/data docker run -d \ --name openclaw \ --restart unless-stopped \ -p 3000:3000 \ -v ~/openclaw/data:/app/data \ -e OPENCLAW_MODEL_PROVIDERopenai \ -e OPENCLAW_MODEL_NAMEqwen-max \ -e OPENCLAW_API_KEY你的模型API密钥 \ openclaw/openclaw:latest这串命令干了几件事创建了数据持久化目录、把容器的3000端口映射到服务器、设置了容器随宿主机自启、并通过环境变量预置了模型接入信息。跑完docker ps能看到容器状态是Up这时候在浏览器输入http://服务器公网IP:3000就能看到管理后台了。注意第一次拉镜像如果发现速度很慢不一定是网络问题也可能是镜像比较大。这里有个小技巧给Docker配置阿里云镜像加速器在控制台或者文档里找到你的专属加速地址写进/etc/docker/daemon.json的registry-mirrors字段重启Docker之后拉取速度会明显改善。如果你在海外地域比如新加坡、美西开机器那这步可以跳过海外节点拉Docker Hub本来就快。3.2 方式BNode.js原生部署流程不喜欢容器、或者想直接看代码运行逻辑的人可以用Node.js原生方式部署。OpenClaw的底层依赖Node.js官方对Node的版本一般要求20以上建议直接装22 LTScurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs node -v然后通过npm全局安装OpenClaw的CLI工具具体包名以官方文档为准sudo npm install -g openclaw openclaw init my-agent cd my-agent openclaw start原生方式的好处是能用openclaw命令行直接把Agent项目初始化到一个目录里代码结构、Skills文件夹、配置文件全都在眼前调试起来更透明。坏处是你得手动管进程。我推荐用systemd写一个服务单元文件让它在后台常驻sudo nano /etc/systemd/system/openclaw.service写入[Unit] DescriptionOpenClaw Agent Service Afternetwork.target [Service] Typesimple User你的用户名 WorkingDirectory/home/你的用户名/my-agent ExecStart/usr/bin/openclaw start Restartalways RestartSec5 EnvironmentNODE_ENVproduction [Install] WantedBymulti-user.target然后执行sudo systemctl daemon-reload sudo systemctl enable --now openclaw这套写出来之后进程只要崩了会自动拉起来服务器重启也会自动带上。对于原生部署的人来说这股配置比挂个nohup靠谱太多强烈建议照做。3.3 用Ollama把Qwen2.5-3B本地模型接进来很多朋友在搜OpenClaw只能用接入API的方式使用算力吗这里我统一回答不是。OpenClaw本身只是编排层不产生模型推理能力它既可以选择云端模型API也可以选择接本地推理引擎。如果你有一台显卡服务器或者即使没有GPU、只想用小参数模型跑个轻度任务接Ollama就很合适。在阿里云服务器上装Ollama很简单官方一行脚本curl -fsSL https://ollama.com/install.sh | sh装完之后拉一个轻量模型比如Qwen2.5-3Bollama run qwen2.5:3b先手动跑一下确认能正常对话然后把它作为OpenClaw的模型后端。配置里把provider指向ollamabase_url填本机地址model: provider: ollama base_url: http://127.0.0.1:11434 name: qwen2.5:3b这种方案对没买API额度的人来说特别友好。Qwen2.5-3B这种模型在纯CPU上跑确实不算快但处理一些简单指令、定时任务、文本摘要完全够用关键是省钱、数据不出服务器隐私上心里也踏实一些。4. 启动后的配置与上手使用4.1 接入通义千问等模型的完整步骤OpenClaw启动后第一件事是配置模型这一步配不好后面页面开得再花哨也没用。我用接入通义千问举例。先去阿里云的百炼平台也称模型服务灵积DashScope开通模型服务拿到属于你自己的API Key。然后回到OpenClaw管理后台在模型设置里选择DashScope/阿里云百炼这个Provider填入API Key和模型名。常见的通义千问模型名有qwen-max、qwen-plus、qwen-turbo等。日常对话和任务编排我推荐qwen-plus速度和效果平衡如果你追求复杂推理的稳定性就选qwen-max只是想快速测试流程通不通选qwen-turbo响应快还便宜。还有一些第三方配置习惯把Provider写成openai然后自己填一个兼容OpenAI协议的base_url指向DashScope的兼容端点这种方式也能跑通但建议用官方原生Provider配置更简洁。配好模型之后管理后台会有一个测试对话框。先发一条简单的你好确认链路是通的再发一条相对复杂的指令比如请帮我分析当前目录下日志文件中频率最高的错误类型一步步验证模型理解能力和工具调用能力是否正常。4.2 创建Agent并配置Skills技能模型通了之后OpenClaw的玩法才开始真正展开。它的核心工作单位叫Agent你可以创建多个不同职责的Agent比如运维助手写作助理数据收集员每个Agent可以指定不同的模型、系统提示词和可用技能。Skills是OpenClaw的重头戏你可以理解为给Agent装上插件。系统内置的Skill直接能用包括读文件、执行Shell命令、调用HTTP接口、定时任务等。而自定义Skill也很简单一个Skill本质上是一个包含描述文件SKILL.md和你提供的脚本/程序包的目录。我把官方samples里的目录扒了一遍之后自己写了一个服务器状态检查的Skill结构大致是这样的my-agent/skills/server-status/ ├── SKILL.md └── scripts/ └── status.sh其中SKILL.md用Markdown格式写清楚这个Skill是干什么的以及Agent什么时候该调用它--- name: server-status description: 检测当前服务器的CPU使用率、内存占用和系统负载适用于运维监控场景。 --- 执行脚本 scripts/status.sh脚本会输出CPU、内存和1分钟/5分钟负载直接返回这些文本结果。而scripts/status.sh就是纯粹的Shell脚本#!/bin/bash echo CPU 使用率: $(top -bn1 | grep Cpu(s) | awk {print $2 $4})% echo 内存使用: $(free -h | awk /Mem:/{print $3 / $2}) echo 系统负载: $(uptime | awk -Fload average: {print $2})配置好之后你只需要在对话里让Agent看一下服务器状态它会自动识别这个Skill并执行脚本、返回结果。这种模式等于把各种手工运维命令封装成了可对话的原子操作用习惯之后就回不去了因为很多事情你不再需要自己敲命令、翻文档说一句话就够了。4.3 数据目录、日志与日常维护OpenClaw跑起来之后数据和日志都存在你映射的持久化目录里容器方式就是~/openclaw/data。我建议每周花两分钟做三件事看一眼磁盘占用、检查容器日志有没有异常刷屏、确认模型API额度是否足够。管理后台里通常也能看到任务执行历史但服务器层面的日志才是最完整的。容器方式的日志查看方法docker logs openclaw --tail 100里面主要关注两类问题一类是模型调用超时一类是Skill执行报错堆栈。如果你发现日志里反复出现某个Skill的报错先别急着看代码逻辑先确认脚本的可执行权限有没有加这是我在Linux部署时遇到的最常见的低级坑。日常升级也很关键。OpenClaw这种还在快速迭代的开源项目升级频率不低。容器方式升级是标准的拉新镜像重建容器流程docker pull openclaw/openclaw:latest docker stop openclaw docker rm openclaw docker run -d ...复用之前的参数因为我用-v把数据目录单独挂载在外面所以重建容器并不会丢配置和任务数据。这也是我一再强调要用volume持久化的原因谁都不想升级一次丢一次数据。5. 部署中常见的坑与排查方法5.1 服务起来了但网页访问不了这是问的人最多的问题而且九成是安全组或者镜像里端口映射搞错了。排查顺序我一般是这样先看Docker容器有没有正常起来docker ps看状态是不是Up然后用curl -I http://127.0.0.1:3000在服务器本地测一下端口到底通不通本地通但外网不通去ECS控制台看安全组规则里有没有3000这条入方向规则最后才是看系统防火墙sudo ufw status确认没有额外拦截。我遇到过一个很冷门的情况安全组和服务器本机都放行了但依然打不开后来发现是容器启动参数里-p 3000:3000写成了-p 30000:3000宿主机端口映射错了一位。这种小错误最隐蔽因为容器日志一切正常只有仔细看映射关系才能发现。5.2 模型API报错与Key配置问题模型接不上报错信息千奇百怪但归纳起来就几类错误现象常见原因解决思路401 UnauthorizedAPI Key错误或没有对应模型权限检查Key前后有没有空格、有没有填错模型名404 Model Not Found模型名不对或地域Endpoint不对到百炼控制台确认模型名称与接入地域超时/连接失败网络链路问题或服务地域限制确认服务器地域与模型服务地域线路必要时换地域限额报错账户余额不足或QPS超限查看额度、升级套餐或调整频率配置完模型后如果你改了Key或者模型名一定要重启服务让配置重新加载不要只在前端点保存就完成任务。容器方式重启是docker restart openclaw原生方式则是重启systemd服务。很多改了没用的案例都是因为配置没有重新加载。5.3 Windows本地Companion与WSL2的坑如果你不是在服务器上远程管理而是在Windows上启动OpenClaw本地版或者安装官方Companion客户端大概率会碰到一类报错提示类似于无法安全验证WSL2环境下面还跟着一句让你在PowerShell里运行wsl --status。这个报错的原因很直接OpenClaw的本地组件依赖WSL2环境来做跨进程协作但Windows上可能根本没有启用WSL2或者装了老版本子系统的内核组件。处理方式我在PowerShell里跑wsl --status看了一眼发现提示的是没有内核组件然后执行wsl --update补一下再重开终端就通过了。如果你是第一次配WSL2流程是wsl --install装完重启Windows。这个坑和阿里云服务器端没有关系纯粹是本地方案的老大难所以我的观点很明确能用远程服务器部署就别跟Windows本地环境较劲省下来的时间够研究好几个Skill了。5.4 外部服务接入短信等的通用排查思路还有人尝试在OpenClaw里接入阿里云短信API时一直发不出去我看到提问的频次不低。这类问题我建议按下面的顺序排查第一步确认AccessKey对应的用户有没有赋予短信发送权限很多人的Key是主账号Key权限还能用但不建议这么做最好单独建一个RAM用户只授权短信发送权限第二步看签名和模板的审核状态审核不通过的情况下API不会报权限错误而会提示签名或模板不存在第三步检查Region参数短信API的Region如果跟你的AccessKey归属地不匹配也会出现发不出去但日志里看不到明确头绪的情况。这种排查思路其实可以平移到OpenClaw接入任意外部API的场景。不要第一反应就怀疑OpenClaw有Bug先拿API工具curl或者Postman直接调用原始接口如果原始接口通了再回来看OpenClaw里的配置这样能快速圈定问题到底在项目侧还是在你的应用侧。最后再分享一个实战中的小经验给OpenClaw配置任务指令时尽量把指令写具体不要用帮我看看服务器这种模糊说法改成请执行server-status技能返回CPU、内存、负载三项数据如果CPU使用率连续两次超过80%在回复中额外给出TOP3占用进程。因为Agent虽然有模型能力但还是需要清晰的输入才能稳定发挥。调试Skill时多试几种表达方式的差别你会发现模型对任务指令的表述精度非常敏感。这套东西用到现在最大的体会是它把百分之八十的重复性操作变得像聊天一样简单值得你花一个晚上认真玩透。
