1 分钟迁移指南：如何将你的 Moltbot 仓库无缝更新为 OpenClaw

问题现状

如果你在 2026 年 1 月 30 日之前克隆了仓库，你的本地 Git remote 仍然指向旧的 URL：

# 你当前的 remote 可能是这样的：
origin  https://github.com/moltbot/moltbot.git (fetch)
# 或者
origin  https://github.com/clawdbot/clawdbot.git (fetch)

这意味着在更新 remote URL 之前，你无法拉取最新更新。

解决方案（30 秒）

步骤 1：更新 Remote URL

在你的项目目录中运行这个命令：

git remote set-url origin https://github.com/openclaw/openclaw.git

步骤 2：验证更改

确认 remote 已更新：

git remote -v

你应该看到：

origin  https://github.com/openclaw/openclaw.git (fetch)
origin  https://github.com/openclaw/openclaw.git (push)

步骤 3：拉取最新更改

现在你可以获取最新代码了：

git pull origin main

完成！ 你现在已经在最新的 OpenClaw 代码库上了。

配置文件

我需要更新配置吗？

大部分情况下不需要。 配置格式向后兼容。

但是，我们建议：

备份当前配置：

cp ~/.openclaw/config.json ~/.openclaw/config.json.backup

与最新模板对比：
```
openclaw config --show-template
```
可选：更新到新结构 新功能可能需要额外的配置字段。CLI 会在缺少任何字段时警告你。

配置文件位置变更

旧路径	新路径
`~/.clawdbot/`	`~/.openclaw/`
`~/.moltbot/`	`~/.openclaw/`

CLI 会在首次运行时自动迁移你的配置。无需手动操作。

Docker 用户

如果你通过 Docker 运行，请更新镜像引用：

旧的：

image: ghcr.io/moltbot/moltbot:latest
# 或者
image: ghcr.io/clawdbot/clawdbot:latest

新的：

image: ghcr.io/openclaw/openclaw:latest

然后拉取新镜像：

docker pull ghcr.io/openclaw/openclaw:latest
docker-compose up -d

NPM/CLI 用户

如果你通过 npm 安装：

# 卸载旧包
npm uninstall -g moltbot

# 安装新包
npm install -g openclaw

或使用官方安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

命令兼容性

好消息：所有旧命令仍然有效。

旧命令	新命令	状态
`moltbot start`	`openclaw start`	✅ 两者都可用
`moltbot gateway`	`openclaw gateway`	✅ 两者都可用
`clawdbot onboard`	`openclaw onboard`	✅ 两者都可用

旧命令在内部被别名化。它们将无限期继续工作，但我们建议在新脚本中使用 openclaw。

故障排除

拉取时出现 "Permission denied"

如果你有 SSH 密钥问题：

# 切换到 HTTPS
git remote set-url origin https://github.com/openclaw/openclaw.git

"Repository not found"

确保你使用的是正确的 URL。旧仓库会重定向，但直接 URL 访问可能会失败：

# 正确的 URL
https://github.com/openclaw/openclaw.git

# 这些不再直接工作
https://github.com/moltbot/moltbot.git  # ❌
https://github.com/clawdbot/clawdbot.git  # ❌

配置没有自动迁移

如果你的配置没有自动迁移：

