必须先执行git pull origin main --allow-unrelated-histories合并远程readme，再add、commit、push；否则因历史不兼容导致推送失败。

能绑定，但必须分清“有没有初始化”和“远程仓库是否为空”这两个前提，否则 git push 会失败，git pull 会报 refusing to merge unrelated histories。

本地还没 init，但远程仓库已存在（含 README.md）

这是最常踩坑的场景：你写了几天代码，文件夹里没 .git，然后在 Gitee/GitHub 上手快建了个带 README.md 的仓库。直接 git remote add origin <url></url> 后 git push 必然失败——因为本地没提交历史，远程却有。

• 先进项目目录，运行 git init 创建本地仓库
• 再执行 git remote add origin <your-repo-url></your-repo-url> 绑定远程
• 关键一步：运行 git pull origin main --allow-unrelated-histories（注意分支名是 main 还是 master，看远程实际分支）
• 此时 README.md 会落到本地，再 git add . && git commit -m "Import existing code"
• 最后 git push -u origin main 完成首次推送

本地已 init 且有提交，但远程是空仓库

这种情况最干净，不需要处理“无关历史”，但容易漏掉 -u 参数导致后续 git push 每次都要写分支名。

Evez Github Manager

在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。

下载

• 确认本地已有至少一次 git commit（git log 能看到记录）
• 执行 git remote add origin <url></url>
• 用 git push -u origin main（或 master）推送并建立上游追踪
• 之后只需 git push，Git 就知道推到哪去
• 如果忘了 -u，后续可用 git branch --set-upstream-to=origin/main main 补救

想同时连两个远程仓库（比如自己 fork 的 + 原作者 upstream）

不是所有项目都只需要一个 origin。比如你要维护 fork 仓库，又得定期同步上游更新，就得配两个远程地址。

• 先加自己的仓库：git remote add origin git@github.com:yourname/repo.git
• 再加原仓库（别名习惯叫 upstream）：git remote add upstream https://github.com/original-owner/repo.git
• 验证是否成功：git remote -v 会列出两个地址
• 拉上游更新时用：git fetch upstream main && git merge upstream/main（不建议直接 pull，避免意外合并）
• 推代码仍用 git push origin main，不会误推到 upstream

真正容易被忽略的是分支名匹配和首次拉取策略：远程用 main，你本地还按老习惯 push master，或者没加 --allow-unrelated-histories 就硬 pull，都会卡住。操作前先 git ls-remote origin 看一眼远程有哪些分支，比猜靠谱得多。