Skip to main content

Deep Dive Chapter 24: Project - Build Your AI Employee

You've learned the pieces. Now build something real.

This is a project. You'll build a working AI Employee for YOUR profession using NanoClaw: the same tool you set up in the "NanoClaw Hands-On Setup" lesson from "Meet Your First AI Employee - OpenClaw". No new installations, no architecture lectures. Just challenges, acceptance criteria, and your professional expertise.

From Mode 1 to Mode 2

Chapters 19 through 23 were problem-solving engagements: you defined intent, the agent executed, you verified. Each engagement shipped an outcome and closed.

Chapter 24 is your first manufacturing engagement. You are not shipping an outcome. You are shipping a worker: a deployed AI Employee that persists, monitors, and acts after the session ends. This shift is governed by a different discipline: the Seven Invariants of the Agent Factory rather than the Seven Principles.

Prerequisites

  • "NanoClaw Hands-On Setup" complete (from "Meet Your First AI Employee - OpenClaw"): NanoClaw installed, running, WhatsApp connected
  • Layer 3 design from "NanoClaw Hands-On Setup": Your blueprint with 3+ Agent Skills and 3+ MCP servers for your profession
  • Part 2 foundations complete: File Processing, Computation and Data Extraction, Structured Data and Persistent Storage, Linux Mastery, and Version Control

Three Achievement Tiers

TierPathTimeWhat You Get
BronzeThe Project Brief through Bronze Capstone: First Real Day~3 hoursWorking AI Employee: identity + skill + connection + proof
SilverThe Project Brief through Prove Professional Value~6 hours+ autonomous monitoring + trust boundaries + persistent memory + domain report
GoldThe Project Brief through Prove Professional Value (Gold track)~9 hours+ multi-group architecture with isolation + memory isolation

Pick the tier that matches your available time and ambition. You can always come back for the next tier later.

Lessons

The Brief

LessonDuration
The Project Brief20 min

Bronze Tier: Working AI Employee

LessonDuration
Give Your Employee an Identity30 min
Teach Your Employee a Skill40 min
Connect Your Employee to the World35 min
Bronze Capstone: First Real Day45 min

Silver Tier: Proactive + Trusted + Learning

LessonDuration
Make Your Employee Proactive40 min
Teach Your Employee Boundaries40 min
Give Your Employee a Memory40 min
Prove Professional Value55 min

Project Review

LessonDuration
Project Review25 min

Student Deliverables (GitHub Repo)

nanoclaw-employee/
├── groups/
│ ├── global/CLAUDE.md (shared rules)
│ └── main/CLAUDE.md (profession-specific identity)
├── .claude/skills/{domain-skill}/
│ └── SKILL.md (from Layer 3 design)
├── conversation-log.md (Bronze: First Real Day)
├── evaluation.md (Bronze: self-assessment)
├── scheduler-config.md (Silver: scheduled task design)
├── hitl-boundaries.md (Silver: permission table)
├── memory-config.md (Silver: action log + knowledge store schemas)
└── domain-report-sample.md (Silver: generated report)

Gold adds: 3-group config + isolation demo + system diagram + memory isolation test.

How This Chapter Teaches

Every lesson in this chapter uses the PRIMM-AI+ learning cycle. Each challenge section contains a dedicated PRIMM-AI+ Practice block with five stages:

  1. Predict [AI-FREE]: Before you touch any configuration or send any message, write down what you expect the employee to do when the challenge is complete. What will it say? What will the log or file show? What edge cases do you anticipate? Assign a confidence score from 1 to 5. Do not ask the agent until those notes are written.
  2. Run: Complete the challenge steps using your AI coding assistant. Each Run block provides parallel instructions for Claude Code and OpenCode.
  3. Investigate: Compare what actually happened to what you predicted. Where they differ, ask the agent to explain why. The gap between prediction and reality is where the learning happens.
  4. Modify: Change one aspect of what you built, predict how the employee's behavior changes, make the modification, and verify the result. Small, deliberate changes reveal how each configuration element does its job.
  5. Make [Mastery Gate]: The acceptance criteria listed in each challenge are your Mastery Gate. Passing means all acceptance criteria are met and logged in your conversation log.

