100% 本地运行 · 纯前端安全工具 · 保障您的数据私密
1上传环境配置 (识别 Agent)
不知道配置在哪里?复制下方命令到终端执行,会自动用 Finder 弹出所在的隐藏文件夹。直接将里面的 openclaw.json 拖入框中即可。
open ~/.openclaw复制
📄
点击或拖拽 openclaw.json
由于纯本地运行,这里仅读取内容,绝对不会修改原文件,也无任何网络上传
2上传 Shell 配置 (准备环境变量配置)
首先确认你在使用 Bash 还是 Zsh:
echo $SHELL复制
根据上一步结果选择对应的命令在终端执行,一键在 Finder 中选中文件:
open -R ~/.bash_profile复制
open -R ~/.zshrc复制
(或者你可以在 Finder 个人目录按 Cmd + Shift + . 显示隐藏文件拖入)
📝
点击或拖拽 bash_profile / zshrc
仅读取环境变量分析原命令状态,后续将会提供安全的复制命令供您手动写入
[Git] GitHub 模式
💻 本地模式
未连接
⚙ 重新配置
[Git] 连接 GitHub 远程仓库
要使用 GitHub 模式的所有高级备份和版本管理功能,请先绑定您的仓库。
去 GitHub 创建新仓库 ↗
这是一个私有仓库 (强烈推荐)
仓库 URL:
GitHub Token (需 repo 读写权限): 获取 Token ↗
备份
[Pkg] 备份当前状态
将配置和 agent 灵魂文件备份到 dotfiles 进行版本管理。
1填写备注
2选择版本号
连接 GitHub 后自动推荐下一版本
3执行统一备份命令
该命令包含添加、提交及远端推送功能,点击后自动复制。
(填写备注和版本号后生成)复制
♻️ 恢复历史版本
从备份中恢复配置和灵魂文件,建议先备份当前状态。
1选择版本
需要 GitHub 连接连接后显示版本列表
!建议先备份当前状态
提示恢复会覆盖当前配置,建议先到"备份"面板保存当前状态
2执行恢复
(选择版本后生成)复制
[Tool] 换电脑迁移
新机器完整恢复 OpenClaw 环境。
在新机器上执行完整迁移命令
复制
注意Gemini OAuth token 无法备份,新机器需重新登录。API key 在 .env 里无需重配。
🔧 升级修复
每次 npm install -g openclaw 升级后必须执行 ,否则启动报 Invalid URL。
触发场景openclaw 升级后 / oc 启动报 Invalid URL / 换电脑重装后
1升级 openclaw
npm install -g openclaw复制
2执行
复制
3启动
oc复制
口诀升级 openclaw → → oc
➕ 新增备份项
引导式配置,自动读取最新 bash_profile,生成精准插入命令。
1选择备份类型
📁
整个文件夹
scripts/、dailyreport/ 等
📄
单个文件
.md、.json、.py 等