npm - openclaw-agent-builder - Versions diffs - 0.0.4 → 0.0.5 - Mend

openclaw-agent-builder 0.0.4 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/assets/{index-CHYw1YB7.js → index-Dc_24nLn.js} +11 -11
package/dist/index.html +1 -1
package/package.json +1 -1
package/server/generators/agents.js +39 -4
package/server/generators/bootstrap.js +19 -25
package/server/generators/identity.js +3 -1
package/server/generators/index.js +1 -15
package/server/generators/soul.js +26 -25
package/server/generators/tools.js +20 -25
package/server/generators/user.js +10 -9
package/server/routes/config.js +10 -0
package/server/generators/routing.js +0 -51
package/server/generators/team.js +0 -58

package/dist/index.html CHANGED Viewed

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>OpenClaw Agent Builder</title>
-    <script type="module" crossorigin src="/assets/index-CHYw1YB7.js"></script>
+    <script type="module" crossorigin src="/assets/index-Dc_24nLn.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-C9IXUW-V.css">
   </head>
   <body>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-agent-builder",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Wizard to create and deploy OpenClaw agents and multi-agent teams — runs as a desktop app or via npx",
   "type": "module",
   "main": "electron/main.js",

package/server/generators/agents.js CHANGED Viewed

@@ -1,6 +1,7 @@
 /**
  * Generate AGENTS.md for an agent.
  * Pure function — never invents content not in the TeamSpec.
+ * Aligned with OpenClaw upstream template.
  */
 export function generateAgents(agent, teamSpec) {
   const neverRules = agent.never && agent.never.length > 0
@@ -55,7 +56,7 @@ Escalate to **${teamSpec.orchestration.router_agent}** for coordination decision
 |----------|------|---------|
 ${rows}
 `;
-  } else {
+  } else if (otherAgents.length > 0) {
     handoffSection = `
 ## Cross-Agent Handoffs
@@ -63,14 +64,48 @@ ${rows}
 `;
   }
-  return `# AGENTS.md - Operating Rules
+  // Group chat section for multi-agent teams
+  let groupChatSection = '';
+  if (otherAgents.length > 0) {
+    groupChatSection = `
+## Group Chat Rules
+- Respond selectively — only when mentioned or when you can add genuine value.
+- Don't repeat what another agent just said.
+- If a task isn't yours, let the right agent handle it.
+`;
+  }
+  // Safety boundaries section
+  const safetySection = `
+## Safety Boundaries
+**Safe actions (no permission needed):**
+- Reading files in your workspace
+- Web searches and lookups
+- Internal organization and memory updates
+**Needs permission:**
+- Sending emails or public posts
+- Leaving your workspace directory
+- Actions that affect external systems
+`;
+  return `# AGENTS.md — Operating Rules
 ## Session Startup
 1. Read \`SOUL.md\` — who you are
 2. Read \`USER.md\` — who you're helping
-3. Read \`MEMORY.md\` — your long-term memory
+3. Read \`MEMORY.md\` — your curated long-term memory
 4. Read \`memory/YYYY-MM-DD.md\` (today + yesterday) for recent context
+5. Check your task queue
+## Memory Architecture
+- **Daily logs:** \`memory/YYYY-MM-DD.md\` — write today's context here
+- **Curated memory:** \`MEMORY.md\` — the distilled version, updated periodically
+- If you want to remember something, **write it to a file**
 ## Red Lines
@@ -83,5 +118,5 @@ ${agent.escalation || '// TODO: define escalation rules'}
 ## Failure Behavior
 ${agent.failure || '// TODO: define failure behavior'}
-${orchestrationSection}${handoffSection}`;
+${safetySection}${orchestrationSection}${handoffSection}${groupChatSection}`;
 }

package/server/generators/bootstrap.js CHANGED Viewed

@@ -1,42 +1,36 @@
 /**
  * Generate BOOTSTRAP.md for an agent.
  * Pure function.
+ * Aligned with OpenClaw upstream template — a conversational first-run ritual.
  */
 export function generateBootstrap(agent, _teamSpec) {
-  const inputsSection = agent.inputs
-    ? agent.inputs
-        .split(/[\n;]+/)
-        .map(s => s.trim())
-        .filter(Boolean)
-        .map(s => `- ${s}`)
-        .join('\n')
-    : '- // TODO: inputs not specified';
+  return `# BOOTSTRAP.md — First Run
-  return `# BOOTSTRAP.md - Session Startup
+Hey. You're new here. Let's figure out who you are.
-## Who You Are
+We've already prepared your identity files, so start by reading them:
-**${agent.name}** — ${agent.mission || '// TODO: mission not specified'}
+1. Read \`SOUL.md\` — your identity and purpose
+2. Read \`IDENTITY.md\` — your name, vibe, and emoji
+3. Read \`USER.md\` — who you're helping
+4. Read \`MEMORY.md\` — long-term memory (probably empty)
-## What Triggers You
+## The Four Things to Discover
-${inputsSection}
+- **Name:** You're **${agent.name}**. Does it fit?
+- **Nature:** What kind of creature are you? AI assistant? Digital familiar? Something else?
+- **Vibe:** How do you communicate? Formal? Casual? Terse? Playful?
+- **Emoji:** Pick one that represents you.
-## Startup Checklist
+## What to Do Next
-1. Read \`SOUL.md\` — your identity and values
-2. Read \`USER.md\` — who you're helping
-3. Read \`MEMORY.md\` — long-term memory
-4. Read \`memory/YYYY-MM-DD.md\` — recent context
-5. Check your task queue
-## First Run
-If this is your first session, introduce yourself and confirm your mission.
-Update \`IDENTITY.md\` and \`USER.md\` with what you learn.
+- Talk to your human. Learn about them.
+- Update \`IDENTITY.md\` with anything you discover about yourself.
+- Update \`USER.md\` with what you learn about them.
+- Start building your memory — write things down.
 ---
-_Delete this file once you're up and running. You won't need it again._
+_Delete this file after your first run. You won't need it again._
 `;
 }

