MICHAEL COSTEA / MELBOURNE
MICHAEL COSTEA HEAD OF TECH, AI & SYSTEMS
I turn messy workflows, tools, data, and handoffs into systems people can operate, measure, and trust.
Current work spans AI enablement, business systems, vertical application delivery, automation, technology operations, and human-reviewed agent infrastructure.

Public webapps, games, demos, and internal tools are hidden until they are rebuilt to the MICHAEL OS 89 style guide and ready for public release.
Tools & Resources
Secondary lane: products, templates, guides, and education artifacts. These demonstrate shipping breadth without competing with the career and case-study path.
Current Operating Profile

Name: Michael Costea
Current role: Head of Tech, AI & Systems — All Electric Homes
Location: Melbourne, Victoria, Australia
Direction: Helping people and businesses get practical value from AI through clearer workflows, safer automation, and human-reviewed systems.
What I am building now
A practical AI help and workflow layer that helps individuals, teams, and growing businesses move from scattered AI experiments to useful systems with clear owners, evidence, and review gates.
- More business context visible across teams and systems.
- Less duplicate entry, fragmented handoffs, and manual admin.
- Faster lead response, quote preparation, and conversion flow.
- More consistent customer experience from first touchpoint to job completion.
- Automation that is reviewable, measurable, and safe by design.
Michael Costea
Head of Tech, AI & Systems · AI enablement · vertical AI apps · full-stack systems · agentic automation
Melbourne, Victoria, Australia · costea.michael@gmail.com · LinkedIn · michaelcostea.com
Profile
Vertical AI application delivery: I build vertically integrated applications from discovery and workflow design through UX, frontend, backend/API, data, agentic automation, deployment, observability and operator handover.
I use current agentic harnesses and model stacks—including Hermes Agent, OpenAI Codex and APIs, Anthropic Claude, local LLMs, n8n and Python—and understand local LLM routing strategies that place work by complexity, privacy, latency, cost and failure tolerance.
My career spans Optus-scale process and knowledge operations, electrical field delivery, sales leadership, business development, marketing and hands-on systems ownership. Since mid-2023 I have owned websites, lead flow, customer-journey systems and digital infrastructure across a multi-brand electrical and energy-services group, later formalised in my Head of Tech, AI & Systems role.
Best fit: AI Enablement Lead · Business Systems & Automation Lead · Marketing Technology / Growth Systems Lead
Operating Evidence
Selected Operating Work
Multi-brand business systems & AI enablement
DISCOVERY · DELIVERY · ADOPTION · COMMERCIAL OUTCOMESProblem: websites, lead channels, customer contact, sales activity and admin handoffs had grown across several service brands without one clear operating layer.
System: connected lead capture and routing, CRM and customer-journey workflows, websites, IVR/chatbot improvements, review automation, reporting, and n8n/Python-assisted workflows with human review.
Ownership: requirements, prioritisation, prototypes, vendors/tools, release checks, documentation, staff support and ongoing improvement from mid-2023 onward.
Knowledge and process operations at Optus scale
KNOWLEDGE ARCHITECTURE · PROCESS REDESIGN · TRAINING · CHANGEProblem: large frontline teams faced duplicate processes, knowledge-search friction, inconsistent support and avoidable ticket volume.
System: maintained knowledge bases, redesigned processes and reporting, improved credit-policy workflows, and delivered communications, training and change support.
Proof: 352 stores, 5,000+ employees, 500,000 monthly knowledge visits and a recorded 74% increase in work outputs over 12 months.
Governed agent and workflow infrastructure
ORCHESTRATION · OBSERVABILITY · REVIEW GATES · SAFE AUTONOMYProblem: useful AI work breaks down when tools, context, ownership, failures and approvals are invisible.
System: multi-agent workflows across several environments, with n8n orchestration, hardened Python logic, shared project state, schedules, watchdogs, logs, dashboards, completion receipts and explicit human approval for risky actions.
Operating principle: automate repeatable work, keep judgment with people, fail closed when evidence or permission is missing, and measure the result.
Role-Ready Capabilities






Experience
Business Systems, Lead Flow & Digital Infrastructure — Expanded Scope
Mid-2023 - Present · Want A Sparky / Want A Heat Pump / All Electric Homes

Owned the operating layer connecting websites, lead capture, CRM and lead routing, customer contact, review automation, reporting visibility, internal tooling and AI-enabled workflows across the group.
Chronology note: this functional ownership ran across the formal Electrician, Sales Manager, Business Development & Marketing Manager, and Head of Tech roles below.
Head of Tech, AI & Systems — All Electric Homes
Feb 2026 - Present · Melbourne · On-site

Lead technology, automation, AI and growth systems across a multi-brand electrical and energy-services group. Own digital infrastructure, websites, lead systems, customer-journey tooling, internal tools, workflow architecture and practical AI adoption.
Operating focus: clearer ownership, less duplicate admin, faster handoffs, visible exceptions and systems staff can understand and maintain.
Business Development & Marketing Manager — Want A Heat Pump / Want A Sparky / All Electric Homes
Feb 2024 - Apr 2026 · Australia

Drove B2B and partner relations, revenue activity, acquisition and retention, digital strategy, websites, user-metric analysis, lead pathways, IVR changes, review automation, chatbots, campaigns, partner programs and community education.
Sales Manager — Want A Heat Pump
Nov 2023 - Apr 2026 · Melbourne

Managed authorised-retailer relationships and heat-pump upgrades across residential and commercial sectors under the Victorian Energy Upgrade Program. Owned CRM-driven sales activity, conversion flow, customer relationships and strategic marketing support.
Electrician — Want A Sparky
Apr 2023 - Jun 2024 · Mornington / South East Melbourne

Delivered domestic, commercial and emergency electrical services across Want A Sparky, Want A Charger, Want A Heat Pump and All Electric Homes. Supported the transition toward electrification and lower-carbon energy services.
Electrician — Wired By MJD / Ezzy R Electrics
Feb 2018 - Apr 2023 · Melbourne

Built broad field experience across residential/commercial maintenance, emergency faults, medical installations, custom builds, smart-home and A/V systems, data, security, networking, KNX wiring, C-Bus diagnosis and architectural projects exceeding $4M.
Operations Manager / Owner — Bloom Coffee Bar
Jul 2017 - Feb 2018 · Carlton

Helped establish and operate an owner/operator cafe, building hands-on experience in people management, operations, customer experience and small-business execution.
Optus — Sales Operations Support Manager / Process & Content Manager / Business Process Specialist / Retention Consultant
Aug 2010 - Jun 2017 · Melbourne

Managed retail support across 352 stores, maintained knowledge bases serving 5,000+ employees and 500,000 monthly visits, and led process redesign, credit-policy improvements, training, communications and large-scale change management.
Selected impact: 74% increase in work outputs over 12 months, hundreds of duplicate processes removed or rewritten, fewer support tickets, better knowledge search and redesigned operational reporting.
What I Build

I build the environment that enables the business and the people inside it to become better with AI: shared context, safe agent workflows, dashboards, training loops, and operating habits that turn staff into confident AI users instead of passive tool consumers.







