NAS上跑OpenClaw，接入七牛云免费AI额度，打造24小时在线私人AI代理

家里的飞牛OS NAS吃灰半年后我给它找到了一个真正值得7×24小时开机的理由在上面跑OpenClaw再把七牛云的免费AI模型额度接进去。OpenClaw是一个开源的个人AI代理/消息网关负责把各种消息入口统一起来按你的意图调用模型和工具七牛云的模型服务则提供OpenAI协议兼容的API而且有免费额度可领。两个一拼等于给NAS装了一个带“大脑”的私人助理模型在云端配置、会话记录、执行逻辑全在本地。适合手里正好有一台NAS、想低成本玩AI Agent但不想折腾显卡的人。整个过程不复杂但有几个细节非常容易劝退下面把完整链路拆开讲清楚。1. 为什么把OpenClaw装在飞牛OS上模型却选七牛云免费额度1.1 这三个角色分别解决什么问题先说OpenClaw。它本质上是一个“消息调度中枢”你可以把命令行、Webhook、IM机器人等不同入口都接进来收到消息后它会判断意图调用大模型生成回复或动作再触发对应的插件去执行。它不是普通聊天机器人更像是一个把“入口、模型、工具”串起来的胶水层。如果没有这一层你要自己写API对接、会话管理、任务分发工作量不小。飞牛OS在这里承担的是“常驻底座”。NAS本来就要7×24小时开机功耗比台式机低得多Docker生态也成熟天然适合跑这类需要长期在线的服务。把OpenClaw装在上面不用担心电脑睡眠、服务器到期、IP漂移数据也留在自己手里。七牛云免费额度解决的是“试错成本”。大模型API按量付费个人玩AI Agent最容易翻车的地方就是功能还没调通API账单先上来了。七牛云提供OpenAI兼容的模型接口又有免费额度可领正好拿来验证OpenClaw是否值得长期折腾。等确认流程跑通了再决定要不要为高频任务付费心态会完全不一样。1.2 从消息到回复的完整数据流理解数据流很重要后面排查问题都靠它。一条消息从入口进来后大致经历四个阶段消息源IM机器人/Webhook/命令行把用户输入交给OpenClawOpenClaw解析出意图以OpenAI兼容协议向七牛云模型API发起请求模型返回文本结果或工具调用指令OpenClaw按策略生成回复或触发插件执行执行结果和会话记录写回NAS本地磁盘同时把最终响应返回给消息源。这套结构最大的好处是“模型在云状态在本地”。你可以在NAS上保留所有历史对话、插件配置和日志哪怕容器删了重来数据卷还在就不会丢。坏处也很明显请求内容会发送到云端模型服务做推理所以涉及密码、密钥、住址这类敏感信息时要先在OpenClaw侧做脱敏或白名单不要一股脑全丢给模型。2. 准备工作飞牛NAS环境检查与七牛云免费额度的领取细节2.1 飞牛OS先确认这几个条件动手前先在飞牛OS上做三件事。第一开启SSH。飞牛OS一般默认支持SSH你需要在系统设置里把它打开然后用管理员账号登录后面所有部署命令都走SSH比在网页控制台里点来点去高效得多。第二确认Docker和Compose可用。登录后执行两条命令docker version docker compose version只要docker能正常输出版本号compose也显示版本就可以往下走。如果系统里没有compose优先检查飞牛OS自带的Docker管理界面是否已经包含该能力实在不行再手动补装。第三规划好固定IP和端口。在路由器上给NAS绑定一个静态DHCP地址避免重启后IP变化导致回调地址失效。OpenClaw默认监听端口以镜像文档为准我这边用3000作为示例你部署前先确认NAS上没有服务占用这个端口免得容器能起来但端口冲突。存储空间不用太担心。OpenClaw镜像加上数据卷预留10GB完全够用内存建议2GB起步4GB会更舒服。飞牛OS的默认存储卷通常在/vol1下如果你改过存储布局以实际路径为准。2.2 七牛云免费额度从注册到拿到可用的Key七牛云这边的流程建议赶在部署OpenClaw之前做因为后面compose文件里要直接填它的Base URL和API Key。整个领取路径大概是注册并完成实名认证进入控制台找到“模型推理/模型广场”一类入口选择支持OpenAI协议兼容调用的模型点击领取免费额度然后创建一个用于模型服务的API密钥。注意这个密钥和对象存储的AccessKey/SecretKey通常不是一回事别拿错。如果你的控制台显示共用一套密钥体系则以页面说明为准。领取时有三个点最容易踩一是免费额度不是注册就自动到账必须手动点“领取/申请”否则调用时仍然按付费计费或直接报错二是额度通常有有效期不是永久生效过期后要继续用就得重新领取或单独充值三是部分模型的免费额度有地域或渠道限制页面会写“仅限某地域调用”如果你在API地址里选错了地域请求会一直失败。2.3 最容易劝退的细节模型名必须填API标识这一步看起来不起眼实际劝退率极高。七牛云控制台里展示的通常是“某某大模型免费体验版”这种可读名称但API请求中的model字段要填的是模型标识两者经常不一样。你直接拿页面显示名去填会一直收到404类似model not found。正确做法是去模型服务的API文档或调试页面找到“请求示例”里model参数的值把它完整复制出来。有些模型的标识带版本号比如xxx-v2、xxx-lite之类漏掉后缀同样不行。建议把取到的完整模型ID、Base URL、API Key放在同一个笔记里后面部署会反复用到。3. Docker Compose部署OpenClaw到飞牛NAS3.1 目录结构先规划好我习惯把所有自托管服务的目录集中在NAS的一个路径下方便备份和排查。假设你的默认存储卷是/vol1可以这样建目录mkdir -p /vol1/docker/openclaw/data cd /vol1/docker/openclawdata目录用来放OpenClaw的配置、会话记录、SQLite或JSON文件。如果你不想让数据目录权限出问题可以先执行chown -R 1000:1000 /vol1/docker/openclaw/data很多镜像内部进程使用UID 1000运行提前把目录属主设置好能避免容器启动后写不进去。如果飞牛OS的Docker默认以root运行容器这步跳过也行真遇到Permission denied再回来补做。3.2 一份可以直接抄的Compose文件在/vol1/docker/openclaw下创建docker-compose.ymlservices: openclaw: image: openclaw/openclaw:latest container_name: openclaw restart: unless-stopped ports: - 3000:3000 volumes: - ./data:/data env_file: - .env environment: - TZAsia/Shanghai同一目录下创建.env文件把七牛云的信息放进去OPENAI_BASE_URLhttps://你的七牛Endpoint/v1 OPENAI_API_KEY你的七牛APIKey OPENAI_MODEL你的模型ID用.env而不是直接写在compose里是为了防止密钥被误提交到Git也方便以后切换模型时只改一个文件。不同版本的OpenClaw环境变量名可能略有出入比如有的用OPENAI_API_BASE有的用OPENAI_BASE_URL部署前瞄一眼你所用镜像的README以官方变量名为准。如果OpenClaw的配置需要写到config.yaml这类文件里通常会在首次启动后自动生成在/data下到时候进容器看实际文件名再改。3.3 启动、看日志、确认服务在线在/vol1/docker/openclaw目录下执行docker compose up -d docker compose logs -f openclaw-d表示后台运行logs -f是持续跟踪日志。第一次启动时日志里会显示配置加载过程、模型连接状态和监听端口。看到类似“server started”或“listening on”的字样说明服务基本活了。如果想确认端口通不通在NAS本机执行curl -s http://127.0.0.1:3000/health或直接浏览器访问http://你的NAS_IP:3000。不同版本OpenClaw的管理界面差异很大有的提供Web UI有的只监听API这一步不强求有界面只要能返回有效响应就行。3.4 新手最容易翻车的三个部署细节第一个坑是端口冲突。NAS上跑的服务多3000端口很可能已经被别的容器占了。启动后如果日志显示address already in use把compose里的端口映射改成例如3001:3000再重新docker compose up -d。第二个坑是容器反复重启。很多人一看容器重启就以为镜像坏了实际上90%的情况是环境变量缺了模型配置、API Key为空或者数据目录没写权限。先docker logs看报错比反复restart有效得多。第三个坑是盲目用latest标签。OpenClaw这类项目迭代很快某次升级可能改变配置格式或默认行为。个人使用建议先锁定一个具体版本号确认稳定后再升级升级前备份整个/vol1/docker/openclaw/data目录。备份命令很简单tar czf openclaw-backup-$(date %Y%m%d).tar.gz /vol1/docker/openclaw/data4. 把七牛云模型挂到OpenClaw配置、验证、踩坑4.1 OpenAI兼容接口的三个关键参数七牛云模型服务既然号称兼容OpenAI协议那OpenClaw对接时只需要弄清楚三个参数Base URL、API Key、模型ID。Base URL是OpenAI SDK发起请求的根地址通常要精确到/v1因为实际请求路径是{Base URL}/chat/completions。很多人的第一个404就是这里造成的控制台给出的域名可能已经带了/v1你在后面又加了一个/v1路径变成/v1/v1/chat/completions怎么调都不对。稳妥的做法是直接在文档里找“Chat Completions接口地址”照抄。API Key就按控制台生成的填注意别复制到多余的空格。有些API文档在示例里写的是Authorization: Bearer sk-xxxOpenClaw里只需要填sk-xxx不要连“Bearer”一起填。模型ID的问题在第二章已经讲过这里再强调一次以API文档请求示例中的model参数为准。你可以先写一个最简请求验证参数再填进OpenClaw避免在日志里反复看404。4.2 OpenClaw侧配置的两种写法OpenClaw的配置方式不同版本差异比较大但核心逻辑无非两种环境变量优先或者配置文件优先。如果镜像支持环境变量注入那么第二章里.env中的OPENAI_BASE_URL、OPENAI_API_KEY、OPENAI_MODEL就已经够了改完执行docker compose restart openclaw如果镜像要求读配置文件首次启动后/data下会出现类似config.yaml、config.json的文件。进入容器查看docker exec -it openclaw cat /data/config.yaml看到真实文件内容后按它的字段结构补上provider配置。下面是一个常见的表达方式字段名可能因版本变化但表达的意思一致providers: qiniu: type: openai baseUrl: https://你的七牛Endpoint/v1 apiKey: 你的七牛APIKey models: default: 你的模型ID改完先别急着重启先检查缩进和嵌套关系YAML对缩进极其敏感多一个空格都可能解析失败。改好后重启容器并看日志确认没有“missing provider”或“model not found”之类的提示。4.3 先测模型API再测OpenClaw这是我最推荐的一条排障原则不要一上来就拿着OpenClaw聊天窗口反复试而是先用curl把七牛云模型API测通把变量范围缩到最小。在NAS的SSH终端执行curl https://你的七牛Endpoint/v1/chat/completions \ -H Authorization: Bearer 你的七牛APIKey \ -H Content-Type: application/json \ -d {model:你的模型ID,messages:[{role:user,content:请只回复OK两个字}],temperature:0.1}如果返回内容里能看到choices[0].message.content说明模型API、Key、模型ID全都没问题。这时候再去测试OpenClaw的消息入口一旦有问题锅基本在OpenClaw侧要么配置没加载要么容器没重启要么消息渠道没绑定。如果curl本身就报错按状态码判断401是Key错了或权限没生效404是模型ID不对或地域不支持429是触发限流或额度不足超时则是NAS到七牛云的网络链路有问题先检查NAS的DNS和防火墙。4.4 免费额度模型的取舍策略免费额度模型能不能跑好OpenClaw不完全取决于“能不能回答”还取决于“支不支持工具调用”。OpenClaw的很多高级能力比如查天气、执行命令、写文件都需要模型返回结构化的工具调用指令。如果免费模型不支持function callingOpenClaw就会退化成“纯聊天”任务类插件全部失效。所以我的建议是日常闲聊、文本总结、邮件起草这类任务用免费额度模型完全够涉及多步工具调用、代码生成、复杂推理的场景再切换高能力模型。很多版本的OpenClaw支持配置多个模型profile可以按渠道或指令前缀切换。比如把默认模型指向免费额度模型把“工具任务模型”单独指向能力更强的付费模型既省钱又能保证核心功能不残缺。5. 免费额度日常运营用量监控、限流规避与故障排查5.1 免费额度的边界比你想象中多免费额度不是“无限免费用”它通常有至少四层限制按token计量或按请求次数计量有有效期存在每分钟请求数或每分钟token数限制并且只对你领取时指定的模型生效。有效期过了之后即使配额看起来还在调用也会被拒必须重新领取或续期。每分钟限制对OpenClaw尤其致命因为有些自动化任务会在短时间内连续触发多次模型请求一个循环就能把整分钟的额度打光。建议定时去七牛云控制台的用量统计页面看一眼不要等报错才开始查。部分控制台支持余量提醒能开就开至少保证在额度耗尽前你有心理准备。5.2 高频故障与一步步排查链路下面这张表是我在实际使用中遇到最多的情况可以直接拿来对照现象常见原因处理方式401 UnauthorizedAPI Key错误、复制多了空格、密钥权限未生效重新生成密钥去掉多余字符确认Bearer后只填Key本体404 model not found模型ID用了展示名、版本号缺失、地域不支持去API文档复制请求示例里的model参数429 Too Many Requests触发每分钟限流或免费额度耗尽查看控制台配额降低触发频率或临时换模型请求超时NAS到七牛云网络不通、DNS解析异常、代理干扰在NAS上curl测试检查DNS和出口防火墙OpenClaw收到消息但无反应模型配置未加载、插件报错、容器内配置文件语法错误执行docker logs openclaw --tail 200找到真正报错行排查时养成一个习惯先看OpenClaw日志再测模型API最后才怀疑“是不是消息入口坏了”。顺序反了最容易浪费时间因为问题往往出在最前面那一环。5.3 让OpenClaw长期稳定跑下来的实践建议第一密钥管理要严格。.env文件虽然不上传Git但NAS如果开启了公网访问就要确保这个目录不会被Web服务暴露出去。最稳妥的办法是只允许SSH和Docker管理端口访问其他入口一律关掉。第二控制触发频率。在OpenClaw或消息渠道侧配置冷却时间防止同一个入口被脚本反复调用。免费额度限流很严格一次错误的重试循环就能把配额烧穿。OpenClaw本身就应该做成“事件驱动”而不是“高频轮询”我在NAS上见过太多定时任务五分钟狂敲一次模型API的例子额度完全是被自己耗光的。第三定期备份/data。配置、会话记录、插件状态都在里面。备份可以简单粗暴地用tar打包也可以写个定时任务每天凌晨执行一次。真遇到镜像升级搞坏配置有备份和没备份完全是两种心态。第四给OpenClaw设置fallback思路。如果你同时拥有其他模型API可以把它配成备用模型一旦七牛云免费额度报429或过期自动降级到备用模型避免整个服务中断。即使没有备用API也至少要在OpenClaw里配置一个“模型不可用时通知我”的渠道好过用户发现机器人半天没反应。我自己的体会是这套组合最值钱的地方不在于“白嫖”而在于它让你把AI Agent的部署、接入、排障全流程跑通了一遍。等哪天你真需要把这套东西用于正经场景会发现换模型、换渠道、加插件都是顺手的事。免费额度有到期的那一天但你在飞牛OS上留下的这套运行环境才是真正能长期沉淀下来的东西。