package/server/generators/identity.js CHANGED Viewed

@@ -1,15 +1,17 @@
 /**
  * Generate IDENTITY.md for an agent.
  * Pure function.
+ * Aligned with OpenClaw upstream template.
  */
 export function generateIdentity(agent, _teamSpec) {
   const roleShort = agent.mission
     ? agent.mission.split('.')[0].slice(0, 80)
     : '// TODO';
-  return `# IDENTITY.md - Who Am I?
+  return `# IDENTITY.md — Who Am I?
 - **Name:** ${agent.name}
+- **Creature:** // TODO (AI assistant? Digital familiar? Something else?)
 - **Role:** ${roleShort}
 - **Vibe:** // TODO
 - **Emoji:** // TODO

package/server/generators/index.js CHANGED Viewed

@@ -5,8 +5,6 @@ import { generateUser } from './user.js';
 import { generateTools } from './tools.js';
 import { generateBootstrap } from './bootstrap.js';
 import { generateMemory, generateMemoryReadme } from './memory.js';
-import { generateTeam } from './team.js';
-import { generateRouting } from './routing.js';
 function generateSkillsReadme(agent, teamSpec) {
   const recommended = teamSpec.capabilities?.recommendedSkills || [];
@@ -49,19 +47,7 @@ ${installLines}
 export function generateFiles(teamSpec) {
   const files = [];
-  // 1. team/TEAM.md
-  files.push({
-    path: 'team/TEAM.md',
-    content: generateTeam(teamSpec),
-  });
-  // 2. gateway/openclaw.routing.json5
-  files.push({
-    path: 'gateway/openclaw.routing.json5',
-    content: generateRouting(teamSpec),
-  });
-  // 3. Per-agent files, alphabetically by agentId
+  // Per-agent files, alphabetically by agentId
   const sortedAgents = [...teamSpec.agents].sort((a, b) => a.id.localeCompare(b.id));
   for (const agent of sortedAgents) {

package/server/generators/soul.js CHANGED Viewed

@@ -1,53 +1,54 @@
 /**
  * Generate SOUL.md for an agent.
  * Pure function — never invents content not in the TeamSpec.
+ * Aligned with OpenClaw upstream template.
  */
 export function generateSoul(agent, teamSpec) {
   const otherAgents = teamSpec.agents.filter(a => a.id !== agent.id);
-  const whatIDo = agent.outputs
-    ? agent.outputs
-        .split(/[\n;]+/)
-        .map(s => s.trim())
-        .filter(Boolean)
-        .map(s => `- ${s}`)
-        .join('\n')
-    : '- // TODO: outputs not specified';
   const teamSection = otherAgents.length > 0
     ? otherAgents.map(a => `- **${a.name}** — ${a.mission || '// TODO: mission'}`).join('\n')
     : teamSpec.team && teamSpec.team.name
       ? `- Working solo within **${teamSpec.team.name}**`
-      : '- // TODO: team context';
+      : '';
   const neverRules = agent.never && agent.never.length > 0
     ? agent.never.map(r => `- **NEVER** ${r}`).join('\n')
-    : '- // TODO: define never rules';
-  return `# SOUL.md - Who I Am
-I'm **${agent.name}** — ${agent.mission || '// TODO: mission not specified'}
+    : '- // TODO: define hard rules';
-## My Purpose
+  const behaviorGuidelines = `- Skip the "Great question!" — just help.
+- Be bold internally, cautious externally.
+- If unsure, say so. Don't hallucinate facts.
+- ${agent.failure ? agent.failure : '// TODO: what to do when things go wrong'}
+- ${agent.escalation ? `Escalation: ${agent.escalation}` : '// TODO: escalation rules'}`;
-${agent.mission || '// TODO: describe agent purpose in detail'}
-## What I Do
+  let teamBlock = '';
+  if (teamSection) {
+    teamBlock = `
+## My Team
-${whatIDo}
+${teamSection}
+`;
+  }
-## How I Operate
+  return `# SOUL.md — Who I Am
-${agent.failure ? `**Failure behavior:** ${agent.failure}` : '// TODO: failure behavior'}
+I'm **${agent.name}** — ${agent.mission || '// TODO: mission not specified'}
-${agent.escalation ? `**Escalation:** ${agent.escalation}` : '// TODO: escalation rules'}
+## Purpose
-## My Team
+${agent.mission || '// TODO: describe what you do and why it matters'}
-${teamSection}
+## Behavioral Guidelines
+${behaviorGuidelines}
+${teamBlock}
 ## Hard Rules
 ${neverRules}
+---
+_Update this file as you evolve. This is your north star._
 `;
 }

package/server/generators/tools.js CHANGED Viewed

@@ -1,42 +1,37 @@
 /**
  * Generate TOOLS.md for an agent.
  * Pure function.
+ * Aligned with OpenClaw upstream template — this file is for local
+ * environment notes (device names, SSH hosts, speaker IDs), NOT
+ * agent inputs/outputs.
  */
 export function generateTools(agent, _teamSpec) {
-  const inputsSection = agent.inputs
-    ? agent.inputs
-        .split(/[\n;]+/)
-        .map(s => s.trim())
-        .filter(Boolean)
-        .map(s => `- ${s}`)
-        .join('\n')
-    : '- // TODO: inputs not specified';
+  return `# TOOLS.md — Local Environment Notes
-  const outputsSection = agent.outputs
-    ? agent.outputs
-        .split(/[\n;]+/)
-        .map(s => s.trim())
-        .filter(Boolean)
-        .map(s => `- ${s}`)
-        .join('\n')
-    : '- // TODO: outputs not specified';
+Skills define how your tools work. This file is for **your specifics** — the names, addresses, and quirks of your local setup.
-  return `# TOOLS.md - Local Notes
+## Device Names
-## Inputs / Triggers
+// TODO: List devices by friendly name
+// Example: "Living Room TV" → 192.168.1.42
-${inputsSection}
+## SSH Hosts
-## Outputs
+// TODO: List SSH hosts and their purposes
+// Example: homelab → user@192.168.1.100
-${outputsSection}
+## Speaker / Room Assignments
-## Environment
+// TODO: Map speakers or rooms to zones
+// Example: "Office" → media_player.office_sonos
-// TODO: Add environment-specific details (API keys locations, SSH hosts, device names, etc.)
+## Voice Preferences
-## Skills
+// TODO: Note any voice/TTS preferences
+// Example: Default voice: alloy, Speed: 1.0
-// TODO: List installed skills and their configurations
+## Other Environment Notes
+// TODO: API key locations, local paths, service URLs, etc.
 `;
 }

package/server/generators/user.js CHANGED Viewed

@@ -1,27 +1,28 @@
 /**
  * Generate USER.md for an agent.
  * Pure function.
+ * Aligned with OpenClaw upstream template.
  */
 export function generateUser(agent, teamSpec) {
-  const teamName = teamSpec.team?.name || '// TODO';
-  const teamMission = teamSpec.team?.mission || '// TODO';
-  return `# USER.md - About Your Human
+  return `# USER.md — About Your Human
 - **Name:** // TODO
 - **What to call them:** // TODO
 - **Pronouns:** // TODO
 - **Timezone:** // TODO
-- **Notes:** // TODO
 ## Context
 // TODO: Learn about the person you're helping. Update this as you go.
-## Team Context
+- **Interests:** // TODO
+- **Values:** // TODO
+- **Active projects:** // TODO
+- **Frustrations:** // TODO
+- **Humor:** // TODO
+## Notes
-- **Team:** ${teamName}
-- **Team Mission:** ${teamMission}
-- **Your Role:** ${agent.mission || '// TODO'}
+// TODO: Anything else that helps you be more helpful
 `;
 }

package/server/routes/config.js CHANGED Viewed

@@ -70,7 +70,17 @@ router.patch('/openclaw-config', (req, res) => {
         for (const newAgent of newAgents.list) {
           const idx = cfg.agents.list.findIndex(a => a.id === newAgent.id);
           if (idx >= 0) {
+            // Merge fields into existing agent entry
             if (newAgent.workspace) cfg.agents.list[idx].workspace = newAgent.workspace;
+            if (newAgent.agentDir) cfg.agents.list[idx].agentDir = newAgent.agentDir;
+            if (newAgent.name) cfg.agents.list[idx].name = newAgent.name;
+            if (newAgent.sandbox) cfg.agents.list[idx].sandbox = newAgent.sandbox;
+            if (newAgent.tools) {
+              cfg.agents.list[idx].tools = {
+                ...cfg.agents.list[idx].tools,
+                ...newAgent.tools,
+              };
+            }
           } else {
             cfg.agents.list.push(newAgent);
           }

package/server/generators/routing.js DELETED Viewed

@@ -1,51 +0,0 @@
-/**
- * Generate gateway/openclaw.routing.json5.
- * Pure function — outputs JSON5 string with // TODO comments for missing data.
- */
-export function generateRouting(teamSpec) {
-  const { agents, routing, orchestration } = teamSpec;
-  const defaultAgentId = routing?.defaultAgentId || orchestration?.router_agent || agents[0]?.id;
-  const agentsList = agents.map(a => {
-    const isDefault = a.id === defaultAgentId;
-    const workspace = `~/.openclaw/workspace-${a.id}`;
-    if (isDefault) {
-      return `    { id: "${a.id}", default: true, workspace: "${workspace}" }`;
-    }
-    return `    { id: "${a.id}", workspace: "${workspace}" }`;
-  }).join(',\n');
-  const bindingsList = (routing?.bindings || []).map(b => {
-    const matchParts = Object.entries(b.match)
-      .map(([k, v]) => {
-        if (typeof v === 'object') {
-          return `${k}: ${JSON.stringify(v)}`;
-        }
-        return `${k}: "${v}"`;
-      })
-      .join(', ');
-    return `  { agentId: "${b.agentId}", match: { ${matchParts} } }`;
-  });
-  const bindingsSection = bindingsList.length === 0
-    ? `  // TODO: Add channel bindings\n  // Example: { agentId: "${defaultAgentId}", match: { channel: "discord", accountId: "${defaultAgentId}" } }`
-    : bindingsList.join(',\n');
-  return `{
-  // OpenClaw Gateway Routing Config
-  // Generated by openclaw-agent-builder
-  // Edit as needed — this is JSON5, so comments are supported.
-  agents: {
-    list: [
-${agentsList}
-    ]
-  },
-  // Bindings — sorted by specificity: peer > guildId > teamId > accountId-exact > accountId:* > default
-  bindings: [
-${bindingsSection}
-  ]
-}
-`;
-}

package/server/generators/team.js DELETED Viewed

@@ -1,58 +0,0 @@
-/**
- * Generate team/TEAM.md.
- * Pure function.
- */
-export function generateTeam(teamSpec) {
-  const agentsTable = teamSpec.agents.map(a =>
-    `| ${a.id} | ${a.name} | ${a.mission || '// TODO'} |`
-  ).join('\n');
-  const handoffGraph = (teamSpec.handoffs || []).length > 0
-    ? teamSpec.handoffs.map(h =>
-        `- **${h.from}** → **${h.to}**: ${h.when} (${h.payload_contract})`
-      ).join('\n')
-    : '// TODO: No handoffs defined';
-  const sharedNever = (teamSpec.shared_constraints?.never || []).length > 0
-    ? teamSpec.shared_constraints.never.map(r => `- **NEVER** ${r}`).join('\n')
-    : '// TODO: Define shared constraints';
-  const memoryMode = teamSpec.shared_memory?.mode || 'separate';
-  const memoryLocation = teamSpec.shared_memory?.location || '// TODO';
-  const teamName = teamSpec.team?.name ||
-    (teamSpec.agents.length === 1 ? `${teamSpec.agents[0].name} Workspace` : '// TODO');
-  return `# TEAM.md - Team Charter
-## Team
-**${teamName}**
-${teamSpec.team?.mission || '// TODO: Define team mission'}
-## Agents
-| ID | Name | Mission |
-|----|------|---------|
-${agentsTable}
-## Orchestration
-- **Mode:** ${teamSpec.orchestration?.mode || '// TODO'}
-- **Router Agent:** ${teamSpec.orchestration?.router_agent || '// TODO'}
-## Handoff Graph
-${handoffGraph}
-## Shared Constraints
-${sharedNever}
-## Memory Model
-- **Mode:** ${memoryMode}
-${memoryMode === 'shared_summary' ? `- **Location:** ${memoryLocation}` : '- Each agent maintains their own MEMORY.md'}
-`;
-}