Useful AI Principles
How the first useful loop starts
3 Hiring Cases + Project Archive
Proof first: three role-relevant cases lead. Full project inventory stays available below as a compact archive.
Knowledge and support operations at Optus scale
Problem: duplicated processes, support load, and search friction across a large frontline audience.
System: process redesign, knowledge maintenance, content removal/rewrite, training, communications, and reporting.
Decision: treat documentation quality, ownership, staff adoption, and measurement as one operating loop.
Ownership: operational analysis, process intervention, rollout support, and performance visibility.
Proof: 352 stores · 5,000+ employees · 500,000 monthly knowledge visits · 74% recorded output increase over 12 months.
Open full caseMulti-brand AI and workflow operating layer
Problem: lead flow, customer contact, admin, reporting, and field handoffs spread across brands and tools.
System: websites, lead capture, routing, CRM/customer journey, review automation, internal tools, and bounded AI workflows.
Decision: automate repeatable low-risk work; keep named human approval for money, compliance, quality, and customer commitments.
Ownership: discovery through deployment, observability, governance, documentation, support, and staff handover.
Proof: current role and operating map are inspectable; private commercial metrics are not published.
Open full caseVisible, permissioned agent infrastructure
Problem: agents, models, accounts, and machines create invisible work, auth uncertainty, duplicated context, and permission risk.
System: Hermes, model routing, shared state, schedules, watchdogs, usage tracking, dashboards, and operator receipts.
Decision: route by capability, privacy, latency, and cost; fail closed for public, financial, and destructive actions.
Ownership: architecture, implementation, safety model, acceptance tests, runtime monitoring, and recovery paths.
Proof: public repos, architecture artifacts, live tests, and screenshots; throughput is not presented as a business outcome.
Open full caseProject ArchiveOpen all 12 systems and artifacts
Project Archive

michaelcostea.com / MICHAEL OS 89
The live portfolio operating system itself: a Win95/Nous-zine showcase for AI education, project proof, demos, deck previews, intake, and repo cards, deployed through GitHub Pages.
- Current repo:
five0nit/michaelcostea-com. - Acts as the public hub for the active builds below, with direct routes, mobile polish, screenshots, and proof links.
- Recent focus: make the projects page read like a polished showcase wall rather than a hidden internal index.

RebateSignal
Live guarded Victoria-first quote service for source-backed hot-water VEECs, solar and battery STCs, approved-product evidence, and fail-closed unsupported paths.
- Exact promoted VEU and CEC product evidence gates numeric hot-water VEECs, solar STCs, and battery STCs.
- Unknown, stale, incomplete, and unsupported paths withhold numbers instead of guessing.

InvoicePipe
Invoice automation system with OCR/media smoke tests and a commercial private mirror. The showcase screenshot captures the product surface while repo access stays private.
- Local OCR and document-processing workflow.
- Private commercial repo:
five0nit/invoicepipe.

Brief2Ship
Public operating standard for turning rough AI requests into better first-pass builds, reports, and handoffs: one strong brief, the right existing base, a maintainability gate, anti-slop finish, and proof receipts.
- Includes the Brief2Ship skill, templates, workflow docs, report/document lane, examples, and receipt shape.
- Designed for apps, dashboards, landing pages, client docs, QA reports, audits, and handoffs where “done” needs evidence.
- Repo:
five0nit/brief2ship.

Automated Social & Brand Content Engine
End-to-end research-to-publish operating system for personal-brand and channel content: monitors AI and repository signals, creates draft calendars, packages LinkedIn activity and short-form video, and feeds performance results back into planning.
- Unifies own-post queues, engagement comments and reposts, channel-specific media packages, publishing handoffs, experiment calendars, and seven-day pulse checks.
- Supports LinkedIn, YouTube Shorts, TikTok, Snapchat, Instagram, and Patreon lanes without silent autopublishing.
- Style, safety, metadata, QA, approval, and proof gates remain visible through Telegram receipts and performance ledgers.

UseAIForMe.com
Early-access AI operator marketplace and consultancy surface: buyers post a real outcome, operators show proof and pricing, and paid work starts only after scope, fit, and approval are confirmed.
- Manual matching, verified operator profiles, fixed-scope packages.
- Stripe-backed checkout path with human review.
- Private product repository; public case evidence stays on the live site and screenshot.

Telegram Office / Agent Office
Pixel office for visible multi-agent work: Telegram-triggered events, bot rosters, rooms, handoffs, activity zones, and browser-first operator visibility.
- Canonical public repo:
five0nit/telegram-office. - Live runtime withheld while its public endpoint is unhealthy.

Agentic Framework Session
Education and enablement deck explaining Hermes, safe agent setup, shared memory, Discord/team rooms, review gates, and how businesses can use agents without silent risk.
- Live deck preview is built into this portfolio.
- Supports client-facing AI education and onboarding.

AI Profile Sites
n8n/Hermes profile-site generator that turns structured person/company inputs, evidence, screenshots, and source receipts into polished profile pages for clients, founders, and operators.
- Generates desktop/mobile previews and source-receipt artifacts.
- Public repo:
five0nit/ai-profile-sites. - Useful as a client-facing “AI website from real context” demo.

AgentMesh / Multi-Agent Control Kit
Local-first coordination package for teams of AI agents: shared mailboxes, relay demos, handoffs, visible receipts, bootstrap docs, security notes, and public-alpha packaging.
- Built to make overnight/local agents visible instead of silent.
- Includes architecture, bootstrap flow, install docs, examples, and release notes.
- Local package path:
automation/multi-agent-control-kit.

Codex Account Usage + Auth Rotator
Private operator tool for tracking Codex account usage, reset windows, active account status, warmup, switching, and auth rotation across a pool without guessing which login is safe to use.
- Shows 5h/7d usage, reset timers, account status, and active selection.
- Private secure mirror:
five0nit/codex-switch-secure. - Built for account-pool reliability and safer local AI operator workflows.
Repo-First Starter + Cursor Covenant
Two small public operator-safety repos: one pushes AI builders to discover the best existing base before greenfield work; the other adds a visible cursor-control countdown and hard UI-control rule.
five0nit/repo-first-starterfor base selection and entropy gate.five0nit/cursor-covenantfor visible mouse/keyboard control discipline.
Additional operating themes
1. AEH AI Operating Layer

Strategic AI and workflow layer across sales, operations, finance, admin, reporting, customer experience, lead flow, and job completion.
- Maps core workflows and handoffs.
- Defines automation boundaries, approval gates, and escalation rules.
- Turns fragmented work into measurable operating loops.
2. Agent Infrastructure & Shared Context

Personal and business agent stack using OpenClaw, Hermes, Telegram, dashboards, scheduled jobs, watchdogs, memory, and shared context across devices.
- Visible task receipts instead of silent automation.
- Shared memory/state so agents do not restart from zero.
- Phone-first command path with reviewable outputs.
3. Customer Journey & Revenue Automation

AI-assisted customer and lead workflows: fast response, qualification, quote preparation, follow-up, stale-lead detection, review loops, and handoff summaries.
- Lead intake → CRM context → next best action.
- Quote/admin prep with missing-info flags.
- Human approval before customer-impacting sends.
4. Data Visibility & Exception Radar

