heyron Tutorials

Step-by-step guides to get the most out of your AI agent. No coding required.

📚 123 tutorials · 52 personas · 15+ skills
Searches titles, descriptions, and labels instantly as you type.
No tutorials matched that search yet. Try a broader keyword like Discord, memory, or files.
🚀 Start Here
Getting Started

What Your Agent Can (and Can't) Do

Set your expectations right. Everything your agent can do out of the box, what needs setup, and what's not possible yet.

⏱ 4 minute read · Beginner
Getting Started

Overwhelmed in Week 1? A No-Tech First Win Plan

A practical 90-minute workflow for non-technical users to get one real result fast and avoid setup spiral loops.

⏱ 5 minute read · Beginner
Getting Started

Your First SOUL.md — Give Your Agent a Personality

The single most impactful thing you can do. Give your agent a name, a voice, and a personality with ready-to-use templates.

⏱ 5 minutes · Beginner
Concepts

API Keys & Models — Choosing Your Agent's Brain

What models are, what they cost, how to get API keys, and which model is right for you.

⏱ 5 minute read · Beginner
Troubleshooting

Agent Burning Too Many Tokens?

A practical workflow to reduce token burn fast with smaller turns, strict output limits, and compact handoffs.

⏱ 4 minute read · Beginner
🔌 Connect Your Agent
Setup

Connect Your Agent to Discord

Talk to your AI agent from any Discord server. Full walkthrough plus troubleshooting for the most common issues.

⏱ 10 minutes · Intermediate
Troubleshooting

Discord Developer Says “Verify Email” (But You Did)?

A deterministic fix flow for Developer Portal account/session drift that blocks bot app creation.

⏱ 4 minute fix · Beginner
Setup

Connect Your Agent to Telegram

Set up your agent on Telegram in under 5 minutes. The easiest channel to get running.

⏱ 5 minutes · Beginner
Setup

Connect Your Agent to Google Chat

A practical setup + troubleshooting guide for adding your heyron agent to Google Chat spaces without getting stuck.

⏱ 4 minute setup · Beginner
Setup

Run OpenClaw Locally (Without Getting Stuck)

A practical first-run guide for local OpenClaw setup with a smoke-test flow and deterministic troubleshooting.

⏱ 5 minute setup · Intermediate
Setup

Chrome Extension Can’t Reach Remote Gateway?

A deterministic setup for remote browser control: stable endpoint, origin/token checks, canary test, then real workflows.

⏱ 4 minute setup · Intermediate
Setup

Set Up ElevenLabs Voice for Your Agent

Configure key + voice ID correctly, avoid free-tier gotchas, and run a known-good voice smoke test in minutes.

⏱ 4 minute setup · Beginner
Setup

Send Voice Messages in Telegram with ElevenLabs

A quick fix for text-only Telegram replies: validate key + voice access and run a deterministic two-turn voice smoke test.

⏱ 4 minute setup · Beginner
đź§  Understand Your Agent
Concepts

How Agent Memory Works

Why your agent "forgets" things, how memory actually works under the hood, and how to make important things stick.

⏱ 5 minute read · Beginner
Privacy & Security

What Does My Agent Know About Me?

A simple privacy audit flow to verify what your agent can access, what it remembers, and how to reduce oversharing risk.

⏱ 4 minute read · Beginner
Privacy & Security

Agent Shared Private Info in a Group Chat?

A fast containment and prevention workflow for accidental data leakage in shared channels.

⏱ 4 minute read · Beginner
Privacy & Security

Is It Safe to Paste Client Data Into Your Agent?

A simple redaction-first workflow to protect client information while still getting useful agent output.

⏱ 4 minute read · Beginner
🛠️ How-To & Reference
How-To

Working with Files — Sending Photos, Documents & More

Where file attachments work, where they don't, and workarounds for getting images and documents to your agent.

⏱ 3 minute read · Beginner
How-To

Prompting Your Agent Like a Pro

A practical guide to getting better outputs from your agent using a simple 4-part prompt formula and real before/after examples.

⏱ 4 minute read · Beginner
Troubleshooting

Open Better Support Tickets (and Get Faster Fixes)

A 3-minute copy/paste format to report issues with exact evidence, clear repro steps, and destination context.

⏱ 3 minute read · Beginner
Troubleshooting

How to Create a Help Ticket (Fast)

A simple 3-minute flow to use the active support path, submit complete evidence, and avoid retry loops.

⏱ 3 minute read · Beginner
Troubleshooting

Ticket Marked Resolved, But Not Fixed?

A fast reopen format with fresh repro proof so unresolved issues don't get stuck in repeated support loops.

⏱ 3 minute read · Beginner
Troubleshooting

#help Moved? Where to Get Support Now

A quick route to active support when legacy channels are archived, with a copy/paste evidence packet for faster triage.

⏱ 3 minute read · Beginner
How-To

How to Use Sub-Agents Without Chaos

Delegate work safely with a manager+workers pattern, strict role boundaries, and a clean final merge workflow.

⏱ 4 minute read · Beginner
Reference

Your Dashboard — Every Button Explained

Complete guide to the OpenClaw Control UI. What every page, button, and field does — so you never feel lost.

⏱ 10 minute reference · All levels
🩹 Troubleshooting
Memory, files & context
Troubleshooting

Updated File But Agent Uses an Old Version?

Fix stale-file confusion with a fast versioning + quote-proof workflow so your agent uses the latest draft every time.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Edited the Wrong File?

Recover fast when edits land in the wrong file by using a path-proof workflow, dry-run patching, and explicit do-not-touch boundaries.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Says It Saw Your Image (But It Didn’t)?

Stop screenshot hallucination loops with a fast visibility test, recovery flow, and support-ready escalation packet.

⏱ 4 minute read · Beginner
Troubleshooting

Why Your Agent Gets Worse in Long Chats

A plain-English guide to session length, bloated chats, lost work, and the 4 habits that keep your progress safe.

⏱ 6 minute read · Beginner
Troubleshooting

Starting Fresh Without Pasting Your Entire Old Chat

A fast recovery pattern for long-chat degradation: preserve what matters, use a compact handoff, and avoid context bloat loops.

⏱ 4 minute read · Beginner
Troubleshooting

Used /new and Now Your Bot Won’t Respond?

A fast recovery flow for post-reset silence, including clean-surface ping tests, permission checks, and session-mismatch fixes.

⏱ 4 minute read · Beginner
Dashboard, permissions & runtime
Troubleshooting

“Meet [Agent]” Opened OpenClaw Dashboard?

Why this is usually expected, how to verify your setup in 2 minutes, and when it’s a real issue worth escalating.

⏱ 4 minute read · Beginner
Troubleshooting

Why Your Agent Says “Approval Required”

A plain-English guide to approval prompts: what they mean, when to approve, when to deny, and how to avoid getting stuck.

⏱ 4 minute read · Beginner
Troubleshooting

Approval Keeps Coming Back?

Fix repeated approval loops by approving exact commands, understanding allow-once scope, and avoiding command mismatch gotchas.

⏱ 4 minute read · Beginner
Troubleshooting

Sentinel Value “__OPENCLAW_REDACTED__” Error?

A fast fix for config save failures caused by redacted placeholder values being treated as real secrets.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Keeps Changing Too Much?

Fix over-editing loops with a scope-lock workflow: target exactly what should change, protect everything else, and verify with diff proof.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Feels Slow or Stuck?

A fast diagnostic checklist for laggy replies, long-running tasks, approval pauses, and getting back to reliable speed.

⏱ 4 minute read · Beginner
Troubleshooting

Chat Works, But Tools Don’t Run?

Fix execution-layer freeze loops where normal chat works but file/command tasks hang, using a canary-first recovery flow.

⏱ 4 minute read · Beginner
Troubleshooting

Fixed It, But Still Seeing the Old Error?

Break stale-session retry loops after config/key changes with a proof-first canary workflow.

⏱ 4 minute read · Beginner
Troubleshooting

Security Hardening Broke Your Agent?

Recover safely from over-restrictive policy changes with a one-rule-at-a-time rollback and canary-proof workflow.

⏱ 4 minute read · Beginner
Troubleshooting

Context Limit Exceeded?

Recover fast from oversized prompt failures using a staged workflow, compact context rules, and a copy/paste rescue prompt.

⏱ 4 minute read · Beginner
Troubleshooting

Why Tools Suddenly Disappeared?

Fix the common "I could do this yesterday" loop by checking session surface, policy drift, and approval-state mismatches.

⏱ 4 minute read · Beginner
Troubleshooting

Tool Works in DM but Fails in Server?

Use a side-by-side canary test to prove context mismatch fast and recover with exact-error evidence instead of guesswork.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Offline? Container Might Be Down

Use a quick liveness + execution isolation flow to confirm runtime issues and recover safely without guessing.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Said It Did Something — But Didn’t?

Fix execution-mismatch trust breaks with a simple “done + evidence + verification” workflow and escalation packet.

⏱ 4 minute read · Beginner
Troubleshooting

Seeing a 502 Error? Agent Not Loading?

A practical recovery checklist for common 502 failures, plus a clean support packet you can paste into #help.

⏱ 4 minute read · Beginner
Troubleshooting

Runtime Not Healthy (Health 502) During Setup?

A deterministic setup-time recovery flow that separates local noise from real host/runtime health failures.

⏱ 4 minute read · Beginner
Troubleshooting

Module 2: Agent Shows Error and Won’t Reply?

A beginner-friendly 4-minute flow to isolate repeated setup-time reply errors and escalate with clean evidence.

⏱ 4 minute read · Beginner
Troubleshooting

Auth Failed: Gateway Token Mismatch?

Fix unauthorized login loops fast by resetting stale dashboard token state and re-pairing with the correct active gateway token.

⏱ 4 minute read · Beginner
Troubleshooting

“Origin Not Allowed” in Control UI?

Fix dashboard access failures by matching exact browser origin, updating allowedOrigins, and restarting gateway cleanly.

⏱ 4 minute read · Beginner
Troubleshooting

“Pairing Required” or “Unauthorized” on Connect?

Fix node-connect failures caused by stale pairing state, token mismatch, or local-vs-remote URL confusion.

⏱ 4 minute read · Beginner
Troubleshooting

Dashboard Blank Screen? (No Error Message)

A quick isolation flow for blank dashboard pages caused by browser session, extension, VPN/proxy, or network-path issues.

⏱ 4 minute read · Beginner
Discord & channel behavior
Troubleshooting

My Agent Replies to Everything

Stop over-chatty behavior in Discord with clear response gates, silence rules, and a copy/paste group-chat policy block.

⏱ 4 minute read · Beginner
Troubleshooting

Discord Slash Commands Missing?

A focused recovery checklist for when “/” commands don't appear, including role permissions, channel overrides, and known-good tests.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Can’t Read Discord Channels?

A practical fix for guild/channel ID mixups and hidden channel permission overrides that make bots look "broken."

⏱ 4 minute read · Beginner
Troubleshooting

Bot Can Read But Can’t Reply in Discord?

Use a clean-room channel test to isolate send-permission, thread/forum, and integration restriction issues in minutes.

⏱ 4 minute read · Beginner
Troubleshooting

Discord Bot Typing... Then Nothing?

Fix the high-friction typing-then-silent loop with a fast channel-policy isolation flow and known-good recovery steps.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Sent Duplicate Replies?

Stop double-reply loops by isolating trigger paths, policy overlaps, and stale runtime config with a clean-room test.

⏱ 4 minute read · Beginner
Troubleshooting

Discord Showing a Blank Channel After Setup?

Recover quickly when Discord UI goes blank during onboarding with a client-state reset flow and canary retest.

⏱ 4 minute read · Beginner
Troubleshooting

Discord Thread Archived? Agent Not Replying?

Fix the common “works in DM/channel, silent in thread” failure by checking archived/locked state and thread-level permissions first.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Keeps Using Markdown Tables in Discord?

Force clean bullet-point output in chat apps with a strict format contract, canary test, and anti-regression workflow.

⏱ 4 minute read · Beginner
Troubleshooting

Discord Message Too Long? Agent Replies Cut Off?

Fix silent/partial reply failures by switching to chunked output and file-first fallbacks instead of one giant message.

⏱ 4 minute read · Beginner
Troubleshooting

Pin Permission Is On, But Agent Still Can’t Pin?

Diagnose Discord pin-action failures fast and use a reliable manual-handoff fallback when moderation actions are blocked.

⏱ 4 minute read · Beginner
Troubleshooting

Is This a Different Bot? (DM vs Channel)

A plain-English fix for the common confusion where DM works but server channels feel like a different agent.

⏱ 4 minute read · Beginner
Troubleshooting

Dashboard vs Discord: Why Context Doesn’t Carry Over

Fix the “it forgot everything” confusion when switching between dashboard chat, Discord DMs, and server channels.

⏱ 4 minute read · Beginner
Troubleshooting

Did I Create a Second Agent by Accident?

A fast identity/workspace verification flow for when your bot name, memory, or settings suddenly look wrong.

⏱ 4 minute read · Beginner
Files, outputs & workspace access
Troubleshooting

Where Did My Files Go?

A fast path-first workflow to find missing outputs, verify actual write location, and stop "saved but can’t find it" loops.

⏱ 4 minute read · Beginner
Troubleshooting

GitHub File Doesn’t Match Workspace?

A proof-first workflow to classify file mismatch fast (local ahead, remote ahead, or wrong context) before overwriting work.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Says “Permission Denied” When Saving Files?

Fix write-failure loops quickly with a path-proof workflow, tiny canary test, and evidence-first completion checks.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Keeps Creating Duplicate Files?

Stop duplicate-file chaos with deterministic naming, find-before-create rules, and a simple cleanup protocol.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Deleted Files by Mistake?

Contain damage fast, recover safely with proof, and add guardrails to prevent destructive delete incidents.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Keeps Asking the Same Question?

Break repeated clarifying-question loops with a compact requirement block, strict ask policy, and evidence-first completion rules.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Replies in the Wrong Language?

Stop language drift with a hard language lock, fresh-context reset, and output-format checks that keep replies consistent.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Can’t Access My Computer Files?

Fix Desktop/Documents visibility confusion with a deterministic workspace path check, upload flow, and quote-proof verification.

⏱ 4 minute read · Beginner
How-To

Stop File Chaos with BEST_PRACTICES.md

Use a single source-of-truth file workflow to prevent duplicates, enforce naming rules, and keep project folders clean.

⏱ 4 minute read · Beginner
Troubleshooting

“I Couldn't Send You a DM” in #help?

Fix Discord DM privacy settings so Whambulance can open your support flow and your ticket doesn’t get stuck.

⏱ 3 minute read · Beginner
Automation, reminders & heartbeats
Troubleshooting

Heartbeat Keeps Repeating Old Tasks?

Fix repetitive heartbeat behavior with clean checklist design, non-repetition rules, and lightweight state tracking.

⏱ 4 minute read · Beginner
Troubleshooting

HEARTBEAT.md Errors?

A practical recovery guide for heartbeat file path mistakes, stale instructions, repeated loops, and noisy check-ins.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Keeps Saying HEARTBEAT_OK?

Fix heartbeat-reply leakage in normal chat by separating maintenance polls from user-facing conversation behavior.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Using the Wrong Time or Day?

Fix timezone drift that causes wrong-day replies, off-schedule reminders, and confusing time-based behavior.

⏱ 4 minute read · Beginner
Troubleshooting

Reminders Not Firing?

A practical 5-minute diagnosis flow for missing/late reminders, timezone mismatches, and wrong delivery context.

⏱ 4 minute read · Beginner
Troubleshooting

Can My Agent Keep Working While I’m Away?

Stop “it stopped when I closed chat” confusion with a simple background-work model: explicit schedule + explicit destination.

⏱ 4 minute read · Beginner
Troubleshooting

Heartbeat vs Cron: Which One Should You Use?

Fix scheduler trust issues by choosing the right automation mode for exact reminders vs flexible background checks.

⏱ 4 minute read · Beginner
Troubleshooting

Daily Econ Calendar Reminder Not Running?

Fix weekday reminder misses by validating cron expression, timezone, delivery destination, and canary test proof.

⏱ 4 minute read · Beginner
Troubleshooting

Heartbeat/Cron Broken or Just Misconfigured?

A deterministic 5-minute checklist to separate real scheduler issues from timezone, delivery, and session-target drift.

⏱ 5 minute read · Beginner
Integrations, tools & connectors
Troubleshooting

What Skills Are (and Aren’t)

A plain-English guide to the most common confusion: skills are behavior packs, not native software installs.

⏱ 4 minute read · Beginner
Troubleshooting

Model ID Invalid or “Agent Failed Before Reply”?

Recover quickly from broken model settings, invalid fallback IDs, and “all models failed” loops with a safe rollback workflow.

⏱ 4 minute read · Beginner
Troubleshooting

Model Change Failed (500)?

Fix model-switch 500 loops with a deterministic isolate→retest→restart flow and a support-ready evidence packet.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Says You Must Install a CLI Tool?

Stop unnecessary setup loops with a no-install recovery prompt, assumption check, and safer decision flow.

⏱ 4 minute read · Beginner
Troubleshooting

GitHub Module Says “I Can’t Clone Repos”?

Fix security-restriction clone loops with a read-only canary test, context checks, and an evidence-first workflow.

⏱ 4 minute read · Beginner
Troubleshooting

Can My Agent Write to Google Sheets?

Fix the common “needs CLI” confusion with a connector/auth check, tiny write test, and clean escalation packet.

⏱ 4 minute read · Beginner
Troubleshooting

Google Drive Connected, But Agent Can’t Find Files?

Break the connected-but-unavailable loop with a fast account/scope/session check and a tiny canary test.

⏱ 4 minute read · Beginner
Troubleshooting

Google Drive Connected, But Agent Can’t Upload Files?

Fix connected-but-upload-failed loops with account/folder lock, canary upload proof, and one-variable-at-a-time recovery.

⏱ 4 minute read · Beginner
Troubleshooting

Google Docs Connected, But Agent Can’t Edit?

Fix connected-but-read-only Google Docs loops with a tiny canary write, permission checks, and an evidence-first recovery flow.

⏱ 4 minute read · Beginner
Troubleshooting

Gmail Connected, But Agent Won’t Send?

Fix Gmail connector send failures with a proof-first canary workflow and a clean loop-break escalation path.

⏱ 4 minute read · Beginner
Troubleshooting

Gmail Connected, But Agent Can’t Send Attachments?

A deterministic path to isolate attachment path/type/size failures without reconnect loops.

⏱ 4 minute read · Beginner
Troubleshooting

Gmail Connected, But Sending from the Wrong Account?

Fix sender-identity mismatch with a one-email canary proof flow for account and alias correctness.

⏱ 4 minute read · Beginner
Troubleshooting

Gmail Says “Sent,” But Recipient Never Got It?

A proof-first workflow to isolate deliverability issues, folder filtering, and sender-identity mismatch before reconnect retries.

⏱ 4 minute read · Beginner
Troubleshooting

Google Calendar Connected, But No Events?

Break connected-but-empty calendar loops with account/calendar proof, timezone checks, and a tiny canary read.

⏱ 4 minute read · Beginner
Troubleshooting

Google Calendar Connected, But Agent Can’t Create Events?

Fix connected-but-no-write loops with one canary create + read-back proof before scaling to real scheduling.

⏱ 4 minute read · Beginner
Troubleshooting

Calendar Event Updated, But Still Showing Old Time?

A deterministic edit-proof workflow for wrong-event edits, timezone drift, and stale Calendar display confusion.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Can Read the Web But Can’t Click Buttons?

Understand read-only web access vs browser automation, diagnose capability limits fast, and use a clean human+agent handoff.

⏱ 4 minute read · Beginner
Troubleshooting

Can My Agent Run My Facebook Page Automatically?

A practical split-lane workflow: agent-led planning + human/API-backed publishing, without login-loop frustration.

⏱ 4 minute read · Beginner
Troubleshooting

Using Canva with Your Agent (Without Login Loops)

A capability-safe Canva workflow: agent creates strategy + copy + design blueprint, human runs final in-editor actions.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Can’t Log Into WordPress?

A practical API-first workflow for drafting and publishing WordPress posts without browser-login failure loops.

⏱ 4 minute read · Beginner
Troubleshooting

Using Midjourney with Your Agent (Without Getting Stuck)

A practical workflow for Midjourney: agent-led prompt strategy + manual generation steps, with a fast canary test and loop-break rules.

⏱ 4 minute read · Beginner
Troubleshooting

Agent Can’t Open My Link (But It Works for Me)?

Diagnose private/login-gated URLs, anti-bot blocks, and safe workarounds when your browser can see pages the agent cannot.

⏱ 4 minute read · Beginner
Troubleshooting

Web Search Returned Nothing?

Fix empty or low-signal search results with a canary query, constraint isolation flow, and a support-ready evidence packet.

⏱ 4 minute read · Beginner
Troubleshooting

Do You Need a Brave API Key for Web Search?

Resolve "missing Brave key" confusion quickly with a canary-search workflow and a clean evidence-first escalation path.

⏱ 4 minute read · Beginner
Troubleshooting

Dropbox Not Working? Install MCP the Right Way

A practical fix for “Dropbox MCP required” errors, with connector/auth checks, smoke test prompt, and escalation packet.

⏱ 4 minute read · Beginner
Troubleshooting

MCP Connected But Still Not Working?

Fix connector "installed but unavailable" loops with a fast auth/session reset flow, smoke test prompt, and clean escalation packet.

⏱ 4 minute read · Beginner
đź§© Power Up
Agent Personas

52 Ready-to-Use Agent Personas

Pre-built SOUL.md files for every use case — personal assistant, copywriter, fitness coach, real estate agent, and 48 more. Copy, paste, go. Free forever.

🎭 52 personas · 12 categories
Skills Library

Skills Library — Plug-and-Play Abilities for Your Agent

15+ ready-to-use skills: human writing, market research, daily briefings, email management, SEO, journaling, and more. Install in one command.

🧩 15+ skills · Browse the catalog
đź“° Community
Weekly Digest

The Den Weekly — April 5, 2026

AI divorce mediation, robotics builds, kids curriculum, best setup tips, recurring support issues, and this week's helper shoutouts.

📰 Issue #2 · Week of Mar 31–Apr 5
🌩️ New content added regularly. Check back or follow updates in The Den.