seclaw
Agentic AI on your machine. Multiple agents, one Telegram bot.
Self-hosted. Docker-isolated. Secure by default.
Quick Start · Auto Mode · Templates · Architecture · Security
npx seclawOne command. Pick your LLM, enter your Telegram token, choose a template. Agent live in 60 seconds.
OpenClaw proved the demand — 68K+ GitHub stars, 600K people watched the tutorial. But it ships with zero container isolation: API keys exposed to every MCP container, your home directory mounted to root-privileged processes, port 5678 open to the internet with no auth.
seclaw fixes both problems. Same autonomous agent capabilities — with Docker-level security enforced at runtime, not in the system prompt. One can be jailbroken. The other can't.
Prerequisites: Docker Desktop, Node.js 20+, an LLM API key (OpenRouter recommended / Anthropic / OpenAI / Google), a Telegram bot token.
npx seclawThe CLI handles everything: LLM provider, API key, Telegram token, Composio integrations, template selection, docker compose up. No config files. No YAML. No Docker knowledge required.
npx seclaw status # Check all services
npx seclaw doctor # Auto-diagnose & fix issuesInstall multiple agents and they work together automatically. No manual switching — the LLM routes each message to the right capability.
You: "Summarize my unread emails and check HN for AI news"
seclaw:
Inbox: 3 urgent, 7 action needed, 12 FYI.
Top urgent: contract review from legal (deadline tomorrow).
Hacker News: Top AI stories — Anthropic launches Claude 4.5,
Google open-sources Gemma 3, OpenAI restructures.
— Inbox Management, Research & Intelligence
Every response ends with an attribution footer showing which agent(s) answered.
- Install agents —
npx seclaw add inbox-agent --key TOKEN. Each template stacks onto your base agent. - Auto-route — The LLM picks the right capability for each message. Email questions go to Inbox. Lead questions go to Sales.
- Attribution — Every response shows which agent answered. You always know who did what.
Use /templates in Telegram or npx seclaw templates in CLI to view and switch modes. Auto mode is the default.
/templates → List installed templates + switch mode
npx seclaw templates # List installed templates + active modeWhen an agent needs an integration that isn't connected, it generates an OAuth link directly in chat. No manual setup needed.
seclaw: I need X (Twitter) connected to scan for leads.
Authorize X (Twitter): https://composio.dev/auth/...
Open the link, sign in, and grant access.
After completing authorization, your new tools load automatically.
The connect_integration tool handles this programmatically — the agent calls it when it detects a missing integration, gets the OAuth URL, and shares it with the user.
17 agent templates. Self-hosted. No subscriptions. Your data stays on your machine.
| Template | Tier | What it does |
|---|---|---|
| Productivity Agent | Free | Morning reports, task management, Telegram assistant |
| Data Analyst | Free | CSV/JSON analysis, visualizations, automated reports |
| Inbox Agent | Pro | Gmail categorization (urgent/action/FYI), Telegram digest |
| Reddit & HN Digest | Pro | Daily curated digest from Reddit + Hacker News |
| YouTube Digest | Pro | Morning summary of new videos from favorite channels |
| Health Tracker | Pro | Food-symptom tracking, weekly correlation analysis |
| Earnings Tracker | Pro | Tech/AI earnings reports with beat/miss analysis |
| Research Agent | Pro | Multi-source competitor monitoring (X, HN, Reddit, RSS) |
| Knowledge Base | Pro | Personal knowledge management from URLs, articles, tweets |
| Family Calendar | Pro | Household coordination, calendar aggregation, grocery lists |
| Content Agent | Premium | Trending topic research, draft in your voice, post with approval |
| Personal CRM | Premium | Contact auto-discovery from email, meeting briefings, follow-ups |
| YouTube Creator | Premium | Breaking news scouting, video idea pitches, full outlines |
| DevOps Agent | Premium | Health checks every 15min, auto-restart, security audits |
| Customer Service | Premium | Gmail inquiry monitoring, KB-backed replies, approval gates |
| Sales Agent | Premium | Buying signal detection, lead scoring, outreach drafts |
| 6-Agent Company | Premium | 6 coordinated agents with standup, memory, self-correction |
All templates work in Auto Mode — install multiple and they collaborate. No conflicts, no switching.
When you purchase a template, you get a single token that never expires. Every future purchase is added to the same token — no separate keys, no expiry, re-download anytime.
# Free templates — no token needed
npx seclaw add productivity-agent
# Paid templates — use your token
npx seclaw add inbox-agent --key YOUR_TOKEN
npx seclaw add research-agent --key YOUR_TOKEN # same token
npx seclaw status # Check services & installedBrowse and purchase at seclawai.com/templates.
4 Docker containers, zero inbound ports, full isolation:
| Container | Role |
|---|---|
| agent | Node.js runtime — Telegram bot, LLM, Composio, MCP client |
| inngest | Workflow engine — cron, durable execution, human-in-the-loop |
| desktop-commander | MCP server — file I/O + terminal (read_only, cap_drop: ALL) |
| cloudflared | Tunnel — outbound-only, zero open ports |
Every guardrail is enforced at the Docker runtime level — not in the system prompt.
| OpenClaw | seclaw | |
|---|---|---|
| Container isolation | None — shared env | Per-container with bridge networks |
| API key protection | All keys in every container | Env-only, sealed per service |
| Filesystem access | Entire home directory | /workspace mount only |
| Root privileges | Running as root | Non-root + cap_drop ALL |
| Permission enforcement | Prompt-based (bypassable) | Runtime guardrails (permissions.yml) |
| Network exposure | Port 5678 open to internet | Zero inbound via CF Tunnel |
| Resource limits | None (infinite) | 512MB / 1 CPU per container |
| Filesystem mutability | Full read/write | read_only: true + tmpfs |
| Setup time | 30+ minutes | 60 seconds via CLI |
16 tools built into every agent — no MCP dependency, no external services. All available via natural language in Telegram.
Every agent gets a structured workspace at /workspace:
/workspace
├── memory/ Persistent learnings about you (auto-updated)
├── tasks/ TODOs and action items with priority + due dates
├── notes/ Quick thoughts, ideas, meeting notes, links
├── reports/ Research results, summaries, daily digests
├── drafts/ Draft emails, messages, documents to review
└── config/ Schedules, templates, integrations (system-managed)
| Tool | What it does |
|---|---|
update_memory |
Save a learning about the user (name, preferences, habits) |
save_note |
Save a note to notes/ — ideas, links, meeting notes |
create_task |
Create a TODO in tasks/ with priority and optional due date |
complete_task |
Mark a task as done |
save_report |
Save a report to reports/ — research, digests, analysis |
save_draft |
Save a draft to drafts/ — emails, messages, documents |
list_files |
List files in any workspace directory |
read_file |
Read any workspace file |
| Tool | What it does |
|---|---|
send_delayed_message |
Telegram message after a delay (1-3600s) |
schedule_action |
Execute any action after a delay with full agent capabilities |
request_confirmation |
Approve / Reject buttons, execute only on approval |
create_schedule |
Create a new recurring cron schedule |
delete_schedule |
Remove a recurring schedule |
list_schedules |
List all schedules with status, cron, timezone |
toggle_schedule |
Enable/disable a schedule without deleting it |
trigger_schedule_now |
Run a scheduled task immediately |
| Tool | What it does |
|---|---|
connect_integration |
Generate OAuth link for a missing integration and share it in chat |
When an agent needs Twitter, Reddit, YouTube, or any other service — it calls connect_integration, gets an OAuth URL, and sends it to the user. No manual /integrations needed.
Powered by Composio — managed OAuth, zero raw token storage.
Gmail, Google Calendar, Google Drive, Google Sheets, GitHub, Slack, Notion, Linear, Trello, Todoist, Dropbox, WhatsApp, X (Twitter), Reddit, YouTube, Tavily, Hacker News.
npx seclaw integrations # CLI: connect/disconnect
/integrations # Telegram: inline buttonsOr let the agent handle it — when a template needs an integration, it calls connect_integration and sends you the OAuth link directly.
npx seclaw # Interactive setup wizard
npx seclaw add <template> --key TOKEN # Download a purchased template
npx seclaw templates # List installed templates & mode
npx seclaw integrations # Connect/disconnect services
npx seclaw status # Check services & health
npx seclaw doctor # Auto-diagnose & fix issues
npx seclaw stop # Stop all containers
npx seclaw upgrade # Pull latest images & restart| Command | What it does |
|---|---|
/templates |
List installed templates + switch mode (info + inline keyboard) |
/schedules |
View scheduled tasks, approve/reject pending |
/integrations |
Connect/disconnect Composio services |
| Any message | Agent responds using the right capability automatically |
Your only real cost is the LLM API. Everything else is free — Docker, Inngest, Cloudflare Tunnel, Telegram, Composio free tier.
| Usage | Model | Monthly |
|---|---|---|
| Light | Gemini 3 Flash (default) | ~$3-6/mo |
| Normal | Gemini 3 Flash | ~$5-15/mo |
| Heavy | Claude Sonnet 4.5 / Opus 4.6 | ~$30-100+/mo |
git clone https://github.com/seclaw/seclaw.git && cd seclaw
pnpm install # auto-builds CLI
npx seclaw # local version, always up-to-date| Package | Port | What |
|---|---|---|
packages/web |
8787 | Landing page (Hono + JSX + Tailwind) |
packages/api |
8788 | Token API (Hono + D1 + Stripe) |
packages/cli |
— | CLI tool (npx seclaw) |
packages/runtime |
— | Agent source (TypeScript) |
packages/templates |
— | Template source (free + paid) |
MIT
