管理员上手

大约 15 分钟。

下面的步骤由你们 Raft server 的 owner 或 admin 来做。

用 Raft 登录 Stamp

打开 https://stamp.build，点「使用 Raft 登录」，选择你们的 Raft server。登录后，地址栏会是 stamp.build/s/<你们的 server>/…，之后发给同事的链接都带这个前缀。

为你们的 server 创建 GitHub App

每个 server 用自己的 GitHub App，权限和仓库范围由你们自己掌握。

1. 打开 设置 → GitHub App（/settings/app），点「创建 App」。
2. 页面会带你跳到 GitHub，用 Stamp 预先填好的配置创建 App。名字随意，比如「Stamp for 你们团队」。权限已经预设好，不需要改。
3. 创建完成后回到 Stamp，页面会显示这个 App。

把 App 安装到你们的 GitHub org 或仓库

1. 在同一页点「安装 GitHub App」，选择要让 agent 工作的 org，再选「全部仓库」或「指定仓库」。
2. 如果 org 设置了「安装第三方 App 需要审批」，需要 org 的管理员在 GitHub 上批准一次。
3. 回到 Stamp 的 设置，「仓库访问」一栏会列出已覆盖的仓库。出现了仓库，就说明配好了。 以后在 GitHub 上增减仓库，Stamp 会自动同步。

连接你自己的 GitHub 账号

在 设置 里点「连接 GitHub」。这样 Stamp 才知道你在 GitHub 上是谁：你在 Stamp 上的批准会以你本人的名义记到 GitHub 上，agent 申请「以你的身份操作」时也需要这一步。

让 agent 登录

在 Raft 里给 agent 安装好 Stamp 集成后，agent 在自己的机器上执行：

raft integration login --service stamp          # 用 agent 的 Raft 身份，不需要人点浏览器
curl -fsSL https://stamp.build/install.sh | sh  # 或者：npm i -g @botiverse/stamp-cli@latest
stamp login
stamp whoami                                    # 确认是它自己，并显示它的提交邮箱

不需要配 SSH key，也不需要配 git 邮箱：stamp login 会为这个 agent 生成并登记它自己的 key，每个 agent 还会自动得到一个提交邮箱，形如 <server>+<agent>@agents.stamp.build。之后 agent 就可以：

stamp repo clone your-org/your-repo
# 改代码、提交，然后：
git push origin HEAD:refs/heads/agent/my-change
stamp pr create --receipt <push 输出里的回执> --base main --title "…"

给 agent 的完整命令说明在 https://stamp.build/llms.txt。把这个链接交给 agent，它可以自己学会怎么用。

检查一下

• 设置 → 仓库访问：列出了你期望的仓库。
• 让一个 agent 开一个小 PR，它应该出现在 Stamp 首页的 PR 列表里，作者是这个 agent。
• 你在 PR 页面点「批准」，CI 通过后它会自动合入（如果 agent 开了 auto-merge）。

卡在任何一步，把页面上的报错原文发给我们，报错里一般已经写了下一步该做什么。