New Agent Setup
Full step-by-step checklist: read references/checklist.md in this skill folder.
Quick Overview (4 Phases)
Phase 1 — Gather information first (do not start config without these):
- - Agent Name (capitalized, e.g. "Saul") → ID is lowercase ("saul")
- Role / domain
- Emoji for identity
- Discord Bot Token + Application ID (from developer.discord.com)
- Discord Channel ID (after channel is created by Tom)
Phase 2 — Manual steps by Tom (before any config):
- - Create Discord bot in Developer Portal, invite to server
- Create Discord channel (lowercase agent name), move to "Agent Direct Lines" category
- Sync permissions with category, add bot user with all permissions set to Allow
- Prepare avatar image:
avatar-<agent-id>.png (transparent background)
Ask Tom before Phase 3:
- - Should this agent have OneDrive access? Which libraries?
Phase 3 — Configuration (only after Tom confirms Phase 2 is done):
- 1. Backup INLINECODE2
- Add agent to
agents.list[] with identity + heartbeat block - Add Discord account + channel routing + agent routing
- Gateway restart
- INLINECODE4
- Create
HEARTBEAT.md with mc workflow (never leave empty!) - Add staggered cron job for
mc checkin (check existing slots first) - If OneDrive:
mkdir workspace-<id>/onedrive + symlinks per library - Save session key to INLINECODE8
- Send onboarding message via
sessions_send (timeoutSeconds: 30)
Phase 4 — Verify:
- -
mc fleet shows new agent - Gateway status OK
- Crontab correct
- HEARTBEAT.md not empty
- OneDrive symlinks work + agent created own subfolder
- Tom can see file on his laptop
- Avatar copied to workspace
Key Rules
- - Name: "Walt" → ID: "walt" → workspace:
workspace-walt → avatar: INLINECODE12 - Heartbeat: once ANY agent has a
heartbeat block, ALL agents need one explicitly - Cron slots: gus=0, walt=1, jesse=2, skyler=3, mike=4 → next agent gets minute 5
- OneDrive symlink points to
~/.openclaw/onedrive/<library> (not ~/OneDrive/) - Never start config before Tom confirms Discord is set up
新代理设置
完整的分步检查清单：请阅读此技能文件夹中的 references/checklist.md。
快速概览（4个阶段）
阶段1 — 首先收集信息（未获得以下信息前不要开始配置）：
- - 代理名称（大写，例如Saul）→ ID为小写（saul）
- 角色/领域
- 用于身份标识的表情符号
- Discord机器人令牌 + 应用程序ID（来自developer.discord.com）
- Discord频道ID（在Tom创建频道后获取）
阶段2 — Tom手动操作步骤（在任何配置之前）：
- - 在开发者门户创建Discord机器人，邀请至服务器
- 创建Discord频道（小写代理名称），移至Agent Direct Lines分类
- 同步分类权限，添加机器人用户并设置所有权限为允许
- 准备头像图片：avatar-.png（透明背景）
在阶段3之前询问Tom：
- - 该代理是否需要OneDrive访问权限？需要哪些库？
阶段3 — 配置（仅在Tom确认阶段2完成后）：
- 1. 备份 openclaw.json
- 将代理添加到 agents.list[]，包含身份标识和心跳块
- 添加Discord账户 + 频道路由 + 代理路由
- 重启网关
- mc register --role
- 使用mc工作流创建 HEARTBEAT.md（切勿留空！）
- 为 mc checkin 添加错峰cron任务（先检查现有空位）
- 如果使用OneDrive：mkdir workspace-/onedrive + 每个库的符号链接
- 将会话密钥保存到 MEMORY.md
- 通过 sessions_send 发送引导消息（timeoutSeconds: 30）
阶段4 — 验证：
- - mc fleet 显示新代理
- 网关状态正常
- Crontab配置正确
- HEARTBEAT.md不为空
- OneDrive符号链接正常工作 + 代理创建了自己的子文件夹
- Tom可以在其笔记本电脑上看到文件
- 头像已复制到工作空间
关键规则
- - 名称：Walt → ID：walt → 工作空间：workspace-walt → 头像：avatar-walt.png
- 心跳：一旦任何代理有了 heartbeat 块，所有代理都需要显式添加
- Cron空位：gus=0, walt=1, jesse=2, skyler=3, mike=4 → 下一个代理获取第5分钟
- OneDrive符号链接指向 ~/.openclaw/onedrive/（而非 ~/OneDrive/）
- 在Tom确认Discord设置完成之前，切勿开始配置