# 手动迁移
mkdir -p ~/.openclaw
cp ~/.moltbot/* ~/.openclaw/
# 或者
cp ~/.clawdbot/* ~/.openclaw/

常见迁移判断问题

什么时候只改 remote 还不够

如果你已经不是单纯 git pull 失败，而是还遇到下面这些情况，就说明迁移工作不止换仓库地址：

本地脚本里仍写着 moltbot 镜像名或旧包名
CI / 部署脚本仍引用旧仓库 URL
生产环境配置目录还停留在 ~/.moltbot/ 或 ~/.clawdbot/
团队文档仍在引导新成员使用旧命令

这时建议把迁移拆成 4 个检查点：代码仓 remote、运行镜像、CLI 安装、配置路径，不要只改一处就停。

哪些用户最该先看这篇迁移指南

这篇页最适合以下高意图场景：

如果你迁移完之后，问题已经不再是仓库改名本身，而是“装完了但不稳”或“命令能跑但行为不对”，就不要继续停留在迁移层：首次安装或环境刚搭好先看 OpenClaw 完整安装指南；CLI 在 hooks 后卡顿先去 CLI 回归卡顿排障页；Codex OAuth 登录成功但 provider 仍不对，先去 Codex OAuth 排障页；如果你还拿不准属于哪类问题，就先从 OpenClaw Agents 故障总表进入。

openclaw install 前后拉不到最新仓库
从 Moltbot / Clawdbot 老环境升级到 OpenClaw
Docker 镜像升级后仍引用旧 tag
团队在排查“为什么新文档命令和本地环境不一致”

如果你是从 2026.3.13 发布说明或 CLI 回归页跳过来的

2026-05-12 的 GA4 显示，这篇迁移指南和 /zh/news/openclaw-2026-3-13 同时进入中文入口前列。这里要先判断你是不是还在“迁移未完成”的问题里，而不是把所有现象都归因到版本发布或 CLI 性能回归。

从 2026.3.13 发布说明过来：先用本页确认仓库命令、包名、配置路径和启动方式都已经从 Moltbot 切到 OpenClaw，再回到 2026.3.13 发布说明判断它是否适合作为团队基线。
从 CLI 20-40 秒卡顿排查过来：如果你还混用旧命令、旧目录或旧环境变量，先完成本页迁移清理；如果迁移已干净，再进入 CLI 性能回归排查。
从中文首页直接过来：把本页当成第一道分流，迁移没完成就先收口迁移；已经全量 OpenClaw 化，再去看安装成功检查或版本选择。

这样可以避免中文入口用户在“旧项目残留”“新版本评估”和“真实 CLI 回归”之间来回跳，减少无效阅读路径。

如果你是从中文首页或 Mac 安装页跳过来的

GA4 现在显示 /zh、Mac 安装指南和这篇迁移指南处在同一批低量但高意图入口里。不要把“安装 OpenClaw”和“清理 Moltbot 残留”混成同一个问题，先用下面的分流判断：

刚从中文首页进入：如果你还没安装，先走 Mac 快速安装指南，再回来确认旧命令和旧路径是否还在。
安装已经成功但行为仍像旧 Moltbot 环境：继续留在本页，优先查命令名、镜像名、配置目录和远端地址。
CLI 已经可用但命令开始卡顿：跳到 CLI 性能回归分诊，不要把运行期延迟误判为迁移残留。

这个入口分流的目标是减少反复重装：安装问题交给安装页，旧环境残留留在迁移页，运行期慢命令交给性能回归页。

迁移完成后的 5 分钟验收清单

如果你是从 direct 链接或中文首页进来，最容易漏掉的是“仓库能拉取”之外的运行验收。迁移完成后，建议按这个顺序快速检查：

git remote -v 已经只指向 openclaw/openclaw，CI/CD 里的旧仓库地址也同步更新。
本机和部署脚本都优先使用 openclaw 命令，不再依赖旧的 moltbot 或 clawdbot alias。
Docker 镜像、npm 包名、配置目录三处都已经统一到 OpenClaw。
openclaw gateway status 能返回当前网关状态，说明迁移不是只停在代码层。
跑一条真实 agent 任务，确认 channel、provider、browser 或 exec 这些高频路径没有因为迁移残留而回退。

这段验收的作用是把迁移页从“改名教程”变成“恢复可用”的入口：如果 5 项都通过，再去看版本选择；如果卡在某一项，就直接进入对应安装或排障页。

迁移后继续承接旧名称搜索需求

只把名字从 Moltbot 改成 OpenClaw 还不够，因为用户仍会搜索 Moltbot、Clawdbot 或旧安装命令。完成 1 分钟迁移后，继续补这四项：

保留旧名称落地路径：至少有一页用自然语言写清楚 Moltbot to OpenClaw migration。
把旧命令映射到新命令：直接给替换命令，不要只说旧名称已废弃。
分流未解决报错：如果改名后暴露 provider、session 或 channel 故障，把用户送到具体 troubleshooting 页面，而不是丢回首页。
验证 analytics 连续性：观察旧名称流量最终落在迁移指南、发布说明还是 404，再从获胜入口页补内部链接。

这样 rebrand 窗口里的高意图搜索流量不会丢失，也能继续导向当前 OpenClaw 安装与诊断路径。

FAQ：迁移后仓库名改对了，但流量和使用还是没起色，先补哪三件事

如果你已经从 MoltBot 迁到了 OpenClaw，但站点流量和实际使用没有跟着起来，最常见的问题不是“名字没改干净”，而是迁移后的三个高意图入口没有顺手补齐：安装入口、故障排查入口、以及对搜索词最友好的最短路径说明。

第一，先把“迁移完成后下一步做什么”讲清楚。很多人搜到迁移页，并不是只想确认仓库名变化，而是想知道迁完之后怎么最快恢复可用。如果你的环境刚迁好但还不稳定，应该直接继续看 OpenClaw 完整安装指南；如果是命令执行变慢、hooks 后卡住，就直接去 CLI 回归卡顿排障页。这样能把“迁移意图”顺着导向“安装验收”或“性能排障”，而不是让用户回搜索结果页重新找答案。

第二，补一段“迁移成功的最小验收”。至少确认三件事：旧脚本、旧 alias、旧文档链接里不再写 MoltBot；openclaw --version 与 openclaw gateway status 能正常返回；你能完成一次真实动作，而不是只看到 CLI 能启动。对搜索用户来说，这段内容的价值很高，因为他们常常不是来读品牌故事，而是来确认“迁完以后到底能不能继续用”。

第三，把迁移页和故障总入口串起来。若迁移后问题已经不是品牌改名本身，而是 provider、gateway、browser、权限或工具调用失败，就不要继续停留在迁移页，直接进入 OpenClaw Agents 故障总表。这样搜索流量不会停在单页，而能继续流向更高意图、更容易转化的后续页面。

下一步优先覆盖的精确迁移搜索词

当读者不是想看品牌故事，而是已经在处理 Moltbot 到 OpenClaw 迁移，并且担心自动化中断时，优先用这一段承接搜索意图。

moltbot 迁移 openclaw remote url 怎么改：先更新 Git remote，再拉取并确认 origin 指向正确仓库，之后再动配置文件。
moltbot config 路径 openclaw config 路径：先确认旧配置目录是否还保存凭据，再只迁移新 OpenClaw 安装实际会读取的文件。
openclaw 迁移后命令还在用 moltbot：清理旧 CLI 包、shell alias、Docker 镜像名，以及脚本里仍然调用旧名称的命令。

总结

操作	命令
更新 Git remote	`git remote set-url origin https://github.com/openclaw/openclaw.git`
验证 remote	`git remote -v`
拉取最新代码	`git pull origin main`
更新 Docker 镜像	改为 `ghcr.io/openclaw/openclaw:latest`
更新 npm 包	`npm install -g openclaw`

总耗时：不到 1 分钟。

有关品牌重塑的完整故事，请参阅再见 Moltbot，你好 OpenClaw。