Local-First Agentic Execution Platform
GeminiClaw is a local-first agentic execution platform with its own operational runtime, web control plane, and local governance. Built for real execution — campaign automation, operations, and complete control on your machine.
Quick Start
Get started with GeminiClaw. Clone the repository, configure your tokens and let Gemini handle the rest.
Requirements
- ›Node.js 20+
- ›npm
- ›Telegram bot token
- ›Gemini API key
Validation
Why GeminiClaw?
GeminiClaw delivers real operational execution with local-first governance. Not a chat assistant — a platform that runs autonomous loops, manages specialized agents, and operates business integrations with full audit trails.
| Capability | GeminiClaw | Generic AI Agents |
|---|---|---|
| Data & execution | Local-first — your machine, your control | Cloud — data on external servers |
| Operational governance | RBAC, Planning Gate, Risk Gate, quotas, audit trails | Limited or none |
| Google Ads automation | Native via API (10+ specialized tools) | Not included |
| Multimodal memory | Text + images + audio + documents (Gemini Embedding 2) | Text only / session context |
| Operation channel | Telegram with its own runtime and agentId isolation | Generic web chat |
Core Capabilities
GeminiClaw combines agent orchestration, secure autonomous execution, and business integrations in a single operational platform.
Agent Orchestration
Master + specialized subordinate agents. Multimodal memory with Gemini Embedding 2 that indexes text, images, audio and documents in a unified semantic space.
- ›Telegram agents with runtime isolation per agentId
- ›Intent-based tool subsets (quick_answer, execute, plan_first)
- ›Long-term memory with semantic search
Autonomous Execution with Safety
Planning Gate, Risk Gate, and Loop Guard for protection against pathological loops while preserving autonomy for sequential workloads.
- ›Mandatory approval before code mutations
- ›Control of high-impact operations
- ›Durable checkpoint/replay for recovery
Code Intelligence
GitNexus integration for impact analysis and symbol context. Grep-based fallback when the graph index is unavailable.
- ›Automatic impact analysis
- ›Structured tool registry
- ›Schema co-location
Google Ads B2B Operations
Advanced campaign automation, diagnostics, mutations, and optimizations with API-first approach — 10+ specialized tools.
- ›Campaign diagnostics and mutations via API
- ›Batch workflow optimization
- ›Offline conversion action management
Control Plane Web
Kanban for operational work, executive analytics, unified timeline, and run execution center.
- ›Full operational visibility
- ›Task-level audit
- ›Real-time execution details
Operational Governance
RBAC by chat, quotas, risk approvals, and structured audit trails via centralized Policy Engine.
- ›Role-based access control per chat
- ›Message and tool call limits
- ›Complete structured audit trails
Architecture
GeminiClaw is a single Node.js process with its own operational runtime, SQLite for local persistence, and LanceDB for vector memory. No microservices, no message brokers, no cloud dependency.
Main Components
Channels (Telegram/CLI)
Channel coordinator and bot instance
Autonomous Loop
Orchestration, tool execution, checkpointing
Tool Registry
Implementations + declarative schemas
Data Layer
SQLite + LanceDB for vector memory
Why Google Gemini?
GeminiClaw is built natively on Gemini — not as a plugin or adapter, but as the operational core of every agent loop, memory system and tool execution.
Multimodal Memory
Gemini Embedding 2 indexes text, images, audio and documents in a single semantic space — powering long-term memory across all content types.
Google Ecosystem Native
First-class Google Ads API, Workspace and Cloud integrations. No adapters, no workarounds — built for the Google stack.
Long Context + Deep Reasoning
1M+ token context window enables full codebase awareness and complex multi-step agentic reasoning without chunking.
Reliable Tool Use
Structured output and function calling form the backbone of every tool execution loop — consistent, predictable, production-ready.
Google Cloud Partnership
Autenticare is a Google Cloud partner — deep alignment means production-grade support and early access to new Gemini capabilities.
What It Supports
Native capabilities, built for real operations — not just demos.
Telegram Channel
Telegram implemented with full runtime isolation per agentId. WhatsApp support coming soon.
Operational Governance
RBAC by chat role (admin/user/blocked), quotas for messages and tool calls, structured audit trails.
Agent Hierarchy
Master + specialized subordinate agents with explicit reporting relationships and isolated memory per scope.
Scheduled Tasks
Recurring Gemini agent routines with configurable memory scopes and result delivery.
Durable Runtime
Checkpoint and replay for long-running executions. Watchdog with state-aware process recovery.
Web Access via MCP
GeminiClaw consumes external tools via MCP — web search, documentation, and browser automation.
Local-First Governance
GeminiClaw is governed through structured policies. Every tool call, code mutation, and high-impact operation goes through explicit gates with human approval when needed.
Planning Gate
Any code mutation requires explicit approval before execution
Risk Gate
High-impact tools require human confirmation before running
Full Control
Runs on your machine with your control plane and local database (SQLite)
RBAC + Quotas
Role-based access per chat (admin/user/blocked) with message and tool call limits
Stay Updated
Subscribe to get the latest updates about GeminiClaw.
Built in Brazil, for the world.
GeminiClaw is designed and maintained by Autenticare — a Brazilian AI company specialized in Google Cloud, Gemini and agentic automation for B2B operations.