Dashboard and reporting patterns that turn scattered operational data into clear action lists: overdue work, missing payments, stale leads, customer risks, and review gaps.
- Exception-first reporting, not vanity dashboards.
- Evidence links and audit trails for decisions.
- Cleaner data capture at workflow source.
New Repo: Brief2Ship
One brief. Better build. Proof included.
Brief2Ship is a lightweight operating standard for AI-assisted builds and reports: start from one strong brief, choose the best base, keep the code or document maintainable, polish the UX or formatting, and prove it works.
Most AI build loops create a polished mystery box. Brief2Ship forces the useful discipline between a prompt and a shippable first pass: repo-first selection, maintainability gate, anti-slop finish, report/document formatting, and proof receipts.
The user gives one strong brief. The agent asks up to five follow-up questions only if they materially change the build.
less babysitting · clearer startThe workflow checks for an existing base before greenfield, rejects brittle code, and finishes the UX instead of shipping generic AI slop.
better judgment · better first passEvery build or report ends with changed files, sources used, commands/checks run, verification output, screenshots/logs, and known compromises.
trust through evidenceBuild me a [thing] for [user] that does [main job]. It should feel like [reference]. Constraints: [platform, polish level, auth/integrations, proof required].
Brief2Ship: what the repo does and why it helps
Brief2Ship helps turn a rough AI build request into better first-pass AI builds with proof instead of vibes.
The repo packages a small operating standard for AI-assisted product work. It is not a giant framework and it does not force a stack. It gives an agent or operator a repeatable path from brief → base choice → maintainable build or report → polished UX/formatting → proof receipts.
It gives builders a reusable way to run AI builds and decision-ready reports: start from a one-shot prompt, ask no more than five useful follow-up questions, choose the best existing base or source set, then ship a verified artifact.
one-shot prompt · repo-first/source-first selection · verified outputMost AI coding loops look productive but hide risk: too many clarification loops, random greenfield code, generic UI, weak tests, and no evidence. Brief2Ship makes the agent prove the work before calling it done.
less rework · fewer mystery boxes · more trustThe public repo includes the Brief2Ship skill, workflow docs, four lane examples, build/report kickoff templates, receipt templates, and an install script for loading the standard into Hermes/OpenClaw-style agent workflows.
skill · docs · report templates · examplesThe operating loop
- 1. Brief: capture the thing to build, user, main job, references, constraints, and proof requirements.
- 2. Base: run repo-first base selection so the agent does not default to unnecessary greenfield code.
- 3. Build: pass the maintainability gate: clear naming, visible logic, justified dependencies, and debuggable seams.
- 4. Finish: apply the anti-slop UI finish for apps, and reader-first structure and formatting for reports.
- 5. Prove: return proof receipts: files changed, sources used, commands/checks run, tests, screenshots/logs, and known compromises.
You want an app prototype, dashboard, internal tool, landing page, product page, agent workflow, executive summary, QA report, audit, handoff, or research report to move quickly without losing judgment.
apps · dashboards · landing pages · reports · workflow buildsVague prompts, brittle generated code, unsupported claims, weak source handling, dependency bloat, generic AI slop, and “done” claims that lack receipts.
bad first passes · hidden risk · fake doneIt shows the kind of AI operating layer Michael builds: practical, visible, human-reviewed, and designed around useful outcomes rather than hype.
useful AI · evidence · human reviewchosen base/source set + why · changed files/report artifact · sources used · commands/checks run · preview/screenshot/proof · known compromises
Brief2Ship now covers executive summaries, QA reports, audits, handoffs, research reports, Markdown/PDF/client docs, and decision briefs.
reports · audits · handoffs · decision docsReader and decision are clear, sources are listed, evidence is separated from assumptions/opinion, recommendations are concrete, formatting is skimmable, and the final artifact is rendered or checked.
reader-first · source-first · format-checkedRebateSignal
A Victoria-first rebate intelligence API for VEU / VEEC, STC, and Solar Victoria payout ranges.
This project turns messy rebate calculators, certificate price feeds, decommissioning rules, approved-product checks, and state/federal scheme conditions into one line-item quote response that installers and marketplaces can test before a job is submitted.
The latest Firebase calculator and API are deployed with
public_quote_ready=true. The promoted catalog contains 42,012 source-backed approved products. Exact VEU product, postcode, existing-fuel, and decommissioning evidence now resolve source-backed hot-water VEECs; exact CEC evidence gates solar and battery STCs. Activity 6 VEECs, hot-water STCs, and unverified Solar Victoria customer amounts remain withheld.Shape the production POST /api/v1/quotes response: eligibility, line-item scheme estimates, payout low/high, blockers, warnings, evidence checklist, and source versions.
House the VEC/VEEC calculator resources, VEU activity requirements, STC calculator resources, approved-product logic, and effective-date versions in reviewable rules.
calculator parity · versioned rulesKeep certificate prices and trader payout amounts separate from eligibility logic, with provider, timestamp, and confidence so old quotes remain auditable.
VEEC price · STC price · trader termsFirst activity pack
- 1. Heat pump hot water: model replacement/decommissioning inputs, approved product status, activity date, postcode, and required evidence.
- 2. VEU / VEEC: return guarded source-backed metadata and withhold numeric certificate counts until exact official calculator/evidence parity is present.
- 3. STC: calculate the federal certificate line item separately so the API can show stacked value without hiding assumptions.
- 4. Solar Victoria: add grant/rebate/loan eligibility as a separate program line where relevant, not as certificate value.
eligible · scheme line items · approved product catalog · source evidence · blockers · warnings · evidence_required · source_versions · confidence: guarded/indicative/verified
AI Agents & Workflow Automation

Ethos: build AI agents the way you would build a serious operating system for your life or business: visible, measured, permissioned, reviewable, and useful every day. The win is not replacing people with a chatbot. The win is removing repetitive drag, keeping context alive, catching exceptions early, and giving humans more leverage.
Most stock agent installs are impressive demos but weak operating layers. They can answer, code, and use tools, but they often lack durable memory, shared visibility, scheduled follow-up, Telegram accountability, watchdogs, dashboards, and a review loop. Our current stack is designed to close that gap.




Concerns and pitfalls to respect
- Silent failure: agents can look busy while missing the real business outcome. Track inputs, outputs, receipts, and verification.
- Tool overreach: never let an agent delete, spend, message customers, or change systems without explicit permission and rollback paths.
- Context rot: long chats drift. Use memory deliberately, compact sessions, and keep source-of-truth docs clean.
- Model cost and rate limits: long tool loops burn tokens. Monitor usage and pick the cheapest model that can reason well enough for the job.
- Browser automation fragility: APIs first, browser automation second, desktop/manual fallback last.
- Trust gap: if a human cannot see what happened, why it happened, and what changed, the workflow is not production-ready.
Why this can become a cheat code
When agents are tracked and monitored properly, they become a compounding leverage system: they remember decisions, chase loose ends, prepare work, run checks, produce evidence, and keep pushing while you sleep or focus elsewhere. That is the real cheat code — not one magic prompt, but a monitored agent stack that keeps life and business workflows moving.
Build principles
- Start with one painful repeatable workflow, not a vague “automate everything” goal.
- Give the agent bounded tools, test data, and a clear success definition.
- Make every workflow observable: logs, Telegram updates, dashboard state, and final receipts.
- Keep humans on judgment, customer trust, finance, safety, legal, quality, and edge cases.
- Scale only after the workflow proves it saves time without creating hidden risk.
AI Help: Everyday Starter Guides

This is the starting point for people who want to get more out of AI without drowning in jargon, hype, or unsafe shortcuts. Start with one useful workflow, learn the limits, then build confidence safely.
Start useful: pick one repeated task, test with harmless data, and keep humans approving anything risky.
Agentic Framework Session
A MichaelOS × Nous-zine presentation explaining Hermes, safe agent setup, shared memory, client rollout, monitoring, and Discord server comms for teams.

Agentic Workflow Knowledgebase
A practical map for moving from "I use ChatGPT sometimes" to safe, repeatable AI workflows with clear inputs, tools, approvals, evidence, and escalation rules.

what agents do
copy/paste tutorials
one agent
safely
Plain English version: an AI agent is a helper that can use tools. It can read, write, search, run commands, and remember context — but it still needs clear instructions and human review.
Agentic Workflow Knowledgebase
Best-in-class AI adoption starts with boring clarity: the job, the source of truth, the tool boundary, the approval gate, the evidence trail, and the next action.
From prompt to operating layer
This knowledgebase helps users choose the right first workflow, understand agent parts, avoid unsafe shortcuts, and turn useful prompts into repeatable agentic systems.

