如果你刷到过别人用AI助理自动整理资料、定时跑脚本、随手调用各种工具但一直觉得那是“高玩专属”那这篇就是写给你的。OpenClaw也叫Clawdbot是一个开源的智能体运行框架简单说就是把大模型从一个“只会聊天的对话框”升级成“能动手干活的数字员工”。它最值钱的地方在于Skills机制也就是技能插件系统——你不需要从零训练模型也不用写一堆前后端只要会一点Python和JSON就能让AI调用你写的工具。这篇记录的是我同时把OpenClaw部署到移动云服务器和Windows本地的完整过程。移动云场景适合想让服务7x24小时在线、跨设备随时连的人Windows本地场景则适合零基础练手、不想多花钱、想快速看到效果的人。文章尽量不预设你有Linux基础所有命令一行行拆开讲连环境变量怎么填、安全组怎么放行这类细节都写清楚了。照着抄两小时之内你也能跑起一个带自定义技能的Clawdbot。1. OpenClawClawdbot到底是个什么东西1.1 一个能调用工具的大模型外壳我最初看到OpenClaw这个名字时一脸懵查了下才知道Clawdbot是项目的早期代号后来因为核心定位逐渐清晰大家更习惯叫OpenClaw。“Claw”这个爪子的意象其实很贴切项目想强调的就是“能抓住东西、操作东西”而不是单纯聊天。它的架构拆开看就三层引擎层负责跟大模型服务商通信把用户的自然语言转换成结构化的意图再根据意图决定要不要调用某个技能。你可以把它理解成一个调度中心。连接器层负责对接聊天入口比如网页后台、消息软件、命令行、API接口。也就是说你可以通过网页跟它聊也可以通过微信、Slack这类软件远程指挥它干活。技能层Skills这就是真正“动手”的模块。一个技能本质上是一个描述文件加一段可执行代码大模型读了描述知道“这个技能是干嘛的、什么时候该用、参数怎么填”然后就调用代码去执行。整个调用过程有点像你家里请了个秘书。秘书不是所有事都会做但她面前有一抽屉工具卡每张卡上写着某个工具的使用说明什么场景用、按键怎么按、有什么注意事项。你说话秘书判断该用哪张卡然后照卡操作。OpenClaw里的Skills就是这些工具卡。1.2 Skills机制的价值框架真正值钱的部分如果你只用OpenClaw聊天那它跟普通对话机器人没什么区别也就是一个API封装壳。真正让它拉开差距的是Skills机制。内置技能里通常包含这几类高频能力获取当前时间、日期、星期抓取网页内容并总结读写本地文件和常见文档执行定时任务调用系统命令查询天气需要额外申请天气服务商Key但这些内置技能只能覆盖常见场景你真正要用的可能是“每天自动整理下载目录”“定时备份某个文件夹到云端”“收到特定邮件就发提醒”。这种时候就需要自己写一个Skills。很多人一听“自己写技能”就发怵其实OpenClaw把门槛压得很低。一个最简单的技能就是一个文件夹里面放一个给大模型看的说明文件SKILL.md和一个Python脚本。说明文件里用几行文字写清楚这个技能是做什么的参数有哪些Python脚本里实现一个普通的函数大模型会帮用户把自然语言翻译成函数的调用参数。你完全没有必要去搞懂提示词工程、微调、向量数据库这些大词那些都是进阶话题。我见到不少第一次玩OpenClaw的人第一周就写出了四五个自定义技能因为他们只需要照葫芦画瓢把内置技能复制一份改改描述、改改函数体就行。这也是为什么我一直推荐零基础用户从这个框架入手而不是一上来就看那些动辄几十个组件的复杂Agent项目。2. 部署方案怎么选移动云和Windows本地2.1 移动云部署真正意义上的“一直都在”这里说的“移动云”我指的是那些可以通过手机网页控制台或App就能管理的云主机。和“放在家里电脑上跑”相比它最大的优点是稳定性只要云厂商机房不炸你的服务就一直在线。家里电脑可能因为断电、断网、系统更新重启而掉线云主机基本不会。这个场景的优点非常明确有固定的公网IP你出门在外用手机流量也能连回来。带宽和配置可以随时升降初期便宜点后面跑重任务再升配。可以设置自动重启策略服务崩了能自己拉起来。不占用本地资源笔记本合盖继续跑。但它也有对应的“学习税”。首先你得习惯用命令行。云主机是Linux系统所有操作基本靠敲命令没有图形界面给你点。其次你得理解安全组、防火墙、端口放行这组概念——很多人服务明明启动了外网却打不开十有八九是安全组没放行端口。最后每月有一笔小额支出不过只要你选最便宜的新手套餐一个月也就几杯奶茶钱。我给新手推荐的云主机配置是CPU 1核、内存2G、磁盘20到40G系统选Ubuntu 22.04 LTS或者24.04 LTS。注意千万别为了贪图界面去选Windows系统一是贵二是跑OpenClaw这类Python服务Linux省资源得多命令也更好抄。2.2 Windows本地部署零成本练手的最优解如果你还没想好要不要长期跑我建议先在Windows本地部署一遍。本地部署的好处是“所见即所得”项目文件就在你电脑里用文本编辑器随手就能改代码出问题可以直接看进程、看日志、看端口学习成本低一大截。但它有几个限制你也得提前知道第一没有公网IP。你在家里局域网能访问出门连不上。想出门也能连需要搞内网穿透或者反向代理这属于后话零基础阶段先不用管。第二电脑不能随便休眠和关机。笔记本一合盖服务就停了。如果一直插电外接显示器当小型服务器用倒还好否则要养成“隔几天看一眼”的习惯。第三开机自启得自己配置。Windows不像Linux那样只写个systemd服务就能托管得用计划任务或者启动文件夹来实现。综合来看Windows本地更适合这三类人第一次接触Agent框架的纯新手、主要在本机写自动化脚本的人、不想为云服务付费的尝鲜用户。我的建议很直接先本地把它跑起来感受一下完整链路再决定要不要迁上云。两条路线的项目代码和配置方式几乎一样迁移成本非常低不存在“本地学的到云上没用”的问题。2.3 选型对比什么情况选哪条路对比维度移动云服务器Windows本地是否要求7x24在线是适合长期运行否关机即停外部访问公网IP直接访问仅局域网远程需额外配置费用每月少量费用0元仅电费上手难度需要懂Linux命令基本图形界面操作调试方便度靠日志和命令行可视化日志本地文件直改适合人群微信/网页机器人、固定服务个人练手、本机自动化简单给个结论先本地跑通再按需上云。如果一开始就直奔云服务器你既要学Linux又要理解安全组还得同时学OpenClaw的配置容易三头都顾不过来。本地跑通了你会知道这个服务启动以后是什么样子、日志里哪些信息正常、哪些是报错再上云就只是“换个地方跑一样的东西”。3. 动手前的零基础准备3.1 云服务器准备注册、创建实例、安全组在云服务商注册账号并完成实名认证后进入云主机控制台选择创建实例。操作系统选Ubuntu 22.04 LTS地域选离你近的带宽先选1到3Mbps如果只是给自己用日常流量足够。创建成功后会给你一个公网IP以及登录用的用户名一般是ubuntu或root和密码或者一份密钥文件.pem。SSH登录在Windows自带终端就能做。打开PowerShell或CMD输入ssh ubuntu你的公网IP如果用的是密钥文件则要改成ssh -i 你的密钥文件路径.pem ubuntu你的公网IP第一次连接会提示确认指纹输入yes回车即可。如果你不方便用电脑也可以直接在云厂商的手机控制台里打开“网页终端”相当于一个内置的远程命令行窗口不需要额外装App。创建实例后有一条非常关键、但很多人第一次都会漏掉的步骤在控制台的“安全组”里放行端口。安全组是云主机的第一道防火墙默认只放行SSH的22端口其他端口都是关闭的。OpenClaw默认跑在8080端口那么你就去安全组的入站规则里添加一条协议TCP端口8080来源0.0.0.0/0表示允许所有人访问。这一步不做就算服务在服务器上跑得好好的浏览器也永远打不开。3.2 Windows本地环境准备Python、Git、终端Windows端要装的东西同样不多。首先是PythonOpenClaw要求3.10以上版本建议装3.11或3.12。安装时有一个极其重要的勾选项把“Add Python to PATH”勾上否则后面在终端里输python会提示找不到命令。然后是Git。Git是拉取项目代码的工具你不需要理解它的内部原理会用克隆和拉取两条命令就够。装完以后鼠标右键菜单里会多出“Open Git Bash here”之类的选项。不过后面我建议直接用PowerShellWindows Terminal更方便。Windows Terminal强烈推荐装一个微软商店就能搜到它比老式CMD好看好用得多支持多标签页复制粘贴也顺手。装好以后按Win键输入Terminal就能打开。最后规划一个工作目录例如C:\clawdbot后面所有项目文件都放这里路径简单不容易出问题。3.3 理解虚拟环境避免依赖冲突很多人之前没接触过Python第一次看到“虚拟环境”这个词会懵。其实可以把它理解成一个“独立的软件沙盒”每个Python项目都在自己的沙盒里装依赖互不干扰。没有沙盒的话你装项目A需要的库可能会把项目B正在用的库版本冲掉非常酸爽。创建虚拟环境在项目目录下执行python -m venv venvWindows激活虚拟环境.\venv\Scripts\Activate.ps1如果提示“无法加载脚本因为在此系统上禁止运行脚本”先执行一下Set-ExecutionPolicy -Scope Process -ExecutionPolicy BypassLinux激活虚拟环境source venv/bin/activate激活成功的标志是终端命令行的最前面出现(venv)后面你就可以放心地安装各种Python依赖了。安装命令统一是pip install -r requirements.txtrequirements.txt是项目员的依赖清单里面锁定了每个库的版本。如果下载速度特别慢可以在命令后面加一个镜像站参数换成你本地连起来快的PyPI镜像地址即可。4. 移动云上部署OpenClaw4.1 连接服务器后先做基础系统配置SSH登录到服务器之后第一步是更新系统软件源。Linux服务器刚创建出来不一定是最新状态先跑sudo apt update这个命令会刷新软件源索引跑完后建议顺手升级一下现有软件包sudo apt upgrade -y接下来安装几个后面会用到的基础工具。python3-venv用于创建虚拟环境python3-pip是Python包管理器git用来拉代码curl用来测试接口sudo apt install -y python3-venv python3-pip git curl装完以后验证一下版本python3 --version git --version看到版本号输出就算OK。然后创建一个项目目录后面所有代码都放这里mkdir -p ~/app cd ~/app4.2 拉取项目代码并准备虚拟环境现在从代码托管平台把OpenClaw克隆下来。项目地址在官网或文档里都有这里用占位地址演示git clone https://example.com/openclaw/openclaw.git cd openclaw克隆完成后项目目录下应该能看到requirements.txt、run.py、.env.example、skills/这些文件和文件夹。先创建虚拟环境python3 -m venv venv source venv/bin/activate然后安装依赖。这一步在性能一般的云主机上可能会等一两分钟如果中途卡住不动大概率是网络问题。国内网络环境下载PyPI包时可以给pip指定一个更快的镜像源pip install -r requirements.txt -i https://mirrors.example.com/pypi/simple装完依赖后项目就算“骨架”搭好了。4.3 配置模型API和基本参数OpenClaw本身不内置大模型它要对接一个提供大模型API的服务商。所以你需要先去模型服务商平台注册账号、创建一个API Key然后把这个Key填进项目配置里。项目里会有一个配置文件模板.env.example把它复制成真正的配置文件cp .env.example .env然后编辑.env。如果你不会用vim先用nanonano .env里面需要重点确认这几项配置OPENAI_API_KEY你的模型服务商API Key OPENAI_BASE_URLhttps://api.你的模型服务商.com/v1 OPENAI_MODEL_NAME你使用的模型名称 APP_PORT8080注意几个细节。API Key前后绝对不能有空格。Base URL通常要以/v1结尾不同服务商略有不同以你拿到的接口文档为准。模型名称要填成服务商后台给的那个完整标识别拿展示名来填。如果你使用的模型服务商需要额外的环境变量比如组织ID、代理地址补在.env文件里就行。编辑完按CtrlX再按y最后回车保存退出。4.4 启动服务并验证Skills配置好.env后先不要急着做后台托管直接前台启动一次测试python run.py首次启动时OpenClaw会加载模型配置、扫描技能目录并初始化日志。等几秒如果看到类似“OpenClaw started”的日志就说明启动成功。这时你在服务器本机验证一下接口能通不通。新开一个SSH窗口或者直接在服务对端按CtrlAltT之类的方式打开新的终端使用网页终端工具时往往带分屏执行curl http://localhost:8080/health如果返回一串JSON数据说明Web服务正常。接下来你就可以关掉前台启动把它交给systemd来实现“开机自启崩溃自动重启”。创建一个systemd服务文件sudo nano /etc/systemd/system/openclaw.service文件内容写[Unit] DescriptionOpenClaw Service Afternetwork.target [Service] Typesimple WorkingDirectory/home/你的用户名/app/openclaw ExecStart/home/你的用户名/app/openclaw/venv/bin/python run.py Restartalways RestartSec3 EnvironmentFile/home/你的用户名/app/openclaw/.env [Install] WantedBymulti-user.target保存后重载并启用sudo systemctl daemon-reload sudo systemctl enable --now openclaw用下面几条命令确认状态sudo systemctl status openclaw sudo journalctl -u openclaw -f最后一步是在服务器防火墙上放行8080端口sudo ufw allow 22/tcp sudo ufw allow 8080/tcp sudo ufw enable然后打开浏览器访问http://你的公网IP:8080就能看到OpenClaw的Web后台。4.5 日常维护命令速记服务跑起来之后日常维护就靠这几个命令sudo systemctl status openclaw # 查看运行状态 sudo systemctl restart openclaw # 重启服务 sudo journalctl -u openclaw -f # 实时查看日志 cd ~/app/openclaw git pull # 拉取最新代码更新代码之后记得重启服务。如果改了Skills多数情况下只需要调用OpenClaw的重载接口不需要重启整个服务这个后面细说。5. Windows本地部署OpenClaw完整流程5.1 拉代码与创建虚拟环境Windows本地的步骤和云上很像。打开PowerShell进入你的工作目录cd C:\clawdbot克隆代码git clone https://example.com/openclaw/openclaw.git cd openclaw创建虚拟环境py -3 -m venv venv激活虚拟环境.\venv\Scripts\Activate.ps1如果遇到执行策略报错先跑一句Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass然后安装依赖pip install -r requirements.txt跟云上一样下载慢就加镜像源参数。5.2 配置环境变量并启动服务在项目根目录把.env.example复制一份改成.env。Windows下可以这样做Copy-Item .env.example .env然后用记事本或VS Code打开.env把API Key、Base URL、模型名称、端口这些内容填好。具体字段含义跟云上完全一样不多说。启动服务之前我还是建议先看一眼日志输出。Windows下直接前台跑python run.py看到类似“OpenClaw started”的日志后浏览器打开http://localhost:8080就可以看到后台界面了。在这个界面里你能直接给它发消息、看模型回复还能看到它调用了哪个技能、传了什么参数。5.3 让OpenClaw在Windows开机自启如果你希望每次开机都自动运行而不需要自己动手启动有两种常用方法。第一种是启动文件夹。按WinR输入shell:startup回车把项目目录下venv\Scripts\pythonw.exe的快捷方式放进去然后在快捷方式属性里设置“起始位置”为项目根目录目标后面加run.py。注意如果你不想看到黑色命令行窗口就用pythonw.exe它会静默运行调试的时候则用python.exe方便看日志。第二种是计划任务更可靠一些。打开“任务计划程序”创建基本任务触发器选“当前用户登录时”操作选“启动程序”程序填C:\clawdbot\openclaw\venv\Scripts\pythonw.exe参数填run.py起始于C:\clawdbot\openclaw然后保存下次登录系统就会自动拉起服务。需要特别提醒的是如果电脑睡眠或休眠计划任务不会执行。如果你打算让这台电脑当作长期运行的“本地服务器”请打开电源设置把睡眠改为“从不”。笔记本记得插电运行不然性能还是会打折。5.4 在本地验证内置技能部署完成后第一件事不是急着写技能而是先验证一下框架内置技能能不能被正确调用。进入Web后台在对话框里输入现在是什么时间正常情况下模型会识别出这是一个“获取当前时间”类的请求然后选中内置的时间技能执行最后返回一段自然语言答案。你在日志里能看到类似“skill time executed”的记录。再试一个稍微复杂的帮我总结一下这个页面的内容[某个网址]如果内置网页抓取技能配置正常它会抓取网页内容并用大模型总结。这个测试能帮你确认“模型→技能调度→脚本执行→结果返回”这条链路是通的。6. 第一次开发自己的Skills6.1 Skills目录结构与标准文件部署只是开胃菜真正好玩的是自己往OpenClaw里加技能。先从目录结构说起。在项目根目录下一般有一个skills/目录里面每个子文件夹就是一个独立技能。比如我要做一个“问候报时”技能就建skills/greeting/文件夹。每个技能文件夹里至少要有两个东西SKILL.md给大模型看的使用说明。一个Python脚本也可以是其他语言的可执行文件但Python最省事。SKILL.md的写法很关键因为模型对技能的调用完全依赖这份说明。一个典型格式是这样name: greeting description: 当用户向你问好或者想知道当前日期和时间时使用这个技能。 parameters: type: object properties: style: type: string enum: [formal, casual] description: 问候语风格正式或随意 required: [] run: python greeting.py这格式看着像YAML其实里面嵌了JSON Schema。核心是description和parameters。描述写得越清楚模型越不容易在无关场景误调用参数枚举写得越明确模型填值就越准确。6.2 写一个最简单的问候报时技能在skills/greeting/目录下创建一个greeting.pyfrom datetime import datetime def execute(stylecasual): now datetime.now().strftime(%Y-%m-%d %H:%M:%S) if style formal: return f现在是 {now}祝您一切顺利。 return f现在是 {now}今天也要加油呀 if __name__ __main__: print(execute())这就是一个最普通的Python函数。OpenClaw在调用技能时会把你定义的参数值传进去然后把函数的返回值交给大模型由大模型组织成用户能看懂的话。写好之后去Web后台刷新技能列表或者调用一下技能重载接口通常会在后台界面提供“Reload Skills”按钮。然后在对话框输入跟我打个招呼顺便告诉我现在几点了正常来说模型会读取SKILL.md识别出“打招呼和报时”可以交给greeting技能然后从对话里提取参数style最终返回你设定的文本。6.3 参数设计的一些实用建议写了好几个技能之后我总结出几条经验。参数数量能少就少。模型填参数靠的是从自然语言里猜参数越多猜错概率越大。宁可一个技能只做一个动作也别搞一个万能技能挂十来个参数。能用枚举就用枚举。比如“风格”这个参数你给出[formal, casual]模型就会从里面选不容易自由发挥出意料之外的值。如果参数是开放式的字符串模型可能把用户原话直接塞进来你还得自己在代码里做清洗。返回值尽量是一段纯文本。大模型需要把执行结果翻译成对话纯文本最不容易出岔子。如果你返回一个JSON对象也请让模型能读懂里面的关键字段。千万别返回二进制文件或者一长串乱码。代码里做好异常捕获。技能执行过程中如果抛异常轻则返回报错重则影响整个Agent循环。最简单的做法是try: result do_something() except Exception as e: result f技能执行失败{e}哪怕是失败也返回一句清晰的话给模型模型才知道怎么向用户解释。6.4 技能热加载与常见误区OpenClaw通常支持热加载改完技能代码不用重启服务。但如果你改了SKILL.md里的参数结构我建议还是重启一下最稳妥因为技能说明会在启动时被缓存进模型上下文。另一个新手常见误区是在技能代码里写print而不是return。OpenClaw拿的是函数的返回值不是控制台输出。如果你只print不return模型会认为技能什么都没返回对用户只能说“技能执行了但没结果”。所以记住技能函数的终点一定是return。还有技能目录名不要用中文和空格。你本地没问题但云端Linux环境对文件名比较敏感目录名带空格会把启动脚本直接搞挂。统一用小写英文加下划线最稳。7. 常见问题与排查实录7.1 依赖安装超时或找不到包如果你在pip install -r requirements.txt时频繁超时或者提示某个包找不到大概率是网络问题或者pip版本太旧导致解析失败。先升级pippip install --upgrade pip再指定镜像源安装pip install -r requirements.txt -i https://mirrors.example.com/pypi/simple如果某个包仍然找不到检查一下Python版本是否满足项目要求。OpenClaw要求3.10以上如果你系统里默认的是3.8必然是装不上的。7.2 模型API连不上或返回401这是部署时遇到最多的问题之一。现象是服务能启动但你发消息后模型不回复日志里出现401或403。按这个顺序排查第一确认.env文件确实存在并且API Key没有拼错、没有多余空格。很多人会把Key复制成带换行的用文本编辑器仔细看首尾。第二确认OPENAI_BASE_URL结尾带有/v1。不同服务商兼容地址不一样有的还要带具体项目路径以官方文档为准。第三确认这个Key有余额或权限。很多模型服务商新Key默认没有开通某些模型权限或者免费额度用完了都会导致鉴权失败。在OpenClaw日志里如果能看到“HTTP 401 Unauthorized”那基本就是Key或权限问题不用怀疑代码。7.3 端口被占用Windows下启动时报端口被占用常见原因是上一次的服务没完全退出。先找到占用进程netstat -ano | findstr :8080最后一列是PID然后结束进程taskkill /PID 你的PID /FLinux下同样处理ss -lntp | grep 8080 kill 你的PID或者干脆在.env里换一个端口比如8081一劳永逸避开冲突。7.4 云上部署了但外网打不开这个问题至少一半的人会遇到。服务本身正常、本机curl也通但浏览器输入公网IP就是打不开。逐层查第一云控制台安全组有没有放行8080端口。这个最容易被忽略安全组放行后通常要等几秒到几分钟生效。第二服务器系统防火墙ufw有没有放行8080。输入sudo ufw status如果显示inactive说明系统防火墙没启用不影响访问如果显示active那就必须看到8080端口的allow规则。第三确认服务监听的地址是0.0.0.0而不是127.0.0.1。执行ss -lntp | grep 8080看到0.0.0.0:8080才是允许外部访问如果只是127.0.0.1:8080说明服务只监听本机需要在配置里把监听地址改成0.0.0.0。最后用手机流量访问测试。尽量别用和服务器同一个WiFi免得是家宽运营商拦截了端口。7.5 长时间运行后内存不足或卡死云服务器配置低的话跑几天后可能会因为内存不足导致进程被杀。给一个小配置的云主机加Swap交换分区是最快的救急方案sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile这样即使内存不够系统也能用磁盘空间撑一阵。另外前面配置systemd时写了Restartalways服务被系统杀掉后会自动拉起不会出现掉线了你才知道的情况。Windows本地则优先考虑升内存关闭太多占用高的浏览器标签页。7.6 常见问题速查表症状最常见原因快速解决办法pip安装超时默认源连接慢指定镜像源重装聊天后模型没反应API Key或Base URL配置错检查.env并重试401 UnauthorizedKey无效或无权限到服务商后台检查余额浏览器打不开云服务安全组未放行端口云控制台添加8080放行服务监听127.0.0.1HOST配置不对改为0.0.0.0后重启技能返回空函数里只print没return改成return结果改完技能不生效需要重载或重启调用Reload接口或重启服务我自己从Windows本地起步第一周几乎天天改技能后来迁到云上用systemd托管稳定性高了很多。最大的体会是先本地跑通全链路再上云是零基础最舒服的路径。如果你第一次跑起来不妨先做一个“问候报时”技能整个技能调用闭环走通以后再往里面加天气、文件整理、定时任务这些更复杂的玩法。OpenClaw的门槛没有想象中高但把它跑起来的每一步细节我都尽量写在上面的内容里了。
如果你刷到过别人用AI助理自动整理资料、定时跑脚本、随手调用各种工具但一直觉得那是“高玩专属”那这篇就是写给你的。OpenClaw也叫Clawdbot是一个开源的智能体运行框架简单说就是把大模型从一个“只会聊天的对话框”升级成“能动手干活的数字员工”。它最值钱的地方在于Skills机制也就是技能插件系统——你不需要从零训练模型也不用写一堆前后端只要会一点Python和JSON就能让AI调用你写的工具。这篇记录的是我同时把OpenClaw部署到移动云服务器和Windows本地的完整过程。移动云场景适合想让服务7x24小时在线、跨设备随时连的人Windows本地场景则适合零基础练手、不想多花钱、想快速看到效果的人。文章尽量不预设你有Linux基础所有命令一行行拆开讲连环境变量怎么填、安全组怎么放行这类细节都写清楚了。照着抄两小时之内你也能跑起一个带自定义技能的Clawdbot。1. OpenClawClawdbot到底是个什么东西1.1 一个能调用工具的大模型外壳我最初看到OpenClaw这个名字时一脸懵查了下才知道Clawdbot是项目的早期代号后来因为核心定位逐渐清晰大家更习惯叫OpenClaw。“Claw”这个爪子的意象其实很贴切项目想强调的就是“能抓住东西、操作东西”而不是单纯聊天。它的架构拆开看就三层引擎层负责跟大模型服务商通信把用户的自然语言转换成结构化的意图再根据意图决定要不要调用某个技能。你可以把它理解成一个调度中心。连接器层负责对接聊天入口比如网页后台、消息软件、命令行、API接口。也就是说你可以通过网页跟它聊也可以通过微信、Slack这类软件远程指挥它干活。技能层Skills这就是真正“动手”的模块。一个技能本质上是一个描述文件加一段可执行代码大模型读了描述知道“这个技能是干嘛的、什么时候该用、参数怎么填”然后就调用代码去执行。整个调用过程有点像你家里请了个秘书。秘书不是所有事都会做但她面前有一抽屉工具卡每张卡上写着某个工具的使用说明什么场景用、按键怎么按、有什么注意事项。你说话秘书判断该用哪张卡然后照卡操作。OpenClaw里的Skills就是这些工具卡。1.2 Skills机制的价值框架真正值钱的部分如果你只用OpenClaw聊天那它跟普通对话机器人没什么区别也就是一个API封装壳。真正让它拉开差距的是Skills机制。内置技能里通常包含这几类高频能力获取当前时间、日期、星期抓取网页内容并总结读写本地文件和常见文档执行定时任务调用系统命令查询天气需要额外申请天气服务商Key但这些内置技能只能覆盖常见场景你真正要用的可能是“每天自动整理下载目录”“定时备份某个文件夹到云端”“收到特定邮件就发提醒”。这种时候就需要自己写一个Skills。很多人一听“自己写技能”就发怵其实OpenClaw把门槛压得很低。一个最简单的技能就是一个文件夹里面放一个给大模型看的说明文件SKILL.md和一个Python脚本。说明文件里用几行文字写清楚这个技能是做什么的参数有哪些Python脚本里实现一个普通的函数大模型会帮用户把自然语言翻译成函数的调用参数。你完全没有必要去搞懂提示词工程、微调、向量数据库这些大词那些都是进阶话题。我见到不少第一次玩OpenClaw的人第一周就写出了四五个自定义技能因为他们只需要照葫芦画瓢把内置技能复制一份改改描述、改改函数体就行。这也是为什么我一直推荐零基础用户从这个框架入手而不是一上来就看那些动辄几十个组件的复杂Agent项目。2. 部署方案怎么选移动云和Windows本地2.1 移动云部署真正意义上的“一直都在”这里说的“移动云”我指的是那些可以通过手机网页控制台或App就能管理的云主机。和“放在家里电脑上跑”相比它最大的优点是稳定性只要云厂商机房不炸你的服务就一直在线。家里电脑可能因为断电、断网、系统更新重启而掉线云主机基本不会。这个场景的优点非常明确有固定的公网IP你出门在外用手机流量也能连回来。带宽和配置可以随时升降初期便宜点后面跑重任务再升配。可以设置自动重启策略服务崩了能自己拉起来。不占用本地资源笔记本合盖继续跑。但它也有对应的“学习税”。首先你得习惯用命令行。云主机是Linux系统所有操作基本靠敲命令没有图形界面给你点。其次你得理解安全组、防火墙、端口放行这组概念——很多人服务明明启动了外网却打不开十有八九是安全组没放行端口。最后每月有一笔小额支出不过只要你选最便宜的新手套餐一个月也就几杯奶茶钱。我给新手推荐的云主机配置是CPU 1核、内存2G、磁盘20到40G系统选Ubuntu 22.04 LTS或者24.04 LTS。注意千万别为了贪图界面去选Windows系统一是贵二是跑OpenClaw这类Python服务Linux省资源得多命令也更好抄。2.2 Windows本地部署零成本练手的最优解如果你还没想好要不要长期跑我建议先在Windows本地部署一遍。本地部署的好处是“所见即所得”项目文件就在你电脑里用文本编辑器随手就能改代码出问题可以直接看进程、看日志、看端口学习成本低一大截。但它有几个限制你也得提前知道第一没有公网IP。你在家里局域网能访问出门连不上。想出门也能连需要搞内网穿透或者反向代理这属于后话零基础阶段先不用管。第二电脑不能随便休眠和关机。笔记本一合盖服务就停了。如果一直插电外接显示器当小型服务器用倒还好否则要养成“隔几天看一眼”的习惯。第三开机自启得自己配置。Windows不像Linux那样只写个systemd服务就能托管得用计划任务或者启动文件夹来实现。综合来看Windows本地更适合这三类人第一次接触Agent框架的纯新手、主要在本机写自动化脚本的人、不想为云服务付费的尝鲜用户。我的建议很直接先本地把它跑起来感受一下完整链路再决定要不要迁上云。两条路线的项目代码和配置方式几乎一样迁移成本非常低不存在“本地学的到云上没用”的问题。2.3 选型对比什么情况选哪条路对比维度移动云服务器Windows本地是否要求7x24在线是适合长期运行否关机即停外部访问公网IP直接访问仅局域网远程需额外配置费用每月少量费用0元仅电费上手难度需要懂Linux命令基本图形界面操作调试方便度靠日志和命令行可视化日志本地文件直改适合人群微信/网页机器人、固定服务个人练手、本机自动化简单给个结论先本地跑通再按需上云。如果一开始就直奔云服务器你既要学Linux又要理解安全组还得同时学OpenClaw的配置容易三头都顾不过来。本地跑通了你会知道这个服务启动以后是什么样子、日志里哪些信息正常、哪些是报错再上云就只是“换个地方跑一样的东西”。3. 动手前的零基础准备3.1 云服务器准备注册、创建实例、安全组在云服务商注册账号并完成实名认证后进入云主机控制台选择创建实例。操作系统选Ubuntu 22.04 LTS地域选离你近的带宽先选1到3Mbps如果只是给自己用日常流量足够。创建成功后会给你一个公网IP以及登录用的用户名一般是ubuntu或root和密码或者一份密钥文件.pem。SSH登录在Windows自带终端就能做。打开PowerShell或CMD输入ssh ubuntu你的公网IP如果用的是密钥文件则要改成ssh -i 你的密钥文件路径.pem ubuntu你的公网IP第一次连接会提示确认指纹输入yes回车即可。如果你不方便用电脑也可以直接在云厂商的手机控制台里打开“网页终端”相当于一个内置的远程命令行窗口不需要额外装App。创建实例后有一条非常关键、但很多人第一次都会漏掉的步骤在控制台的“安全组”里放行端口。安全组是云主机的第一道防火墙默认只放行SSH的22端口其他端口都是关闭的。OpenClaw默认跑在8080端口那么你就去安全组的入站规则里添加一条协议TCP端口8080来源0.0.0.0/0表示允许所有人访问。这一步不做就算服务在服务器上跑得好好的浏览器也永远打不开。3.2 Windows本地环境准备Python、Git、终端Windows端要装的东西同样不多。首先是PythonOpenClaw要求3.10以上版本建议装3.11或3.12。安装时有一个极其重要的勾选项把“Add Python to PATH”勾上否则后面在终端里输python会提示找不到命令。然后是Git。Git是拉取项目代码的工具你不需要理解它的内部原理会用克隆和拉取两条命令就够。装完以后鼠标右键菜单里会多出“Open Git Bash here”之类的选项。不过后面我建议直接用PowerShellWindows Terminal更方便。Windows Terminal强烈推荐装一个微软商店就能搜到它比老式CMD好看好用得多支持多标签页复制粘贴也顺手。装好以后按Win键输入Terminal就能打开。最后规划一个工作目录例如C:\clawdbot后面所有项目文件都放这里路径简单不容易出问题。3.3 理解虚拟环境避免依赖冲突很多人之前没接触过Python第一次看到“虚拟环境”这个词会懵。其实可以把它理解成一个“独立的软件沙盒”每个Python项目都在自己的沙盒里装依赖互不干扰。没有沙盒的话你装项目A需要的库可能会把项目B正在用的库版本冲掉非常酸爽。创建虚拟环境在项目目录下执行python -m venv venvWindows激活虚拟环境.\venv\Scripts\Activate.ps1如果提示“无法加载脚本因为在此系统上禁止运行脚本”先执行一下Set-ExecutionPolicy -Scope Process -ExecutionPolicy BypassLinux激活虚拟环境source venv/bin/activate激活成功的标志是终端命令行的最前面出现(venv)后面你就可以放心地安装各种Python依赖了。安装命令统一是pip install -r requirements.txtrequirements.txt是项目员的依赖清单里面锁定了每个库的版本。如果下载速度特别慢可以在命令后面加一个镜像站参数换成你本地连起来快的PyPI镜像地址即可。4. 移动云上部署OpenClaw4.1 连接服务器后先做基础系统配置SSH登录到服务器之后第一步是更新系统软件源。Linux服务器刚创建出来不一定是最新状态先跑sudo apt update这个命令会刷新软件源索引跑完后建议顺手升级一下现有软件包sudo apt upgrade -y接下来安装几个后面会用到的基础工具。python3-venv用于创建虚拟环境python3-pip是Python包管理器git用来拉代码curl用来测试接口sudo apt install -y python3-venv python3-pip git curl装完以后验证一下版本python3 --version git --version看到版本号输出就算OK。然后创建一个项目目录后面所有代码都放这里mkdir -p ~/app cd ~/app4.2 拉取项目代码并准备虚拟环境现在从代码托管平台把OpenClaw克隆下来。项目地址在官网或文档里都有这里用占位地址演示git clone https://example.com/openclaw/openclaw.git cd openclaw克隆完成后项目目录下应该能看到requirements.txt、run.py、.env.example、skills/这些文件和文件夹。先创建虚拟环境python3 -m venv venv source venv/bin/activate然后安装依赖。这一步在性能一般的云主机上可能会等一两分钟如果中途卡住不动大概率是网络问题。国内网络环境下载PyPI包时可以给pip指定一个更快的镜像源pip install -r requirements.txt -i https://mirrors.example.com/pypi/simple装完依赖后项目就算“骨架”搭好了。4.3 配置模型API和基本参数OpenClaw本身不内置大模型它要对接一个提供大模型API的服务商。所以你需要先去模型服务商平台注册账号、创建一个API Key然后把这个Key填进项目配置里。项目里会有一个配置文件模板.env.example把它复制成真正的配置文件cp .env.example .env然后编辑.env。如果你不会用vim先用nanonano .env里面需要重点确认这几项配置OPENAI_API_KEY你的模型服务商API Key OPENAI_BASE_URLhttps://api.你的模型服务商.com/v1 OPENAI_MODEL_NAME你使用的模型名称 APP_PORT8080注意几个细节。API Key前后绝对不能有空格。Base URL通常要以/v1结尾不同服务商略有不同以你拿到的接口文档为准。模型名称要填成服务商后台给的那个完整标识别拿展示名来填。如果你使用的模型服务商需要额外的环境变量比如组织ID、代理地址补在.env文件里就行。编辑完按CtrlX再按y最后回车保存退出。4.4 启动服务并验证Skills配置好.env后先不要急着做后台托管直接前台启动一次测试python run.py首次启动时OpenClaw会加载模型配置、扫描技能目录并初始化日志。等几秒如果看到类似“OpenClaw started”的日志就说明启动成功。这时你在服务器本机验证一下接口能通不通。新开一个SSH窗口或者直接在服务对端按CtrlAltT之类的方式打开新的终端使用网页终端工具时往往带分屏执行curl http://localhost:8080/health如果返回一串JSON数据说明Web服务正常。接下来你就可以关掉前台启动把它交给systemd来实现“开机自启崩溃自动重启”。创建一个systemd服务文件sudo nano /etc/systemd/system/openclaw.service文件内容写[Unit] DescriptionOpenClaw Service Afternetwork.target [Service] Typesimple WorkingDirectory/home/你的用户名/app/openclaw ExecStart/home/你的用户名/app/openclaw/venv/bin/python run.py Restartalways RestartSec3 EnvironmentFile/home/你的用户名/app/openclaw/.env [Install] WantedBymulti-user.target保存后重载并启用sudo systemctl daemon-reload sudo systemctl enable --now openclaw用下面几条命令确认状态sudo systemctl status openclaw sudo journalctl -u openclaw -f最后一步是在服务器防火墙上放行8080端口sudo ufw allow 22/tcp sudo ufw allow 8080/tcp sudo ufw enable然后打开浏览器访问http://你的公网IP:8080就能看到OpenClaw的Web后台。4.5 日常维护命令速记服务跑起来之后日常维护就靠这几个命令sudo systemctl status openclaw # 查看运行状态 sudo systemctl restart openclaw # 重启服务 sudo journalctl -u openclaw -f # 实时查看日志 cd ~/app/openclaw git pull # 拉取最新代码更新代码之后记得重启服务。如果改了Skills多数情况下只需要调用OpenClaw的重载接口不需要重启整个服务这个后面细说。5. Windows本地部署OpenClaw完整流程5.1 拉代码与创建虚拟环境Windows本地的步骤和云上很像。打开PowerShell进入你的工作目录cd C:\clawdbot克隆代码git clone https://example.com/openclaw/openclaw.git cd openclaw创建虚拟环境py -3 -m venv venv激活虚拟环境.\venv\Scripts\Activate.ps1如果遇到执行策略报错先跑一句Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass然后安装依赖pip install -r requirements.txt跟云上一样下载慢就加镜像源参数。5.2 配置环境变量并启动服务在项目根目录把.env.example复制一份改成.env。Windows下可以这样做Copy-Item .env.example .env然后用记事本或VS Code打开.env把API Key、Base URL、模型名称、端口这些内容填好。具体字段含义跟云上完全一样不多说。启动服务之前我还是建议先看一眼日志输出。Windows下直接前台跑python run.py看到类似“OpenClaw started”的日志后浏览器打开http://localhost:8080就可以看到后台界面了。在这个界面里你能直接给它发消息、看模型回复还能看到它调用了哪个技能、传了什么参数。5.3 让OpenClaw在Windows开机自启如果你希望每次开机都自动运行而不需要自己动手启动有两种常用方法。第一种是启动文件夹。按WinR输入shell:startup回车把项目目录下venv\Scripts\pythonw.exe的快捷方式放进去然后在快捷方式属性里设置“起始位置”为项目根目录目标后面加run.py。注意如果你不想看到黑色命令行窗口就用pythonw.exe它会静默运行调试的时候则用python.exe方便看日志。第二种是计划任务更可靠一些。打开“任务计划程序”创建基本任务触发器选“当前用户登录时”操作选“启动程序”程序填C:\clawdbot\openclaw\venv\Scripts\pythonw.exe参数填run.py起始于C:\clawdbot\openclaw然后保存下次登录系统就会自动拉起服务。需要特别提醒的是如果电脑睡眠或休眠计划任务不会执行。如果你打算让这台电脑当作长期运行的“本地服务器”请打开电源设置把睡眠改为“从不”。笔记本记得插电运行不然性能还是会打折。5.4 在本地验证内置技能部署完成后第一件事不是急着写技能而是先验证一下框架内置技能能不能被正确调用。进入Web后台在对话框里输入现在是什么时间正常情况下模型会识别出这是一个“获取当前时间”类的请求然后选中内置的时间技能执行最后返回一段自然语言答案。你在日志里能看到类似“skill time executed”的记录。再试一个稍微复杂的帮我总结一下这个页面的内容[某个网址]如果内置网页抓取技能配置正常它会抓取网页内容并用大模型总结。这个测试能帮你确认“模型→技能调度→脚本执行→结果返回”这条链路是通的。6. 第一次开发自己的Skills6.1 Skills目录结构与标准文件部署只是开胃菜真正好玩的是自己往OpenClaw里加技能。先从目录结构说起。在项目根目录下一般有一个skills/目录里面每个子文件夹就是一个独立技能。比如我要做一个“问候报时”技能就建skills/greeting/文件夹。每个技能文件夹里至少要有两个东西SKILL.md给大模型看的使用说明。一个Python脚本也可以是其他语言的可执行文件但Python最省事。SKILL.md的写法很关键因为模型对技能的调用完全依赖这份说明。一个典型格式是这样name: greeting description: 当用户向你问好或者想知道当前日期和时间时使用这个技能。 parameters: type: object properties: style: type: string enum: [formal, casual] description: 问候语风格正式或随意 required: [] run: python greeting.py这格式看着像YAML其实里面嵌了JSON Schema。核心是description和parameters。描述写得越清楚模型越不容易在无关场景误调用参数枚举写得越明确模型填值就越准确。6.2 写一个最简单的问候报时技能在skills/greeting/目录下创建一个greeting.pyfrom datetime import datetime def execute(stylecasual): now datetime.now().strftime(%Y-%m-%d %H:%M:%S) if style formal: return f现在是 {now}祝您一切顺利。 return f现在是 {now}今天也要加油呀 if __name__ __main__: print(execute())这就是一个最普通的Python函数。OpenClaw在调用技能时会把你定义的参数值传进去然后把函数的返回值交给大模型由大模型组织成用户能看懂的话。写好之后去Web后台刷新技能列表或者调用一下技能重载接口通常会在后台界面提供“Reload Skills”按钮。然后在对话框输入跟我打个招呼顺便告诉我现在几点了正常来说模型会读取SKILL.md识别出“打招呼和报时”可以交给greeting技能然后从对话里提取参数style最终返回你设定的文本。6.3 参数设计的一些实用建议写了好几个技能之后我总结出几条经验。参数数量能少就少。模型填参数靠的是从自然语言里猜参数越多猜错概率越大。宁可一个技能只做一个动作也别搞一个万能技能挂十来个参数。能用枚举就用枚举。比如“风格”这个参数你给出[formal, casual]模型就会从里面选不容易自由发挥出意料之外的值。如果参数是开放式的字符串模型可能把用户原话直接塞进来你还得自己在代码里做清洗。返回值尽量是一段纯文本。大模型需要把执行结果翻译成对话纯文本最不容易出岔子。如果你返回一个JSON对象也请让模型能读懂里面的关键字段。千万别返回二进制文件或者一长串乱码。代码里做好异常捕获。技能执行过程中如果抛异常轻则返回报错重则影响整个Agent循环。最简单的做法是try: result do_something() except Exception as e: result f技能执行失败{e}哪怕是失败也返回一句清晰的话给模型模型才知道怎么向用户解释。6.4 技能热加载与常见误区OpenClaw通常支持热加载改完技能代码不用重启服务。但如果你改了SKILL.md里的参数结构我建议还是重启一下最稳妥因为技能说明会在启动时被缓存进模型上下文。另一个新手常见误区是在技能代码里写print而不是return。OpenClaw拿的是函数的返回值不是控制台输出。如果你只print不return模型会认为技能什么都没返回对用户只能说“技能执行了但没结果”。所以记住技能函数的终点一定是return。还有技能目录名不要用中文和空格。你本地没问题但云端Linux环境对文件名比较敏感目录名带空格会把启动脚本直接搞挂。统一用小写英文加下划线最稳。7. 常见问题与排查实录7.1 依赖安装超时或找不到包如果你在pip install -r requirements.txt时频繁超时或者提示某个包找不到大概率是网络问题或者pip版本太旧导致解析失败。先升级pippip install --upgrade pip再指定镜像源安装pip install -r requirements.txt -i https://mirrors.example.com/pypi/simple如果某个包仍然找不到检查一下Python版本是否满足项目要求。OpenClaw要求3.10以上如果你系统里默认的是3.8必然是装不上的。7.2 模型API连不上或返回401这是部署时遇到最多的问题之一。现象是服务能启动但你发消息后模型不回复日志里出现401或403。按这个顺序排查第一确认.env文件确实存在并且API Key没有拼错、没有多余空格。很多人会把Key复制成带换行的用文本编辑器仔细看首尾。第二确认OPENAI_BASE_URL结尾带有/v1。不同服务商兼容地址不一样有的还要带具体项目路径以官方文档为准。第三确认这个Key有余额或权限。很多模型服务商新Key默认没有开通某些模型权限或者免费额度用完了都会导致鉴权失败。在OpenClaw日志里如果能看到“HTTP 401 Unauthorized”那基本就是Key或权限问题不用怀疑代码。7.3 端口被占用Windows下启动时报端口被占用常见原因是上一次的服务没完全退出。先找到占用进程netstat -ano | findstr :8080最后一列是PID然后结束进程taskkill /PID 你的PID /FLinux下同样处理ss -lntp | grep 8080 kill 你的PID或者干脆在.env里换一个端口比如8081一劳永逸避开冲突。7.4 云上部署了但外网打不开这个问题至少一半的人会遇到。服务本身正常、本机curl也通但浏览器输入公网IP就是打不开。逐层查第一云控制台安全组有没有放行8080端口。这个最容易被忽略安全组放行后通常要等几秒到几分钟生效。第二服务器系统防火墙ufw有没有放行8080。输入sudo ufw status如果显示inactive说明系统防火墙没启用不影响访问如果显示active那就必须看到8080端口的allow规则。第三确认服务监听的地址是0.0.0.0而不是127.0.0.1。执行ss -lntp | grep 8080看到0.0.0.0:8080才是允许外部访问如果只是127.0.0.1:8080说明服务只监听本机需要在配置里把监听地址改成0.0.0.0。最后用手机流量访问测试。尽量别用和服务器同一个WiFi免得是家宽运营商拦截了端口。7.5 长时间运行后内存不足或卡死云服务器配置低的话跑几天后可能会因为内存不足导致进程被杀。给一个小配置的云主机加Swap交换分区是最快的救急方案sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile这样即使内存不够系统也能用磁盘空间撑一阵。另外前面配置systemd时写了Restartalways服务被系统杀掉后会自动拉起不会出现掉线了你才知道的情况。Windows本地则优先考虑升内存关闭太多占用高的浏览器标签页。7.6 常见问题速查表症状最常见原因快速解决办法pip安装超时默认源连接慢指定镜像源重装聊天后模型没反应API Key或Base URL配置错检查.env并重试401 UnauthorizedKey无效或无权限到服务商后台检查余额浏览器打不开云服务安全组未放行端口云控制台添加8080放行服务监听127.0.0.1HOST配置不对改为0.0.0.0后重启技能返回空函数里只print没return改成return结果改完技能不生效需要重载或重启调用Reload接口或重启服务我自己从Windows本地起步第一周几乎天天改技能后来迁到云上用systemd托管稳定性高了很多。最大的体会是先本地跑通全链路再上云是零基础最舒服的路径。如果你第一次跑起来不妨先做一个“问候报时”技能整个技能调用闭环走通以后再往里面加天气、文件整理、定时任务这些更复杂的玩法。OpenClaw的门槛没有想象中高但把它跑起来的每一步细节我都尽量写在上面的内容里了。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
