> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Hosted AI agents that can run code, manage files, and connect to other services

Pinata Agents gives you a hosted AI agent in its own sandboxed container. The agent has a workspace it can read and write to, a terminal it can run commands in, and connectors for the outside world — chat apps, web servers, scheduled jobs. You talk to it through the dashboard, the CLI, or whichever messaging platform you connect it to.

Under the hood, each agent runs the [OpenClaw](https://openclaw.org) engine. You don't have to know OpenClaw to use one, but if you go deep, that's the project to read.

<Note>
  Agents require a paid Pinata plan. [Upgrade here](https://app.pinata.cloud/billing).
</Note>

## Get your first agent running

It takes a couple of minutes. You'll connect an LLM provider, create the agent, and start chatting.

### 1. Connect an LLM provider

Your agent needs an LLM to think. Go to the [Secrets Vault](https://agents.pinata.cloud/secrets).

At the top of that page you'll see a row of provider cards: **Anthropic**, **OpenAI**, **OpenRouter**, **Pinata**, **Venice**, and **Custom**. Click **Connect** on whichever one you use, paste your API key (or run through OAuth if you're using an OpenAI Codex subscription), and save.

<Tip>
  Don't have an API key? [Anthropic](https://console.anthropic.com/), [OpenAI](https://platform.openai.com/), and [OpenRouter](https://openrouter.ai/) all offer free trial credits.
</Tip>

You can connect more than one provider — useful so you have a fallback if one is down.

### 2. Create an agent

Head to [My Agents](https://agents.pinata.cloud/agents) and click **Create Agent**.

You have two paths:

* **Start from a template** — fastest. Templates come pre-wired with skills, settings, and a personality. Pick one from the [Marketplace](https://agents.pinata.cloud/marketplace) (others' templates) or [My Templates](https://agents.pinata.cloud/templates) (your own). Add the secrets it needs, deploy.
* **Build from scratch** — full control. The wizard walks you through naming the agent, picking a personality preset (Atlas, Nova, Sage, or custom), choosing skills, and connecting your LLM provider.

Either way, the agent takes about 30 seconds to provision. When it's ready you land on its Chat tab.

### 3. Start a conversation

Say hello. Ask it to write some code, summarize a webpage, or set up a workflow. It can use a terminal, edit files, search the web, and call any skills you've attached.

<Frame>
  <img src="https://mintcdn.com/pinata/p6XBuxeipyyP6Ugl/images/image-29.png?fit=max&auto=format&n=p6XBuxeipyyP6Ugl&q=85&s=d12977406505cb8221f568882f6cc677" alt="Image" width="1969" height="1358" data-path="images/image-29.png" />
</Frame>

## Finding your way around

The sidebar on the left is the same on every page. Top half is the workspace itself; bottom half is account and support.

| Section            | What's in it                                                                                    |
| ------------------ | ----------------------------------------------------------------------------------------------- |
| **My Agents**      | Every agent you've created. Click one to expand its tabs (Chat, Channels, Files, Skills, etc.). |
| **My Issues**      | A kanban board for assigning work to agents. Closed beta — `@pinata.cloud` accounts today.      |
| **Skills Library** | Skills you've installed, plus a community catalog under **Browse ClawHub**.                     |
| **Secrets Vault**  | All your encrypted credentials, in one place, shared across agents.                             |
| **My Templates**   | Templates you've created or imported.                                                           |
| **Marketplace**    | Published templates from Pinata and other builders, ready to deploy in one click.               |
| **Account**        | **Workspaces** (switch teams), **Integrations** (e.g. GitHub OAuth), **Activity** (audit log).  |
| **Support**        | Docs, the OpenAPI reference, changelog, and a way to chat with the Pinata team.                 |

<Tip>
  **⌘K** (or **Ctrl+K**) opens a command palette for jumping to any agent, page, or action.
</Tip>

## The agent dashboard

Click any agent and you'll see tabs across the top of the page. Each tab is a slice of how the agent works:

* **Chat** — your conversation with the agent
* **Channels** — wire it up to Telegram, Slack, or Discord
* **Files** — workspace snapshot history, content diffs, git URL
* **Skills** — capabilities attached to this specific agent (pulled from your Skills Library)
* **Secrets** — provider connections and env vars this agent can see
* **Models** — which models from your providers it's allowed to use, and which is the default
* **Routes** — path routes and custom domains for any web service it runs
* **Tasks** — cron jobs and one-off scheduled prompts
* **Console** — a terminal inside the container
* **Logs** — real-time log stream
* **Danger** — full configuration overview, plus restart and delete

That last one is named "Danger" deliberately — restart and delete live there, but so does most of the inventory data, so it's also the page you'll open when you need to know exactly how an agent is configured.

## Editing the workspace locally

Your agent's workspace is a git repo you can clone and push to.

```bash theme={null}
git clone https://agents.pinata.cloud/v0/agents/{agentId}/git my-agent
```

On the Files tab, **Copy with Token** gives you a URL with authentication built in so you don't have to manage credentials. Edit locally, push, and the agent picks up your changes — the build script (if you've defined one) runs automatically.

See [Files & Snapshots](/agents/snapshots) for the full flow.

## Working from the terminal

Everything in the dashboard is in the CLI too:

```bash theme={null}
pinata agents list              # See your agents
pinata agents create            # Create a new agent
pinata agents get <agent-id>    # Get agent details
pinata agents chat <agent-id>   # Talk to it from your terminal
```

Full reference: [Agents CLI](/tools/cli/agents).

## Going deeper

<CardGroup cols={2}>
  <Card title="Concepts" icon="compass" href="/agents/concepts">
    Glossary, file layout, and how the pieces relate
  </Card>

  <Card title="Manifest reference" icon="file-code" href="/agents/manifest">
    Every field in `manifest.json`, the source of truth for an agent's config
  </Card>

  <Card title="HTTP API" icon="plug" href="/agents/api">
    Auth model and endpoint reference for building against the platform
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/agents/troubleshooting">
    What to do when something doesn't work
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Templates" icon="grid-2" href="/agents/templates/overview">
    Deploy a pre-built agent in one click
  </Card>

  <Card title="Channels" icon="comments" href="/agents/channels">
    Let people talk to your agent on Telegram, Slack, or Discord
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles" href="/agents/skills">
    Add capabilities — IPFS storage, memory, on-chain identity, more
  </Card>

  <Card title="Routes" icon="network-wired" href="/agents/routes">
    Expose a web app or API from inside the agent
  </Card>
</CardGroup>