Command bank: copy/paste agent instructions
Dropdown copy/paste commands: open the pattern you need, copy the block, then paste it into your agent before it starts work. These are the strongest operating modifications and rules from the live agent stack: memory first, WSL-first local work where it fits, end-to-end verification, handoff receipts, and safety gates.
High-autonomy operator upgradeMake the agent finish the job, not just suggest steps.
You are my high-autonomy AI operator. Default behavior: - Inspect the current state before acting. - Make a short plan, then do the work end-to-end. - Use tools when they improve accuracy. - Verify the result with real checks, not guesses. - Do not stop at a stub, outline, or "next steps" if you can safely complete it now. - Do the work end-to-end, then report done, verified, pending, blocked. Before risky actions, ask first. Risky means: public posting, sending messages, deleting files, spending money, changing customer records, rotating secrets, or touching production systems.
Install the memory layer habitStop the agent forgetting identity, preferences, decisions, and project state.
Before meaningful work, load memory in this order: 1. Startup identity: who you are, operating style, and safety rules. 2. User preferences: tone, approval rules, tools, and recurring constraints. 3. Project memory: current state, known pitfalls, decisions, and open blockers. 4. Shared-agent memory: recent handoffs, receipts, and changes from other agents. 5. Human notes: Obsidian/local notes that explain the why behind the work. After meaningful work, write a durable receipt: - what changed - files/settings touched - commands/checks run - verified result - blockers or risks - next action Use Agent-to-agent memory for machine handoffs and a Human memory layer for readable notes.
WSL-first local setupPreferred Windows path for serious local agent work.
For Windows development, prefer WSL Ubuntu unless the tool specifically requires native Windows. Rules: - Keep repos in the Linux home directory, not inside OneDrive or random Desktop folders. - Install basics first: curl, git, python3, python3-venv, python3-pip, Node LTS if the workflow needs it. - Run agent commands from the project folder inside WSL. - Treat /mnt/c paths as Windows interop paths, useful for reading files but slower for heavy repo work. - Verify with version checks before installing extra packages. Starter commands: wsl --install -d Ubuntu sudo apt update sudo apt install -y curl git python3 python3-venv python3-pip node --version python3 --version
Shared-agent handoff receiptMake multi-agent work visible instead of chaotic.
When multiple agents touch the same project, use this handoff format: Project: Goal: Current status: done / in progress / blocked Files changed: Commands/checks run: Decisions made: Open risks: What the next agent should do: What the next agent should not touch: Rules: - Read recent handoffs before editing. - Do not overwrite another agent's unstaged work. - Verify the live/current state instead of trusting old notes. - Keep public-facing or destructive actions behind human approval.
Safe workflow builderTurn one repeated task into a supervised agent workflow.
Build one supervised workflow for this repeated task: Task: Business goal: Trigger: Approved source of truth: Allowed tools: Forbidden actions: Output format: Human approval required before: Evidence to save: Escalate when: Success metric: Rollback plan: Start with a dry run on harmless data. If it works three times manually, convert only the boring proven parts into a monitored workflow.
Customer journey exception radarFind missed follow-ups without letting AI make promises.
Review the customer journey and produce an exception report. Look for: - new enquiries without reply - quotes waiting too long - stale follow-ups - overdue jobs or handovers - invoices/payment reminders needing review - review requests not sent - upset or high-risk customer language Return: 1. ranked issues 2. evidence/source for each issue 3. suggested next action 4. owner 5. draft message only if useful 6. items requiring human approval Do not send messages, change records, promise pricing/timing, or publish anything.
Best modifications to add to any agent
Rules and guidelines that stop agents going sideways
- Use the source of truth: if current facts matter, check the live system, docs, file, repo, calendar, or dashboard.
- Prefer narrow scopes: one workflow, one safe folder, one owner, one approval gate, one success metric.
- Keep secrets out: Never put secrets in memory, prompts, receipts, screenshots, or logs.
- Fail closed: if data is missing, facts conflict, confidence is low, or the action affects trust/money/safety, stop and escalate.
- Verify before claiming done: run the check, open the page, read the output, or produce the artifact.
- Make memory useful: save durable preferences and procedures, not stale one-off task progress.
1. Agentic workflow maturity ladder
2. Anatomy of a safe agentic workflow







3. Workflow recipe library
4. Safety gates before anything goes live
| Risk area | Agent can do | Human must approve |
|---|---|---|
| Customers | Draft replies, summarise history, suggest next action. | Sending, promises, apologies, pricing, refunds, sensitive issues. |
| Money | Prepare calculations, flag anomalies, draft payment reminders. | Spending, refunds, invoice changes, payroll, bank actions. |
| Files and systems | Read approved folders, create drafts, propose changes. | Deleting, moving bulk files, changing live records, broad access. |
| Public channels | Draft posts, check tone, prepare assets. | Publishing, replying publicly, claims, guarantees, legal or safety advice. |
5. Copy/paste workflow blueprint
Workflow name: Business goal: Trigger: Input source: Allowed tools: Output format: Approval required before: - sending customer messages - changing records - spending money - deleting files - publishing publicly Evidence to save: - source used - output created - checks completed - human approval - final action taken Escalate when: - facts conflict - data is missing - customer is upset - confidence is low - action is risky
6. Glossary for getting started
7. Readiness score
Green light: one owner, one clear trigger, one safe data source, one output format, one approval gate, one success metric.
Yellow light: unclear source of truth, too many systems, sensitive customer data, no rollback, or no person responsible.
Red light: "automate everything", broad account access, no approval gate, public/customer actions, money movement, or no way to prove what happened.
Best first move: choose one Level 1 reusable prompt, run it manually three times, then convert only the boring proven parts into a supervised workflow.
Agentic Framework Session: Hermes + Discord-ready team comms
New MichaelOS × Nous-zine resource for explaining how agentic systems work in plain English: Hermes profiles, safe tool boundaries, shared memory, client rollout, monitoring, and why a Discord server unlocks better multi-person visibility.
Use this when: someone needs to understand agentic workflows as a real operating layer, not a magic chatbot. The Discord section shows how shared server channels let multiple people openly engage the same agents with visible approvals and receipts.
Intro to AI: slide preview
Preview the public AI Help starter deck inside the website. Use the arrows to move through the slides, or download the PDF for easy sharing.
Tip: keep this as a safe starter guide: learn the basics, test one boring repeat task, and keep human review on anything that affects real people.
What is an AI Agent?
Short answer: an AI agent is an AI assistant that can use tools to get work done, not just answer questions.
a goal
steps
tools
result
Normal chatbot vs AI agent
- Answers questions.
- Mostly text in / text out.
- You do the clicking, copying, saving, and checking.
- Can break a goal into steps.
- Can use tools like files, browser, terminal, search, memory, and calendars.
- Can keep working until a task is complete, then show evidence.
What can an AI agent do?






Real workflow examples






The power is the chain: read context → update systems → communicate → schedule next action → monitor for reply → escalate to a human when judgment or trust matters.
What it should not do without you
- Spend money, delete files, send public messages, or change business systems without approval.
- Make legal, medical, financial, safety, or employment decisions on its own.
- Replace human judgment where customer trust, risk, quality, or approvals matter.
First proven prompt to try
I am new to AI agents. Explain what you can do in 5 bullet points, then ask me one simple question so we can try a safe first task.
Your First Safe AI Workflow
A beginner tutorial for turning one annoying repeat task into a reusable AI playbook.

Goal: do one useful workflow in about 30 minutes without giving the AI dangerous access. You will pick a low-risk task, give it examples, check the answer, then save the final prompt so you can reuse it.
Step 1 — choose a boring, safe task

Step 2 — use this starter prompt
You are helping me build one safe repeatable workflow. Task: [describe the boring task] Input: [paste notes, transcript, email draft, or requirements] Output format: [checklist / email draft / table / SOP] Rules: - Ask questions only if something critical is missing. - Do not invent facts. - Mark uncertain items as [check]. - Do not send, delete, buy, publish, or change systems. - Give me a short final review checklist.
Step 3 — review like an operator, not a spectator

Step 4 — turn the good version into a reusable playbook
Once the result is useful, save the prompt plus the expected output format. That is your first workflow, not just one lucky chat.
Workflow name: [Example: Weekly meeting notes to action list] When to use it: [Every Friday after team meeting] Inputs needed: [Transcript, decisions, open questions] Output wanted: [Owner / task / due date / risk / next action] Human approval required before: [sending to team, updating CRM, promising dates] Final prompt: [paste the cleaned prompt here]
Step 5 — add the smallest automation later

