Agent PEF

Three-bot Telegram orchestration with Cloudflare Workers and local Clawdbot instances.

Architecture

┌──────────────────────────────────────────────────────────────────────────┐
│                      Telegram Group: pef-agents                          │
│                                                                          │
│   @agentpeflaptopbot       @agentpefstationbot       @agentpefbot        │
│   (Laptop)                 (Station PC)              (Cloud)             │
│   Port 18790               Port 18791                Port 18789          │
│         │                        │                        │              │
└─────────┼────────────────────────┼────────────────────────┼──────────────┘
          │                        │                        │
          ▼                        ▼                        ▼
   ┌─────────────┐          ┌─────────────┐         ┌──────────────────┐
   │ Laptop      │          │ Station PC  │         │ Cloudflare       │
   │ • Files     │          │ • Files     │         │ • Always-on      │
   │ • Pro sub   │          │ • Pro sub   │         │ • R2 storage     │
   │ • Dev tools │          │ • Dev tools │         │ • API billing    │
   └─────────────┘          └─────────────┘         └──────────────────┘

Cloning

Each bot directory is a git submodule. Clone with all submodules:

git clone --recurse-submodules https://github.com/zepef/agent-pef.git

Or clone a single bot repo directly:

git clone https://github.com/zepef/pefstationbot.git

If you already cloned without --recurse-submodules:

git submodule update --init --recursive

Quick Start

Laptop Bot

cd peflaptopbot
.\scripts\openclawd.ps1 start peflaptopbot

Station Bot

cd pefstationbot
.\scripts\openclawd.ps1 start pefstationbot

Cloud Bot

cd pefcloudbot
npm run deploy

Documentation

Document	Description
INSTALL.md	Full installation guide - start here
SETUP.md	Detailed configuration reference
USER_MANUAL.md	Daily operations guide
Laptop bot identity	Laptop bot persona
Station bot identity	Station bot persona
Cloud bot identity	Cloud bot persona
Laptop bot setup	Laptop bot setup guide
Station bot setup	Station bot setup guide
OpenClawd CLI	Local bot CLI reference
AGENTS.md	Safety rules and boundaries

Project Structure

agent-pef/
├── README.md              # This file
├── AGENTS.md              # Safety rules (used by bots)
├── .claude/               # Claude Code project settings
├── docs/                  # Shared documentation
│   ├── INSTALL.md         # Installation guide
│   ├── SETUP.md           # Configuration details
│   └── USER_MANUAL.md     # Operations manual
├── peflaptopbot/          # ⟶ submodule: github.com/zepef/peflaptopbot
├── pefstationbot/         # ⟶ submodule: github.com/zepef/pefstationbot
└── pefcloudbot/           # ⟶ submodule: github.com/zepef/pefcloudbot

Creating a New Bot

Each bot repo is a self-contained template. To create a new bot instance:

Local bot (like laptop/station):

# Fork an existing local bot repo on GitHub, then:
git clone https://github.com/zepef/your-new-bot.git
cd your-new-bot
npm install -g openclaw
.\scripts\openclawd.ps1 create-profile
# Enter: new bot name, token from @BotFather, unused port
.\scripts\openclawd.ps1 start your-new-bot

Cloud bot (Cloudflare Workers):

git clone https://github.com/zepef/pefcloudbot.git your-new-cloudbot
cd your-new-cloudbot
npm install
npx wrangler secret put ANTHROPIC_API_KEY
npx wrangler secret put TELEGRAM_BOT_TOKEN
npm run deploy

The local bot repos (peflaptopbot, pefstationbot) share the same scripts and structure — only the profile config (bot token, port, name) differs.

Requirements

• Node.js 22+
• Git for Windows
• Cloudflare Workers Paid ($5/mo) — cloud bot only
• Anthropic API key
• Telegram bot token per bot (via @BotFather)

License

MIT