Git 实战使用指南（适用于 OpenClaw – 源代码+docker部署）

一、Git 是干什么的

Git 是一个 代码版本管理工具，可以：

• 下载项目源码
• 更新到最新版本
• 保存自己的修改
• 避免升级时覆盖配置

简单理解：

Git = 代码版本历史 + 升级管理

---

二、第一次获取项目

从 GitHub 下载项目：

git clone https://github.com/openclaw/openclaw.git

进入项目目录：

cd openclaw

查看仓库状态：

git status

查看远程仓库：

git remote -v

输出示例：

origin https://github.com/openclaw/openclaw.git

---

三、查看当前版本

查看当前 commit：

git describe --tags --always

例如：

v2026.3.7

---

四、升级官方版本

升级代码只需要一条命令：

git pull

Git 会：

远程仓库
    ↓
下载更新
    ↓
更新本地代码

升级完成后：

Updating 4d501e4cc..f2f561fab
Fast-forward

---

五、Docker 项目升级流程

升级源码后需要重启服务：

git pull
docker compose down
docker compose up -d --build

解释：

命令	作用
git pull	更新源码
docker compose down	停止旧容器
docker compose up -d --build	重建并启动

---

六、查看代码修改

如果你修改过文件，例如：

docker-setup.sh

查看状态：

git status

示例：

modified: docker-setup.sh

说明：

文件被修改
但还没有提交

---

七、为什么不要直接修改 main

默认分支是：

main

如果直接在 main 修改：

升级可能冲突

正确方式是：

创建自己的分支

---

八、创建自己的配置分支

创建新分支：

git checkout -b local-config

查看分支：

git branch

输出：

* local-config
  main

说明当前分支是：

local-config

---

九、保存自己的修改

例如修改了：

docker-setup.sh

第一步：

加入暂存区

git add docker-setup.sh

第二步：

提交修改

git commit -m "custom docker setup"

提交完成。

---

十、Git 提交结构

项目结构会变成：

main  (官方代码)
   │
   └── local-config  (你的修改)

---

十一、以后升级官方版本

正确流程：

1 更新官方代码

git checkout main
git pull

---

2 更新自己的分支

git checkout local-config
git merge main

这样：

官方更新
↓
自动合并到你的版本

---

十二、查看分支

查看所有分支：

git branch

查看远程分支：

git branch -a

---

十三、撤销未提交修改

如果改坏了文件：

git restore docker-setup.sh

恢复到原始版本。

---

十四、查看修改内容

查看修改差异：

git diff

可以看到：

旧代码
新代码

---

十五、查看提交历史

查看提交记录：

git log

简洁版本：

git log --oneline

示例：

f2f561fab update plugins
4d501e4cc fix telegram bug

---

十六、最推荐的服务器 Git 结构

服务器运行项目推荐：

openclaw/
│
├── main            (官方)
│
└── local-config    (本地修改)

只允许修改：

docker-setup.sh
.env
openclaw.json

这样：

升级几乎不会冲突

---

十七、完整升级流程（推荐）

以后升级 OpenClaw：

cd openclaw

git checkout main
git pull

git checkout local-config
git merge main

docker compose down
docker compose up -d --build

---

十八、Git 常用命令总结

命令	作用
git clone	下载项目
git pull	更新代码
git status	查看状态
git branch	查看分支
git checkout	切换分支
git checkout -b	创建分支
git add	添加修改
git commit	提交修改
git merge	合并分支
git diff	查看差异

---

十九、一句话总结

服务器使用 Git 的核心原则：

官方代码用 main
自己修改用分支
升级用 merge

这样可以做到：

长期稳定升级
配置不会丢