First workflow ideas
- Inbox triage: paste 10 emails → get urgency, owner, next action, and draft replies.
- Quote prep: paste job notes → get missing info, risks, and a customer-friendly summary.
- Meeting cleanup: paste transcript → get decisions, tasks, blockers, and follow-up message.
- Research brief: paste links/notes → get pros, cons, unknowns, and recommendation.
Rule of thumb: if you would trust a careful junior assistant to draft it but still want to review before sending, it is a good first AI workflow.
How to Hire AI Help Safely
A practical buyer guide for when you want results done for you, not another chatbot tab to babysit.
Short version: good AI help still needs a human operator, a clear brief, visible scope, approval rules, and proof. If someone promises “fully autonomous magic” before they understand the job, slow down.

When done-for-you AI makes sense
What a solid AI service should show you
Questions to ask before you pay
| Ask this | Why it matters |
|---|---|
| What exactly will I receive? | Stops vague deliverables and “strategy” fluff. |
| What do you need from me to start? | Shows whether the operator knows the real dependencies. |
| Which parts are AI-generated vs human-reviewed? | Helps you judge risk, quality, and how much checking you still need to do. |
| What happens if the first version misses? | Clarifies revision flow instead of surprise conflict later. |
| Will this touch customer data, payments, or live systems? | If yes, the workflow needs explicit approvals and safer rollout steps. |
Red flags
- No one can explain the workflow in plain English.
- The seller jumps straight to “full automation” without asking about your current process.
- They want broad account access before agreeing scope.
- They cannot show sample outputs, checkpoints, or a revision plan.
- They promise zero mistakes, zero review, or “set and forget” on risky tasks.
Simple buyer brief template
Task: I need help with [one workflow or deliverable]. Outcome I want: [what success looks like in plain English] Inputs I can provide: [notes, screenshots, links, files, examples] What must not happen: - no public posting - no customer sends - no deleting data - no spending money Approval rule: Draft first. Wait for my review before anything goes live.
UseAIForMe-style rule of thumb: fixed packages can be priced fast, but custom AI work is healthier when the platform confirms scope, operator fit, and review gates before charging like it is a commodity.
Chatbot or Operator?
Use a chatbot when you need ideas or drafts. Use an operator when you need an actual outcome finished.
Simple rule: if the task touches tools, files, formatting, handoffs, website edits, research cleanup, or review loops, you usually want a human operator using AI, not just a chatbot tab.
Fast decision table
| If you need... | Best first move | Why |
|---|---|---|
| Ideas, wording, rough planning, or a first draft | Use a chatbot | Fast, cheap, and good for low-risk thinking work. |
| A landing page, web app, workflow, spreadsheet cleanup, or finished deliverable | Use an operator | Someone still has to check quality, connect tools, and own the output. |
| A messy task but you do not know who should do it | Use a matching marketplace | You need help scoping, fitting the operator, and keeping payment gated until the job is clear. |
| Anything touching customers, payments, or private systems | Use human-reviewed delivery | Trust, safety, and approval checkpoints matter more than speed. |
What a done-for-you AI operator actually does
Good tasks for a marketplace like UseAIForMe
Bad expectations to avoid
- “AI will run my whole business with no human involved.”
- “Custom work should be one-click checkout before scope is reviewed.”
- “I can paste passwords or API keys into a public job card.”
- “If the tool sounds smart, the finished output must be right.”
Best way to brief the work
Task: I need this outcome finished: Success looks like: Useful links / examples: Budget range: Deadline: Rules: - no public posting - no spending money - no customer sends - no secrets in chat - draft / scope first
Why this matters: the gap between “AI can answer” and “AI can deliver” is where most people lose time. A marketplace flow works best when it protects scope, shows operator proof, and keeps money gated until both sides agree on the real job.
Practical AI Tutorials That Actually Help
Five real beginner workflows with a useful input, a better prompt, a quality bar, and the next automation step.
How to use this page: do not just paste a magic prompt and hope. Pick one workflow, use the sample structure, run it on harmless data, then judge the output against the quality bar. If it passes three times, turn it into a repeatable agent task later.

Tutorial 1 — turn messy notes into an action plan
Use when: you have meeting notes, voice-dump notes, job notes, or a messy brain dump and need a usable plan.
Act as an operations assistant. Turn the notes below into an action plan I can use today. Output exactly this structure: 1. One-sentence summary 2. Decisions already made 3. Action table: task | owner | due date | dependency | risk 4. Missing information I must confirm 5. Two-minute message I can send to the team Rules: - Do not invent owners, dates, prices, or promises. - If the notes do not say something, write [check]. - Put urgent/customer-impacting items first. Notes: [paste notes]
Quality bar: a busy person should know what to do next without reading the original notes.
Tutorial 2 — build a customer-safe email from rough context
Use when: you need a reply that is clear, honest, and not full of AI fluff.
Write a customer-safe email draft from this context. Context: [paste situation, customer question, facts, constraints] Output: - Subject line - Email draft - Internal notes: what I should verify before sending Style: - Plain English, Australian tone, no corporate waffle. - Be helpful but do not overpromise. - If we need to check something, say we will confirm it instead of pretending. - Do not mention AI.
Quality bar: you should only need light editing, not a full rewrite. Check names, dates, prices, and promises before sending.
Tutorial 3 — make a decision brief, not a vague comparison
Use when: you are comparing tools, suppliers, software, quotes, workflows, or strategy options.
Create a decision brief from the options below. Decision to make: [what are we choosing?] Options: [paste options, notes, links, prices, concerns] Output exactly: 1. Recommendation in one sentence 2. Comparison table: option | cost/effort | upside | downside | hidden risk | best fit 3. What I would choose if speed matters 4. What I would choose if quality/risk matters 5. Questions to answer before committing Rules: - Separate facts from assumptions. - Mark anything not proven as [check]. - Do not choose the fanciest option by default.
Quality bar: the answer should help someone make a decision, not just describe the options.
Tutorial 4 — turn one repeat task into an SOP
Use when: a task keeps living in someone’s head and needs to become teachable.
Turn this repeat task into a simple SOP. Task: [paste what happens now] Output: - Purpose: why this task exists - Trigger: when to do it - Inputs needed - Step-by-step process - Quality check before calling it done - Common mistakes - Escalate to a human when... - Simple checklist version Rules: - Write for a new person on their first week. - Keep steps concrete. - Do not add software/tools unless I named them.
Quality bar: someone else could follow it without asking you five basic questions.
Tutorial 5 — create a weekly exception report
Use when: you need a manager/operator view of what needs attention, not a vanity summary.
Create a weekly exception report from this raw update. Raw update: [paste notes, numbers, job list, CRM export, inbox notes] Output: 1. Executive summary: 5 bullets max 2. Red flags: what needs action now 3. Stale items: leads/jobs/tasks waiting too long 4. Numbers that changed 5. Decisions needed from me 6. Next actions ranked by impact 7. Follow-up message drafts if useful Rules: - Surface bad news clearly. - Rank by customer impact, revenue impact, and operational risk. - Mark uncertain numbers as [check].
Quality bar: the report should make the next action obvious within 30 seconds.
Turn a good tutorial into an agent workflow
Build a memory layer for your agent
Don’t forget who you are. The agent becomes useful when it can load identity, project state, decisions, receipts, and human notes before it acts.

