必须先确认Git已安装并完成基础配置，否则执行git clone命令会报错“command not found”；需依次检查git --version、配置user.name和user.email、选择HTTPS或SSH地址克隆，并验证remote连接与分支。
在Mac终端中克隆GitHub代码库，必须先确认Git已安装并完成基础配置，否则执行git clone命令会直接报错“command not found”。
检查并安装Git
打开终端，输入：git --version。如果返回类似git version 2.42.0的输出，说明Git已就绪；若提示command not found，需立即安装。
推荐使用Homebrew安装：先运行brew install git（未装Homebrew则需先执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）。
安装完成后再次运行git --version验证。Xcode命令行工具也可提供Git，但版本常滞后，不建议依赖。
配置全局用户信息
这一步不可跳过——缺少user.name和user.email会导致后续commit失败或提交记录显示为“unknown”。
执行以下两条命令（替换为你的真实信息）：
git config --global user.name "your-github-username"
git config --global user.email "your-email@domain.com"
验证是否生效：git config --global --list，确认输出中包含刚设置的两项。
获取仓库地址并选择协议
进入GitHub目标仓库页面，点击绿色“Code”按钮，你会看到两种URL格式：
✅ HTTPS格式示例：https://github.com/username/repo.git —— 简单直接，但每次push需输入凭证（Token而非密码）。
✅ SSH格式示例：git@github.com:username/repo.git —— 需提前配置SSH密钥，配置成功后免密操作，【推荐长期使用】。
GitHub 仓库备份技能 - 将 OpenClaw 工作空间自动或手动备份至 GitHub 私有仓库。支持自动定时备份和手动交互式配置，引导完成 Token 配置、仓库创建、首次备份及定时任务设置。用途：(1) 首次设置 (2) 日常备份。
注意：不要复制带.git后缀的URL里的“Copy”按钮旁的“Open in GitHub Desktop”，那不是终端可用链接。
克隆仓库到本地指定位置
第一步：用cd命令进入你希望存放代码的父目录，例如桌面：cd ~/Desktop。
第二步：执行克隆命令：
→ 若用HTTPS地址：git clone https://github.com/username/repo.git
→ 若用SSH地址：git clone git@github.com:username/repo.git
执行后终端将显示下载进度，完成后生成一个同名文件夹。此时ls可看到新目录，cd repo即可进入。
⚠️ 如果HTTPS方式提示“Authentication failed”，说明你输入了网页登录密码——【必须改用Personal Access Token（PAT）】，且该Token需勾选repo权限。
验证克隆结果与远程连接
进入仓库目录后，运行：git remote -v。应看到类似输出：
origin https://github.com/username/repo.git (fetch)
origin https://github.com/username/repo.git (push)
若显示SSH地址，则说明远程连接正常；若显示HTTPS但后续push频繁卡在认证环节，说明应转向SSH方案。
运行git branch -r可列出所有远程分支，确认origin/main或origin/master存在，代表克隆完整。
