blink-agents

name	blink-agents
description	Blink Claw agent management — managed AI agent hosting on Fly.io. List agents, check status, manage secrets. For autonomous agents, Telegram/Discord bots, and scheduled workflows.

What is Blink Claw?

Blink Claw provides managed AI agent hosting on Fly.io. Each agent runs in its own isolated Fly machine with persistent storage, pre-installed tools (browser, file system, CLI), and always-on connectivity for platforms like Telegram, Discord, and Slack.

Getting Started

# List all agents in the workspace
blink agent list

# Check agent status
blink agent status <agent-id>

# Manage agent secrets
blink secrets list --agent <agent-id>
blink secrets set MY_API_KEY sk-123 --agent <agent-id>
blink secrets delete MY_API_KEY --agent <agent-id>

MCP Tools

Tool	Description
blink_agent_list	List all Claw agents in the workspace
blink_agent_status	Get agent status, machine info, and health
blink_agent_secrets_list	List secret names for an agent
blink_agent_secrets_set	Set a secret on an agent
blink_agent_secrets_delete	Delete a secret from an agent

Agent Lifecycle

Agents are created and configured via the Blink dashboard at blink.new. Once created:

1. Running — Agent machine is active, processing tasks
2. Stopped — Machine paused, can be resumed
3. Error — Machine crashed, check logs

CLI Usage

# List agents with status
blink agent list
# Output:
# ID              Name            Status    Platform    Created
# ag_a1b2c3d4     Support Bot     running   telegram    2026-03-15
# ag_e5f6g7h8     Data Scraper    stopped   none        2026-04-01

# Get detailed status
blink agent status ag_a1b2c3d4
# Output:
# Name: Support Bot
# Status: running
# Platform: telegram
# Machine: blink-claw-a1b2c3d4 (iad)
# Uptime: 3d 14h 22m
# Memory: 512MB / 1GB

# Set environment secrets
blink secrets set OPENAI_API_KEY sk-abc123 --agent ag_a1b2c3d4
blink secrets set TELEGRAM_BOT_TOKEN 123456:ABC --agent ag_a1b2c3d4

# List secrets (values hidden)
blink secrets list --agent ag_a1b2c3d4
# Output:
# OPENAI_API_KEY     ****abc123
# TELEGRAM_BOT_TOKEN ****ET:ABC

# Remove a secret
blink secrets delete OPENAI_API_KEY --agent ag_a1b2c3d4

Use Cases

• Telegram/Discord/Slack bots — always-on agents connected to messaging platforms
• Autonomous research agents — web browsing, data collection, report generation
• Scheduled workflows — periodic data processing, monitoring, alerts
• Customer support — AI-powered ticket triage and response
• DevOps automation — deployment monitoring, incident response

Agent Architecture

Each Claw agent runs on a dedicated Fly.io machine with:

• Persistent volume at /data (workspace files, agent state)
• Pre-installed tools: Chromium browser, Blink CLI, Node.js
• Networking: public HTTPS endpoint + WebSocket gateway
• Skills: bundled in Docker image at /app/skills/

Notes

• Agent creation/configuration is done via the Blink dashboard, not CLI
• Secrets are stored in the Fly machine's env config — not Fly app secrets
• Agents are billed per-hour of machine uptime
• Each agent gets its own Fly app: blink-claw-{last8ofAgentId}