Why memory matters
Memory is not a nice-to-have for agents: it is the difference between a helper that restarts from zero every chat and an operating layer that keeps identity, decisions, preferences, project state, sources, and lessons in context.
Good memory improves accuracy because the agent can ground answers in what has already been decided, avoid repeating mistakes, preserve user preferences, and know when a current request conflicts with past context. Bad or missing memory creates confident but stale answers.
Why install Byterover and Obsidian?
The simple architecture
Copy/paste prompt 1 — give your agent memory rules
Use this when setting up a local agent. Replace the bracketed names and folder paths, then paste it into your agent’s system instructions, project instructions, or first message.
You are my long-running local AI operator, not a one-off chatbot. Your job is to help me get real work done while preserving context between sessions. Act with high autonomy on safe local work, but stop and ask before public posts, customer messages, spending money, deleting data, changing production systems, or exposing secrets. Before meaningful work, load memory in this order: 1. Identity file: who you are, who you help, communication style, safety rules. 2. User preferences: tone, timezone, tools, approval rules, recurring dislikes. 3. Current project state: active goals, blockers, last verified result, next action. 4. Shared agent memory: recent receipts from other agents, handoffs, decisions, and warnings. 5. Human notes: Obsidian/local notes that explain the why, not just the latest task. Mimic this setup: - Startup identity: a short durable file like SOUL.md or AGENT.md. - User/profile memory: a compact file for stable preferences only. - Project receipts: append-only status/change/test/blocker notes per project. - Byterover-style agent-to-agent memory layer: compact shared context so agents can see each other’s work. - Obsidian local human layer: readable notes and dashboards the human can inspect and edit. - Source links: when possible, cite the file, note, URL, or command output used. Operating rules: - Do not rely on memory alone for current facts. Check live files, git state, docs, or the web when accuracy matters. - If memory conflicts with the current user request, follow the current request and record the updated decision. - Keep memory small. Save durable preferences, project conventions, decisions, and reusable lessons. Do not save stale task noise. - Prefer evidence over vibes. Run checks, read files, verify outputs, then report what actually happened. - Never paste secrets into memory, logs, public docs, or chat. After meaningful work, write a short durable receipt with: - Project: - Done: - Files changed: - Commands/checks run: - Verified result: - Blocked/pending: - Next suggested action: When you answer me, be brief and clear. Separate DONE, VERIFIED, PENDING, and BLOCKED. If you are missing access or context, say exactly what is missing.
Copy/paste prompt 2 — ask the agent to set up the memory files
Set up a local memory layer for this workspace. Create or update these files/folders if they do not exist: - AGENT.md: who you are, what you help with, communication style, approval rules, and hard safety limits. - memory/USER.md: durable user preferences only. Keep it short. Do not save temporary task progress. - memory/PROJECT_STATE.md: active goals, known blockers, last verified result, and next action. - memory/receipts/YYYY-MM-DD.md: append-only work receipts after meaningful tasks. - obsidian/ or notes/: human-readable project notes, decisions, diagrams, and links. Before each task, read AGENT.md, memory/USER.md, memory/PROJECT_STATE.md, and the latest receipts. After each meaningful task, append a receipt with done, files changed, commands run, verification, blockers, and next action. If Byterover or a shared memory tool is available, connect it as the compact agent-to-agent memory layer. If not, mimic it with append-only markdown/jsonl receipts that every agent can read.
Copy/paste prompt 3 — ask the agent to prepare Obsidian notes
Create an Obsidian-friendly project vault for me. Make these notes: - 00 Home.md: links to the active projects, current priorities, and latest receipts. - Projects/[project-name].md: goal, owner, source links, current status, decisions, open questions, and next action. - Decisions.md: date, decision, reason, source/evidence, and what would make us revisit it. - Agent Receipts.md: short summaries of verified agent work with links to files or commands. - Prompt Library.md: reusable prompts that actually worked, with when to use them and failure warnings. Use simple Markdown and wiki links. Keep it readable for a human, not just optimized for an AI. Do not store secrets. When you finish, tell me exactly where the vault is and what notes you created.
Quality check
- The agent should know who it is, what it is allowed to do, and what it must never do without approval.
- The next agent should be able to read the latest receipt and continue without asking the human to repeat the whole story.
- The human should be able to open Obsidian/local notes and understand what the agents believe is true.
- The memory layer should improve accuracy, not become a junk drawer of stale guesses.
Prerequisites Before You Install an AI Agent
The guide before the guide: get the boring local tools right before blaming Hermes, OpenClaw, or the model.

Plain English rule: prerequisites are not busywork. They decide whether the installer can download files, compile small dependencies, find Python, run Node tools, and write config safely. If the base machine is wrong, agent context and accuracy suffer because the agent wastes time guessing around broken tools instead of doing the actual job.
Dependency prerequisites by platform
Use this as the pre-flight check before the install guide. Finish the row for your computer, then move to Guide 4.
| Computer | Install or verify first | Check commands | Beginner note |
|---|---|---|---|
| macOS | Xcode Command Line Tools, Homebrew, Git, Terminal restart. | xcode-select --installgit --versionbrew --version | Install Xcode tools and Homebrew before CLI installs. If brew is missing, use brew.sh, then reopen Terminal. |
| Windows native | Windows admin access, PowerShell, execution/network permission. Hermes Desktop/PowerShell installer does not require beginners to manually install Node or Python first unless hermes doctor says so. | powershellhermes --versionhermes doctorpython --version | Start native first. Do not mix native Windows and WSL halfway through one install. If later tools ask for Python, use the official Python 3 installer or Windows Store Python and rerun hermes doctor. |
| Windows WSL Ubuntu | WSL Ubuntu, sudo apt, Curl, Git, Python basics for Linux tooling: python3 python3-venv python3-pip. Node.js 24 LTS only if you choose OpenClaw or Node-based tools. | wsl --install -d Ubuntusudo apt updatesudo apt install -y curl git python3 python3-venv python3-pippython3 --version | Keep first work under ~/ai-agent-test, not /mnt/c/Users/.../Documents. |
| Linux / Ubuntu | Curl, Git, Python basics: python3 python3-venv python3-pip. Node.js 24 LTS only for OpenClaw/manual Node workflows. | sudo apt install -y curl git python3 python3-venv python3-pippython3 --versionnode --version | If node --version fails, that is fine for basic Hermes; install Node before OpenClaw or Node tools. |
| OpenClaw any OS | Node.js 24 LTS preferred; Node 22.19+ minimum for npm/manual fallback. Provider API key/login. | node --versionnpm --version | OpenClaw is Node-based, so Node is a real prerequisite there. |
Do not skip the safe folder
~/ai-agent-test, C:\AI Agent Test, or a small Desktop folder with one test note. Do not point a new agent at all Documents, customer files, money, or live systems.Next: open only after this prerequisite check is done.
Install Your First AI Agent
A simplified native-local install path: choose one agent, one computer, one private test.

Simple install rule: start with the normal local installer for your computer — not Docker. Install the app/CLI, complete the guided setup, get one local reply, then add Telegram. Do not connect real business systems on day one. If a step fails, stop there — do not stack random fixes.
Official docs to check if anything changes: Hermes installation, Hermes quickstart, OpenClaw getting started, and OpenClaw install.
Hermes beginner map
Follow this order: Install → reload shell → version check → setup/provider → local chat → doctor/status → optional Telegram. If one stage fails, fix that exact stage before adding the next feature.
hermes setup or hermes model. The model/provider is the AI brain; Hermes is the operator shell around it.hermes doctor pass, run hermes gateway setup for Telegram/Discord/Slack.Where Hermes stores things
These locations make the install less mysterious. Do not edit secrets in a public doc or paste them into chat.
~/.hermes/config.yamlMain settings: model/provider choice, toolsets, gateway, memory, terminal, display, approvals.~/.hermes/.envPrivate API keys and tokens. Treat it like a password file. Do not screenshot or share it.~/.hermes/sessions / ~/.hermes/state.dbSession history and searchable past conversations.~/.hermes/skillsReusable procedures Hermes can load later so it does not relearn the same workflow every session.~/.hermes/logsGateway/runtime logs. Check here when Telegram or background services are silent.~/.hermes/hermes-agentThe source checkout when installed by the git installer path.Provider setup choices
Beginner path: guided setup
hermes setup hermes model
Use this when you are unsure. It walks you through provider/model selection and writes the config for you.
OAuth path when available
hermes auth add openai-codex # or use the provider login offered by hermes model/setup
OAuth opens a browser login so you avoid copying secret API keys by hand.
API key path
# example private env var names OPENROUTER_API_KEY=... ANTHROPIC_API_KEY=... OPENAI_API_KEY=...
Put keys only in the local Hermes env/config flow, never into a website, prompt, GitHub issue, or shared chat.
First safe Hermes workspace test
This proves Hermes can see a harmless folder, answer from evidence, and respect boundaries before you trust it with real files.
mkdir -p ~/ai-agent-test cd ~/ai-agent-test printf "Buy milk\nEmail Sam tomorrow\nDo not edit this file yet\n" > test-note.txt hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files." hermes doctor hermes status
What success looks like
- The installer or command completes without scary red errors.
- You can run
hermes --versionoropenclaw --version. - You complete the guided model/provider setup.
- You get one local hello reply in the app, terminal, or dashboard.
- Only then: your private Telegram bot replies to one safe test.
- Status/doctor/gateway checks look healthy.
What you are about to install




