OpenClaw Backup skill 安装与使用指南：TaoToken 统一 Key 配置实战

1. 为什么备份 OpenClaw 这件事值得单独聊OpenClaw 用久了~/.openclaw目录会变成一个很微妙的存在里面既有你调了很久的openclaw.json主配置也有credentials/里的 API Key、Token还有agents/、workspace/Memory、cron/这些一旦丢了就要重新搭一遍的东西。它不像代码仓库那样有 Git 兜底也不像数据库那样有定时 dump很多人第一次意识到要备份往往是在升级版本或者换机器的时候。OpenClaw Backup skill 就是来解决这个问题的它是一个 Agent Skill能一键把 OpenClaw 的配置和数据打包成 tar.gz支持指定备份目录、自动保留最近 7 个版本、配合 OpenClaw Cron 做每日定时备份需要的时候再解压恢复。适合谁适合所有把 OpenClaw 当日常工具在用、并且已经在里面沉淀了渠道配置和模型参数的开发者。这篇会走完安装、配置、验证、排障的完整链路同时把 TaoToken 统一 Key 的接入方式一起讲清楚——因为备份包里最敏感的就是credentials/而统一 Key 能让这份敏感数据的管理简单很多。2. TaoToken 前置统一 Key 与 API 通道在装 Backup skill 之前先把 Key 的事情理顺。TaoToken 的定位是给 AI 工具提供统一的 API 通道和 Key 管理官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。为什么备份场景要提这个因为 OpenClaw 的credentials/目录里存的就是各家 API Key。如果你每个工具、每个 Agent 都塞一把不同的 Key备份文件一旦泄露等于把所有渠道一起交出去反过来如果你把模型调用统一收敛到 TaoToken 的一把 Key 上备份包里需要保护的敏感项就只剩一条恢复和轮换都省事。操作路径很直接登录后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 创建一把 Key复制出来先放本地密码管理器。想先确认这把 Key 能正常对话可以去模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发一条消息试试如果你打算长期用 OpenClaw 跑编码类 AgentCoding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 里有对应的套餐说明接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。注意Key 只在创建时完整显示一次页面刷新后就看不到了。拿到手立刻存好别指望回头再复制。3. 安装 Backup skill 与可复制配置3.1 两种安装方式推荐走 Clawhub省事openclaw skills search backup openclaw skills add openclaw-backup如果 Clawhub 拉取慢或者你想锁定某个 commit就手动克隆cd ~/.openclaw/workspace/skills/ git clone https://github.com/openclaw/openclaw-backup.git装完先确认脚本在位这一步别跳过ls ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh能看到路径输出就说明文件齐了。如果提示 No such file多半是克隆到了错误的目录层级检查一下当前pwd是不是~/.openclaw/workspace/skills/。3.2 config.toml 配置骨架OpenClaw 的模型通道配置放在~/.openclaw/openclaw.json但很多同学会用config.toml做本地覆盖。下面这份骨架把 TaoToken 作为统一通道接进去字段名按你本地版本对齐即可# ~/.openclaw/config.toml [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey default_model claude-sonnet-4-5 timeout_seconds 120 [agent.default] provider taotoken model claude-sonnet-4-5 max_tokens 8192 [backup] enabled true script ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh target_dir ~/openclaw-backups keep_last 7几个参数值得单独说base_url结尾不要带/v1OpenClaw 的 openai-compatible 适配层会自己拼路径keep_last控制保留份数脚本默认 7改成 3 能省磁盘timeout_seconds给到 120 是因为备份任务本身可能触发 Agent 回合太短容易中断。3.3 settings.json 配置骨架如果你用的是 JSON 配置体系等价写法如下放在~/.openclaw/settings.json{ providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, defaultModel: claude-sonnet-4-5 } }, agents: { default: { provider: taotoken, model: claude-sonnet-4-5 } }, skills: { openclaw-backup: { enabled: true, targetDir: ~/openclaw-backups, keepLast: 7 } } }提示config.toml和settings.json同时存在时以你本地 OpenClaw 版本的加载优先级为准别两份都写同一个 provider否则排查起来很痛苦。3.4 设置每日自动备份用 OpenClaw Cron 挂一个每天凌晨 3 点的任务openclaw cron add按提示填入{ name: daily-backup, schedule: {kind: cron, expr: 0 3 * * *, tz: Asia/Shanghai}, payload: { kind: agentTurn, message: Run ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh and report result to user. }, sessionTarget: isolated, delivery: {mode: announce} }sessionTarget用isolated是为了让备份任务跑在独立会话里不污染你日常的对话上下文delivery.mode设为announce跑完会主动通知结果失败了你能第一时间看到。4. 验证请求与成功结果4.1 先手动跑一次备份配置写完别急着等定时任务先手动执行bash ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh正常输出类似Backup created: /home/user/openclaw-backups/openclaw-2026-03-19_1611.tar.gz (8.8M) Total backups: 1指定目录也支持传参即可bash ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh /path/to/backup/dir4.2 确认备份内容解压看一眼结构确认该有的都在tar -tzf ~/openclaw-backups/openclaw-2026-03-19_1611.tar.gz | head -30对照下面这张表检查目录/文件说明openclaw.json主配置文件含渠道、模型配置credentials/API 密钥、Token 等敏感信息agents/Agent 配置、认证配置workspace/Memory、SOUL.md、用户文件cron/定时任务配置completions/和*.log是排除项前者是 API 响应缓存可自动重建后者是日志。如果你发现备份包体积异常大先查这两个目录有没有被误打进去。4.3 验证 TaoToken 通道是否生效备份任务本身会触发 Agent 回合所以它其实顺带验证了通道。想单独确认跑一条最小请求curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: ping}] }返回里有正常的choices结构说明 Key 和通道都没问题。这一步过了再去看openclaw status确认 gateway 状态。4.4 恢复流程与回滚真要恢复的时候顺序很重要# 1. 停止 OpenClaw openclaw gateway stop # 2. 备份当前数据安全起见 mv ~/.openclaw ~/.openclaw-old # 3. 解压备份文件 cd ~ tar -xzf ~/openclaw-backups/openclaw-2026-03-19_1611.tar.gz # 4. 启动 OpenClaw openclaw gateway start # 5. 验证状态 openclaw status如果恢复后起不来回滚就是反向操作rm -rf ~/.openclaw mv ~/.openclaw-old ~/.openclaw openclaw gateway start5. 本篇常见错排查5.1 backup.sh 报 Permission denied克隆下来的脚本默认可能没有执行权限chmod x ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh5.2 定时任务跑了但没生成文件先看 cron 任务有没有真正注册openclaw cron list如果任务在但没执行检查tz字段。Asia/Shanghai写错成Asia/Shanghi这类拼写问题任务会静默不触发。另外确认payload.message里的脚本路径是绝对路径~在 isolated 会话里不一定按你预期展开。5.3 备份包体积异常正常在 5–20MB 之间。超过这个范围检查completions/是否被包含。手动清理旧备份可以这样cd ~/openclaw-backups ls -t openclaw-*.tar.gz | tail -n 4 | xargs rm上面这条保留最近 3 个删掉其余。脚本默认保留 7 个旧版本会自动删除不用手动干预。5.4 恢复后 Agent 报鉴权失败大概率是credentials/里的 Key 和当前环境不匹配。如果你已经把模型调用统一到 TaoToken去控制台重新生成一把 Key更新config.toml里的api_key字段重启 gateway 即可。这也是统一 Key 的好处只需要改一处。5.5 跨机器迁移要注意什么备份文件可以跨机器用前提是目标机器装了相同版本的 OpenClaw。迁移时把 tar.gz 拷过去按 4.4 的恢复步骤走一遍所有配置和数据都会带过去。注意目标机器上如果已有~/.openclaw先按回滚逻辑备份成~/.openclaw-old别直接覆盖。6. 把 Key 和备份一起管起来装完 skill、配好定时任务之后建议立刻做两件事一是手动跑一次备份确认输出正常二是把 TaoToken 的 Key 收敛到一处让credentials/里需要保护的东西尽量少。如果你还在逐个工具配 Key先去 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 建一把统一的再按接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 把 OpenClaw 的 provider 指过去。长期跑编码类 Agent 的话Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 会比按量计费更可控。想先验证模型输出质量模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 直接开聊就行。最后留一个我自己的习惯每次升级 OpenClaw 版本或者改openclaw.json之前先手动执行一次backup.sh改完确认没问题再让定时任务接管。备份这件事手动那一下永远比定时任务更让人安心。