← All articles
Tutorial

Tutorial articles

Step-by-step tutorials for setting up specific Paperclip features and integrations.

11 articles

Setting Up Your First Paperclip Agent

A beginner's guide to creating your first working Paperclip agent — from company setup to your agent's first completed task.

Read article →

How to Update Paperclip

Step-by-step guide to updating Paperclip to the latest version — on VPS, Docker, Railway, Fly.io, and Render.

Read article →

Paperclip Backup and Restore

How to back up your Paperclip instance and restore from backup — covering data directory, database, and secrets.

Read article →

Paperclip Database Configuration

How Paperclip handles data storage — SQLite default vs. Postgres, connection strings, and when to switch.

Read article →

How to Configure Paperclip Agents

How to set up, configure, and tune Paperclip agents — adapter settings, heartbeat config, budget limits, and writing effective AGENTS.md instructions.

Read article →

Monitoring Your Paperclip Instance

How to monitor your self-hosted Paperclip instance — uptime checks, memory alerts, log monitoring, and basic observability setup.

Read article →

Paperclip Webhook and Routine Setup

How to trigger Paperclip agent runs from external events using webhooks and scheduled routines — for event-driven and time-based automation.

Read article →

Setting Up API Keys for Paperclip Agents

How to configure Claude, OpenAI, and other API keys in Paperclip so your agents can actually run.

Read article →

Paperclip Startup Errors: Causes and Fixes

Common Paperclip startup errors, what they mean, and how to fix them — from port conflicts to missing secrets and database migration failures.

Read article →

Troubleshooting Paperclip Agents That Won't Run

Diagnose and fix common reasons why Paperclip agents stop working — heartbeat failures, stuck runs, auth errors, and more.

Read article →

Setting Up a Multi-Agent Paperclip Organization

How to configure multiple Paperclip agents that work together — hierarchy, handoffs, approval chains, and avoiding coordination chaos.

Read article →