Step 0 — choose one path
Important: this is the only choice section. After this, follow the visible selected panel from top to bottom.
1. Choose the agent
2. Choose your computer
Showing now: Hermes Agent on Mac. Only this computer path is visible below.
Step 1 — before touching Terminal: get these ready
This checklist changes with Step 0. Pick Hermes/OpenClaw and Mac/Windows/Linux above, then install only the prerequisites shown here before running the installer.
xcode-select --install, finish the Apple prompt, then confirm git --version works.hermes setup --portal / hermes setup.AI Agent Test with one harmless test-note.txt. Do not point Hermes at Desktop/Documents yet.C:\AI Agent Test. Avoid business folders until local chat works.sudo apt.curl and git first: sudo apt update && sudo apt install -y curl git.exec $SHELL -l or open a fresh terminal so hermes is on PATH.hermes setup./mnt/c.~/AI Agent Test with harmless notes only.xcode-select --install if git --version triggers Apple’s developer tools prompt.C:\AI Agent Test or a similar harmless folder before connecting real files.sudo apt access.curl and git first: sudo apt update && sudo apt install -y curl git.~/AI Agent Test and use that for first onboarding/tests.@BotFather, create a bot, and keep the token private.@userinfobot or @get_id_bot to allow only yourself.Dependency prerequisites by platform
Use this as the boring pre-flight check. The guided installers handle a lot, but beginners still need to know which system tools matter before blaming the agent.
| Computer | Install or verify first | Check commands | Beginner note |
|---|---|---|---|
| macOS | Xcode Command Line Tools, Homebrew, Git, Terminal restart. | xcode-select --installgit --versionbrew --version | Install Xcode tools and Homebrew before CLI installs. If brew is missing, use brew.sh, then reopen Terminal. |
| Windows native | Windows admin access, PowerShell, execution/network permission. Hermes Desktop/PowerShell installer does not require beginners to manually install Node or Python first unless hermes doctor says so. | powershellhermes --versionhermes doctorpython --version | Start native first. Do not mix native Windows and WSL halfway through one install. If later tools ask for Python, use the official Python 3 installer or Windows Store Python and rerun hermes doctor. |
| Windows WSL Ubuntu | WSL Ubuntu, sudo apt, Curl, Git, Python basics for Linux tooling: python3 python3-venv python3-pip. Node.js 24 LTS only if you choose OpenClaw or Node-based tools. | wsl --install -d Ubuntusudo apt updatesudo apt install -y curl git python3 python3-venv python3-pippython3 --version | Keep first work under ~/ai-agent-test, not /mnt/c/Users/.../Documents. |
| Linux / Ubuntu | Curl, Git, Python basics: python3 python3-venv python3-pip. Node.js 24 LTS only for OpenClaw/manual Node workflows. | sudo apt install -y curl git python3 python3-venv python3-pippython3 --versionnode --version | If node --version fails, that is fine for basic Hermes; install Node before OpenClaw or Node tools. |
| OpenClaw any OS | Node.js 24 LTS preferred; Node 22.19+ minimum for npm/manual fallback. Provider API key/login. | node --versionnpm --version | OpenClaw is Node-based, so Node is a real prerequisite there. |
Plain English rule: Hermes beginners should verify Mac Xcode/Homebrew or Windows/WSL shell basics, then let the official Hermes installer and hermes doctor tell them what is missing. OpenClaw beginners should treat Node.js 24 LTS as required.
In plain English: Step 1 is now a dependency checklist for the selected agent and computer. If any required item above is missing, fix that first or the installer/setup is likely to fail.
Step 2 — selected install path
Follow only the selected panel below. Each panel is a complete install + initial setup path. The dashboard/Web UI appears at the end on purpose.