The project format maps naturally to PRIMM-AI+: the challenge gives you the intent, Predict forces you to think before building, Run is the build, Investigate is the comparison, Modify deepens understanding through controlled variation, and Make is the proof.

Design Philosophy

This project doesn't teach NanoClaw: you already know it. Instead, each lesson gives you:

  1. A challenge with clear acceptance criteria
  2. A use case gallery with profession-specific examples
  3. Graduated hints (3 levels) for when you're stuck

Your Layer 3 design from the "NanoClaw Hands-On Setup" lesson in "Meet Your First AI Employee - OpenClaw" is your blueprint. This project is where you execute it.

Seven Principles in Your AI Employee

The principles you learned in Chapter 18 are not background knowledge for this project; they are the engineering decisions that make your AI Employee reliable rather than random.

PrincipleHow It Shows Up in Your AI Employee
P1 Bash is the KeyNanoClaw runs on bash; every MCP tool call, file read, and webhook trigger passes through the terminal layer
P2 Code as Universal InterfaceCLAUDE.md and SKILL.md are the code interface: structured files that define identity, rules, and capabilities precisely
P3 Verification as Core StepAcceptance criteria per lesson are verification checkpoints; the Bronze Capstone proof-of-work conversation log is the final verification
P4 Small Reversible DecompositionBuild incrementally through tiers: identity first, then skill, then connection, then memory; each tier is independently verifiable
P5 Persisting State in FilesCLAUDE.md, skills, conversation logs, and memory schemas all persist agent state in files
P6 Constraints and SafetyTrust boundaries and the HITL permission table define what the employee can do autonomously vs. what requires approval
P7 ObservabilityConversation logs, action logs, and the domain report are the observability layer: proof the employee worked

Seven Invariants Readiness Map

InvariantWhat It RequiresCh 24 CoverageLesson
1: Human is PrincipalHuman sets intent, budget, authority envelopeCLAUDE.md defines the authority envelope and scope of your employeeL1: Give Your Employee an Identity
2: Every Human Needs a DelegatePersonal agent holding context and authorityNanoClaw is your delegate, connected via WhatsAppL3: Connect Your Employee to the World
3: Management LayerHire, assign, govern, retire the workforceNot in scope for Part 2; covered in Part 6
4: Each Worker Picks Its Own EngineRuntime matched to job reliability needsNanoClaw is the engine; engine selection covered in Part 6
5: System of RecordAuthoritative durable store the worker reads from and writes toSQLite gives your employee persistent memory across sessionsL7: Give Your Employee a Memory
6: Expandable WorkforceHiring as a callable capability under policyNot in scope for Part 2; covered in Part 6
7: Nervous SystemExternal triggers, Worker-to-Worker events, durability, flow controlCron scheduling is the proto version; full event substrate covered in Part 6L5: Make Your Employee Proactive

Invariants 3, 4, 6, and 7 are marked partial or out-of-scope here. Part 2 builds your first Worker. Later parts build the factory that produces and governs many Workers.

Failure Taxonomy

When AI Employee build workflows break, name the failure before debugging it:

FailureWhat It Looks LikeWhy It HappensHow to Catch It
Identity DriftEmployee ignores rules you set in CLAUDE.mdInstructions in CLAUDE.md are too vague or contradict each otherTest the identity with a prompt specifically designed to trigger each rule; if it passes, the rule is enforced
Skill MismatchEmployee tries to use a skill but produces wrong outputSkill description does not match what you are asking it to doInvoke the skill explicitly with /skill-name and check if the output matches the SKILL.md spec
MCP Connection LostEmployee cannot reach an external tool mid-conversationMCP server is not running or the connection timed outAsk the employee: "List your available tools." If the MCP tool is missing, restart the server
Memory OverwriteEmployee forgets previous corrections you gave itCorrection was stored in the knowledge table but a newer instruction contradicted itQuery the knowledge table directly: SELECT * FROM knowledge ORDER BY created_at DESC LIMIT 10
Boundary CreepEmployee takes an action you did not authorizeHITL rules are defined but the threshold is too permissiveTighten the trust boundary: lower the auto-approve threshold and test with an action that should require approval