docs: overhaul onboarding checklist

- Phase 8: network & domain (assign subdomain, Named Tunnel, DNS)
- Phase 9: SSH mesh between nodes (mutual rescue capability)
- Phase 11: dedicated daemon & keepalive section
- Phase 12: auth items explicitly marked as 'leave for new agent'
- Reordered phases for logical flow
- Added bun to Phase 1
This commit is contained in:
shazhou-ww 2026-03-30 15:26:16 +00:00
parent 7074b09534
commit 5a478ed576

View File

@ -1,6 +1,6 @@
# Onboarding Buddy Checklist
新设备 onboarding 的完整检查清单。由 buddy agent 在 SSH 进入新设备后逐项执行
新设备 onboarding 的完整检查清单。Buddy agent 负责能代做的部分,需要认证/权限的留给新 agent 启动后自行向主人申请
---
@ -15,6 +15,7 @@
- [ ] Node.js v22+ 安装
- [ ] OpenClaw 安装(`npm install -g openclaw`
- [ ] pnpm 安装(skill 安装需要)
- [ ] bun 安装(copilot-api 需要)
- [ ] git 配置(user.name / user.email)
## Phase 2:身份与人格
@ -28,8 +29,8 @@
## Phase 3:LLM Provider 配置
- [ ] LiteLLM 接入(共享实例或自建
- [ ] copilot-api 配置(如有 Copilot 订阅)
- [ ] LiteLLM 接入配置(写入 openclaw.json
- [ ] copilot-api 源码 + 依赖安装
- [ ] openclaw.json models 配置
- [ ] Model fallbacks 设置(主 → 备 → 兜底)
- [ ] 验证:agent 能正常回复消息
@ -43,8 +44,7 @@
## Phase 5:开发工具链
- [ ] GitHub CLI (`gh`) 安装 + 认证
- [ ] git 全局配置
- [ ] GitHub CLI (`gh`) 安装
- [ ] copilot-cli 安装(如有订阅)
- [ ] cursor-agent 安装(如有订阅)
- [ ] claude-code 安装(如有订阅)
@ -68,43 +68,53 @@
- [ ] 配置 peers(与现有小队互联)
- [ ] 现有小队的 peers 反向配置新成员
- [ ] 双向 A2A 通信验证(ping-pong 测试)
- [ ] 公网域名配置(Named Tunnel / DNS 记录)
- [ ] nginx 反代 + SSL(如在 VM 上)
## Phase 8:知识系统
## Phase 8:网络与域名
- [ ] 分配公网域名(如 `oc-sora.shazhou.work`
- [ ] 配置 Named Tunnel(Cloudflare)或 A 记录(VM)
- [ ] nginx 反代 + SSL(如在 VM 上)
- [ ] 验证域名可达(Agent Card URL 能访问)
## Phase 9:节点互联(SSH 互信)
- [ ] 新节点 → 现有节点 SSH 打通(新 agent 能 SSH 到 KUMA/NEKO 等)
- [ ] 现有节点 → 新节点 SSH 打通(KUMA/NEKO 能 SSH 到新设备)
- [ ] 验证双向 SSH 连通
- [ ] 用途:跨节点救援、协作部署、故障恢复
## Phase 10:知识系统
- [ ] memex CLI 安装 + 配置
- [ ] memex cards 仓库 clone(shazhou-ww/memex-cards)
- [ ] memex cards 仓库 clone
- [ ] oc-wiki 仓库 clone
- [ ] MEMORY.md 初始化
- [ ] memory/ 目录创建
## Phase 9:权限与凭证
## Phase 11:Daemon 与保活
需要人类主人提供的权限清单:
- [ ] OpenClaw Gateway daemon 化 + 开机自启:
- **Linux**: `openclaw gateway install`(systemd)
- **macOS**: `openclaw gateway install`(launchd)
- [ ] copilot-api daemon 化 + 开机自启
- [ ] cloudflared Named Tunnel daemon 化 + 开机自启
- [ ] 保活策略验证(KeepAlive / Restart=always)
- [ ] 验证重启后所有服务自动恢复
- [ ] GitHub 账号/Token(或 gh auth login 授权)
- [ ] Cloudflare API Token(DNS 管理)
- [ ] LiteLLM API Key
## Phase 12:权限与凭证(留给新 agent 自行申请)
以下项目 buddy agent **不代做**,在新 agent 的 MEMORY.md 或启动留言中列出,让她启动后自行向主人申请:
- [ ] GitHub 认证(`gh auth login`
- [ ] Copilot API 认证(`copilot-api auth`
- [ ] Cloudflare API Token
- [ ] LiteLLM API Key(如未预配)
- [ ] SiliconFlow API Key(如需要)
- [ ] npm Token(如需要发包)
- [ ] 邮箱账号(如需要收发邮件)
- [ ] 其他 API Keys(按需)
## Phase 10:Gateway 上线
- [ ] openclaw gateway start
- [ ] 服务 daemon 化 + 开机自启:
- **Linux**: systemd service (`openclaw gateway install`)
- **macOS**: launchd plist (`~/Library/LaunchAgents/`)
- [ ] copilot-api daemon 化 + 开机自启(如使用)
- [ ] cloudflared tunnel daemon 化 + 开机自启(如使用 Named Tunnel)
- [ ] 保活策略配置(KeepAlive / Restart=always)
- [ ] Gateway 健康检查
- [ ] Telegram/飞书消息收发验证
- [ ] A2A 端到端验证
## Phase 11:Smoke Test
## Phase 13:Smoke Test
- [ ] Agent 能通过 IM 正常对话
- [ ] Agent 能执行 shell 命令
@ -120,5 +130,6 @@
- **先立新再拆旧** — 如果是迁移,确保新环境完全验证后再关旧的
- **Token 传输** — 只通过 A2A 或主人居中传递,不在 IM 里发
- **Auth 不代做** — 需要人类授权的事项留给新 agent 启动后自行申请
- **每完成一个 Phase 汇报一次** — 让主人知道进度
- **出错就停** — 不要带着错误继续,先修再推进