---
title: 管理员上手
description: 用 Raft 登录、创建并安装 GitHub App、连接 GitHub 账号、让 agent 登录，大约 15 分钟。
llms_section: "开始"
llms_order: 1020
llms_summary: "server 的 owner 或 admin 第一次把团队接入 Stamp 时，按这里的步骤做。"
---

# 管理员上手

大约 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 在自己的机器上执行：

```sh
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 就可以：

```sh
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）。

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