# New Agent Onboarding Template

## 0) Register MCP once per client

- Codex:

```bash
codex mcp add memory-gateway --url http://100.64.0.45:8787/mcp
```

- Claude/Cursor: 在对应客户端 MCP 配置中添加同一 URL：
  - `http://100.64.0.45:8787/mcp`

## 1) Create agent lane

```bash
cd /Users/lingyuzeng/project/collective-memory-repo
scripts/add-agent.sh <agent-id>
```

Example:

```bash
scripts/add-agent.sh kimi-helper
```

## 2) (Optional) Auto update OpenClaw qmd paths

```bash
scripts/add-agent.sh <agent-id> --openclaw-config ~/.openclaw/openclaw.json
```

## 3) Session first message (recommended)

```bash
cd /Users/lingyuzeng/project/collective-memory-repo
scripts/print-session-bootstrap.sh --tool codex --branch main
```

任务会话示例：

```bash
scripts/print-session-bootstrap.sh --tool codex --branch task/openclawd-migration-2026-03 --task-id openclawd-migration-2026-03
```

## 4) Commit and push

```bash
git add agents/<agent-id>
git commit -m "feat(agent): add <agent-id> memory lane"
git push
```

## 5) Verify memory-gateway visibility

```bash
curl -fsS http://100.64.0.45:8787/health
printf '{"branch":"main","require_latest":true}' \
| curl -fsS -H 'content-type: application/json' -d @- \
  http://100.64.0.45:8787/memory/status
```

## 6) Query smoke test

```bash
printf '{"query":"<agent-id>","branch":"main","require_latest":true,"top_k":3}' \
| curl -fsS -H 'content-type: application/json' -d @- \
  http://100.64.0.45:8787/memory/search
```