Hermes native-local flow
Run the Desktop/native installer or CLI installer → hermes setup or hermes setup --portal → hermes model if needed → one local chat → optional Telegram gateway → hermes doctor / hermes status.
OpenClaw native-local flow
Run the official Mac/Linux/Windows installer → complete openclaw onboard when prompted → check openclaw --version and gateway/status commands → open the local dashboard/control UI → optional Telegram.
Hermes Agent on Mac — complete beginner path
Download and run the Hermes Desktop installer from the official Hermes Agent website. This is the recommended Mac path because it installs the desktop app and command-line tool together.
Press Command + Space, type Terminal, press Enter.
In plain English: Terminal is where you paste setup commands if you are not using the desktop installer.
xcode-select --install # after the Apple prompt finishes: git --version brew --version
If brew is missing, install Homebrew from brew.sh, then open a fresh Terminal before running the Hermes installer.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash exec $SHELL -l hermes --version
Success: you see a Hermes version instead of command not found.
hermes setup # optional provider/model picker any time: hermes model
Use the guided login/provider flow. Choose a browser/OAuth option when offered; use API keys only if you already understand where they are stored.
hermes config path hermes config check hermes auth list
In plain English: this confirms Hermes knows where its config lives and whether a provider login/key is available.
mkdir -p ~/ai-agent-test cd ~/ai-agent-test printf "One safe test note\n" > test-note.txt hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files." # If that command is not available, open interactive Hermes: hermes
Do not continue until you get a local reply based on the harmless test file.
hermes doctor hermes status hermes tools list
Fix obvious missing dependencies/provider errors now. Do not add Telegram while local chat is failing.
hermes gateway setup hermes gateway run
Paste your BotFather token and numeric Telegram user ID only into the local setup prompt. Keep this Terminal open for the first test. Stop with Ctrl + C.
hermes gateway install hermes gateway start hermes gateway status hermes desktop
Use hermes desktop or the installed Desktop app after command-line setup, local chat, and gateway foreground tests are healthy.
Hermes Agent on Windows — native first, WSL only if you choose it
In plain English: use the native Windows installer first. WSL Ubuntu is an optional Linux-style path for technical users, not the default. Docker is not part of this beginner setup.
Download and run the Hermes Desktop installer from the official Hermes Agent website. After it finishes, open PowerShell only if you want to verify the command-line tool.
Start → PowerShell. Run as administrator only if Windows asks for installer permission.
iex (irm https://hermes-agent.nousresearch.com/install.ps1) hermes --version
hermes setup hermes model hermes config check
Use the guided browser login/provider setup. Keep the workspace small and safe.
mkdir $HOME\ai-agent-test cd $HOME\ai-agent-test 'one safe Windows test note' | Out-File test-note.txt -Encoding utf8 hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files." # If needed, use interactive mode: hermes
hermes doctor hermes status hermes tools list hermes config path
Do this before Telegram. If PowerShell says hermes is not recognised, close and reopen PowerShell.
hermes gateway setup hermes gateway run
Use foreground gateway run first so you can see logs and stop with Ctrl + C.
hermes gateway install hermes gateway start hermes gateway status hermes desktop
Use the Desktop app or hermes desktop after local chat and health checks work.
If native Windows setup gets messy, install Ubuntu in WSL and repeat the Linux install path inside Ubuntu.
wsl --install -d Ubuntu # restart if Windows asks, then open Ubuntu: sudo apt update sudo apt install -y curl git
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash exec $SHELL -l hermes --version
hermes gateway install hermes gateway start hermes gateway status
Do this only after foreground mode works.
Hermes Agent on Linux — Ubuntu/Debian path
sudo apt update sudo apt install -y curl git
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash exec $SHELL -l hermes --version
hermes setup hermes model hermes config check
Choose the guided provider/login flow. Do not manually install Python or Node unless the official installer says to.
mkdir -p ~/ai-agent-test cd ~/ai-agent-test printf "One safe Linux test note\n" > test-note.txt hermes chat -q "Look only in this folder. Summarise test-note.txt. Do not edit files." # If needed, use interactive mode: hermes
hermes doctor hermes status hermes tools list hermes config path
Fix missing dependencies/provider config before adding Telegram.
hermes gateway setup hermes gateway run
hermes desktop
Use hermes desktop or the Desktop app only after local chat and health checks work.
hermes gateway install hermes gateway start hermes gateway status
OpenClaw on Mac — native local path
In plain English: use the official Mac/Linux shell installer. It installs OpenClaw locally and can start onboarding. Do not start with Docker.
Command + Space → Terminal → Enter.
node --version
OpenClaw recommends Node 24. Node 22.19+ is also supported. If this command fails, use the installer anyway; it can handle Node setup.
curl -fsSL https://openclaw.ai/install.sh | bash exec $SHELL -l openclaw --version
The installer may launch onboarding automatically. If it does, complete it and choose a safe workspace.
openclaw onboard
The wizard configures the local gateway, provider/API key, channels, skills, and workspace defaults.
openclaw --version openclaw gateway status
Success: you see the CLI version and a healthy local gateway/status check.
openclaw dashboard
Open the local browser UI and send one safe hello message before adding Telegram.
openclaw configure # choose channels / Telegram when prompted
Do not paste your real token into public pages. Only add Telegram after browser chat works.
openclaw gateway run # or, after setup: openclaw gateway start openclaw gateway status openclaw dashboard
# Node 24 recommended; Node 22.19+ supported npm install -g openclaw openclaw --version
OpenClaw on Windows — native PowerShell first
Choose one Windows route: use the native PowerShell installer first. WSL Ubuntu is an optional fallback for people who specifically want Linux tooling. Docker is not the beginner path.
Use the official native OpenClaw Windows installer when available. Use PowerShell when you want the CLI/gateway directly.
Start → PowerShell → right-click → Run as administrator only if Windows asks.
iwr -useb https://openclaw.ai/install.ps1 | iex openclaw --version
wsl --install -d Ubuntu # restart if asked, then open Ubuntu: sudo apt update sudo apt install -y curl git curl -fsSL https://openclaw.ai/install.sh | bash exec $SHELL -l openclaw --version
openclaw onboard
Choose provider/API key, safe workspace, and local gateway. Skip Telegram until dashboard chat works.
openclaw --version openclaw gateway status
openclaw dashboard
If the browser opens and chat replies, the basic install is working.
openclaw configure # choose channels / Telegram when prompted
openclaw gateway run # or: openclaw gateway start openclaw gateway status openclaw dashboard
openclaw gateway install openclaw gateway start openclaw gateway status
node --version npm install -g openclaw openclaw --version
Node 24 recommended; Node 22.19+ supported.
OpenClaw on Linux/WSL — native local path
In plain English: install directly inside Ubuntu/Debian/WSL. Keep Docker out of the base path unless you are deliberately building an isolated advanced environment.
sudo apt update sudo apt install -y curl git
curl -fsSL https://openclaw.ai/install.sh | bash exec $SHELL -l openclaw --version
openclaw onboard
Choose provider/API key, safe workspace, and local gateway.
openclaw --version openclaw gateway status
openclaw dashboard
openclaw configure # choose channels / Telegram when prompted
openclaw gateway run # or: openclaw gateway start openclaw gateway status openclaw dashboard
openclaw gateway install openclaw gateway start openclaw gateway status
# Node 24 recommended; Node 22.19+ supported npm install -g openclaw openclaw --version
Step 3 — BotFather and Telegram details
- In Telegram, search for verified
@BotFather. - Send
/newbot. - Choose a display name, for example
Mike Test Agent. - Choose a username ending in
bot, for examplemike_test_agent_bot. - Copy the token into a private password note. The token is a password.
- Open your new bot and press Start or send
/start. - Get your numeric ID from
@userinfobotor@get_id_bot. Never send those helper bots your token. - When Hermes/OpenClaw asks for allowed users, paste only your numeric Telegram ID.
If you accidentally share your token: emergency rotation
- Open BotFather.
- Select your bot.
- Revoke/regenerate the token.
- Update Hermes/OpenClaw gateway config.
- Restart the gateway.
Step 4 — first safe tests
Say hello in one sentence.
Explain what you can do safely. Do not use tools yet.
Look only inside my AI Agent Test folder. Tell me what files you see. Do not edit anything.
Before using tools, show me a short plan. Do not delete files, send messages, spend money, or touch business/customer/private data.
Step 5 — troubleshooting by symptom
If Hermes still fails after setup: do not reinstall three times. Run hermes doctor, check the exact error, confirm the model/provider is configured with hermes model, and only then retry the smallest failing command.
| What you see | Probably means | Try this |
|---|---|---|
command not found | Terminal cannot find the app yet. | Close/reopen Terminal, run exec $SHELL -l, then check version. |
permission denied | The command lacks permission or wrong folder. | Stop. Do not randomly add sudo. Re-read that step. |
| Model says no auth | Provider login/API key not connected. | Re-run hermes setup / hermes setup --portal, hermes model, or openclaw onboard. |
| Telegram bot silent | Gateway off, token wrong, bot not started, or user ID not allowed. | Send /start, check token/user ID, then run gateway foreground again. |
| Dashboard blank or useless | Dashboard opened before setup/gateway/doctor was healthy. | Go back to doctor/status checks. Dashboard is last. |
| Windows path feels broken | PowerShell route hit Windows-specific issues. | Use the WSL Ubuntu route in the selected panel. |
| OpenClaw complains about Node | Manual runtime mismatch. | Use the official installer, or update to Node 24 / at least Node 22.19+ before npm fallback. |
Step 6 — how to stop safely
- Foreground gateway: press Ctrl + C in the Terminal running it.
- If Telegram feels wrong: stop gateway, remove bot from groups, rotate token in BotFather.
- If unsure: stop. Do not connect customer data, payment tools, or public posting.
Step 7 — maintenance and dashboard reminder
hermes update hermes doctor # or openclaw update openclaw doctor
127.0.0.1, not public internet.AI & Automation Opportunity Intake
A calm first step for business owners: understand the business first, then decide whether AI, automation, a better process, or a simple integration is the right fix.
the business
friction
systems
safe pilot
What this intake helps uncover

Discuss a role or send one messy workflow.
I am most useful where a person, team, or business wants to use AI better but needs help choosing the right tool, finding the right workflow, reducing repeated admin, or adding safe review gates before AI touches customers, money, or operations.
- the workflow or system that feels messy
- what “better” would look like
- which tools, inboxes, CRM, files, or handoffs are involved
- you need a workflow mapped before automation
- you want dashboards, review gates, or clearer handoffs
- your AI idea needs practical operator judgment
- no unsupervised customer messages
- no spam, scraped outreach, or fake authority
- no black-box systems without evidence or rollback
Nothing to delete. Unreleased apps are safely hidden.
Degenerate ShitRecovered app shortcut