---
title: Tutorials
description: Hands-on, copy-pasteable walkthroughs — from git clone to a running, useful agent.
---

# Tutorials

Hands-on, copy-pasteable walkthroughs that take you from `git clone` to a running, useful agent.
Every command is verified against the current `main`. Work through them in order, or jump to the
one you need.

<div class="grid cards" markdown>

-   :material-rocket-launch: **[Your first sandboxed agent in 5 minutes](first-agent.md)**

    One command, no credentials, no model key. See an agent actually reply through a real
    per-session sandbox.

-   :material-slack: **[Connect IronClaw to Slack](connect-slack.md)**

    Wire an agent group to a live Slack channel — bot token, messaging group, engagement rules, and
    a reply destination.

-   :material-tools: **[Write a custom channel adapter](custom-channel-adapter.md)**

    Build, register, and test a new channel adapter end to end, with a complete working Pushover
    example.

</div>

Looking for something else? The [Quickstart](../quickstart.md) is the shortest path to a running
control-plane, and the [Channel adapters](../channels.md) reference lists every built-in channel and
the credential it needs.

Hit an error? Run `ironctl doctor`, then see [Troubleshooting](../troubleshooting.md) (every check
mapped to a fix, plus the common build/Docker/port/userns failures) and the [FAQ](../faq.md).
