GitHub SSH密钥配置需四步：一、检查~/.ssh目录下是否存在id_rsa.pub或id_ed25519.pub；二、若无则用ssh-keygen -t ed25519 -C "邮箱"生成；三、启动ssh-agent并ssh-add添加私钥；四、复制公钥内容到GitHub账户SSH设置中。
如果您尝试通过 SSH 协议与 GitHub 仓库交互，但连接被拒绝或提示权限错误，则可能是本地未正确生成或添加 SSH 密钥。以下是完成 GitHub SSH Key 配置的完整步骤：
一、检查是否已存在 SSH 密钥
GitHub 要求客户端使用 SSH 密钥对进行身份验证，避免每次推送都输入用户名和密码。若本地已有可用的密钥对（如 id_rsa 或 id_ed25519），可跳过生成步骤直接添加公钥到 GitHub。
1、打开终端（macOS/Linux）或 Git Bash（Windows）。
2、执行命令：ls -al ~/.ssh。
3、查看输出中是否存在 id_rsa.pub 或 id_ed25519.pub 文件。
二、生成新的 SSH 密钥对
若未发现可用密钥文件，需生成一对新的加密密钥。推荐使用 Ed25519 算法，因其安全性更高且密钥更短；若系统不支持，可回退至 RSA。
1、在终端中运行命令：ssh-keygen -t ed25519 -C "your_email@example.com"（将邮箱替换为 GitHub 注册邮箱）。
2、按回车键接受默认保存路径（~/.ssh/id_ed25519）。
3、可选：输入密码短语（passphrase）以增强私钥安全性；直接回车则不设密码。
三、启动 SSH 代理并添加私钥
SSH 代理负责在后台管理私钥，避免重复输入密码短语，并确保 Git 操作能自动使用对应密钥。
1、启动代理：eval "$(ssh-agent -s)"。
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
2、将私钥添加至代理：ssh-add ~/.ssh/id_ed25519（若使用 RSA，则替换为 id_rsa）。
3、验证添加成功：ssh-add -l，应显示密钥指纹及路径。
四、将公钥添加到 GitHub 账户
GitHub 需要您的公钥才能识别并信任来自该设备的连接请求。此操作必须在 GitHub 网页端完成，且公钥内容须完整无误。
1、复制公钥内容：cat ~/.ssh/id_ed25519.pub | pbcopy（macOS）；Linux 使用 xclip -sel clip ；Windows Git Bash 使用 clip 。
2、登录 GitHub 网站，点击右上角头像 → Settings → SSH and GPG keys → New SSH key。
3、Title 栏填写设备标识（如 “Work MacBook Pro”）；Key type 选择 “Authentication key”；粘贴已复制的公钥内容。
4、点击 Add SSH key 完成提交。
五、测试 SSH 连接有效性
配置完成后，必须验证 GitHub 是否能成功识别并响应 SSH 请求。此步骤不可跳过，否则后续 Git 操作仍将失败。
1、在终端中运行：ssh -T git@github.com。
2、首次连接时会提示确认主机密钥指纹，输入 yes 继续。
3、若看到类似 Hi username! You've successfully authenticated... 的消息，表示配置成功。
