OneRingAI is production-ready. Registry v2, current model APIs, realtime voice, and a stable connector-first foundation. See what's included

Icon Icon Icon Icon Icon Icon Icon Icon Icon Icon
Stable release • Node.js 22+

One TypeScript Library for AI Agents, Realtime Voice Every Modality Production Workflows

A stable connector-first API for current OpenAI, Anthropic, Google, and xAI models across text, images, video, embeddings, speech, and live voice.

npm i @everworker/oneringai
icon icon Connector-first agents
icon icon Registry v2 model intelligence
icon icon Realtime voice and media
MODELS

Current vendor APIs

GPT-5.6, Claude 5, Gemini 3.6, Grok 4.5, and lifecycle-aware aliases.

REALTIME

Live voice agents

OpenAI Realtime and xAI Voice Agent with provider-specific session types, WebSocket, WebRTC credentials, tools, correct VAD, and SIP control.

MEDIA

Images, video, and audio

GPT Image 2, Gemini native image, Veo/Omni, Grok Imagine, raw telephony STT, TTS, and multimodal embeddings.

PRODUCTION

Agents that hold up

Connectors, permissions, memory, tools, orchestration, resilience, storage, and MCP in one package.

Production foundation

What's inside OneRingAI

A stable public foundation and a complete refresh of the first-party OpenAI, Anthropic, Google, and xAI APIs.

Registry schema v2

88 text and realtime records plus dedicated image, video, TTS, STT, and embedding registries. Every registry understands lifecycle, aliases, snapshots, endpoints, replacements, preferred choices, official sources, and richer pricing.

Realtime voice, fully supported

Build OpenAI Realtime and xAI Voice Agent experiences with typed events, tools, provider-correct VAD, credentials, transcription, translation, SIP, and resumption. OpenAI PCM is fixed at 24 kHz; xAI's typed session supports 8 to 48 kHz.

Current multimodal APIs

Use current text, image, video, speech, and embedding models—including status-safe Gemini Interactions streams, strict named tools, bounded external media, content-aware MIME detection, response-accurate xAI TTS formats, Omni video, and multichannel STT.

Deliberate major-version contract

Node.js 22+, current vendor SDKs, nullable unknown token limits, lifecycle-aware availability, alias lookup helpers, stored Google Interactions, and model-gated GPT-5.6 explicit cache breakpoints.

A first-class subsystem

Memory that understands relationships, not just messages

OneRingAI includes a standalone entity-and-fact memory system with graph traversal, vector embeddings, ranked recall, document search, signal ingestion, evolving profiles, and production-grade permissions.

Graph-native knowledgePeople, organizations, tasks, events, documents, and typed relationships with provenance.
Vector + ranked retrievalSemantic search, N-hop traversal, confidence, recency, importance, and as-of queries.
Learns from signalsTurn text, email, calendars, or conversations into resolved entities, facts, and profiles.
Standalone or agent-readyUse MemorySystem directly or add safe read/write tools and context injection to any agent.
KNOWLEDGE GRAPH entities · facts · embeddings
Example OneRingAI memory graph A person connected to an organization, priority, event, and document through typed facts. works_at tracks_priority attended has_document PERSON Alice Chen ORGANIZATION Acme PRIORITY Ship Launch EVENT Q3 Planning DOCUMENT Launch Brief
memory_search({ query: "What matters for the launch?" }) → ranked facts + related entities
Mongo + Atlas bitemporal principal ACLs 6 read + 6 write tools
Built with OneRingAI

Meet AMOS, your terminal AI agent

AMOS is the working CLI application inside the OneRingAI repository. It shows how connectors, agents, tools, permissions, context, and persistence fit together in a useful product—not just an isolated snippet.

Switch providers liveChange connector, vendor, or model without rewriting agent logic.
Code with guardrailsUse filesystem and shell tools with explicit execution permissions.
Research the webSearch through Serper and scrape pages through ZenRows connectors.
Keep your placeInspect context usage, then save and resume working sessions.
amos — terminal agent
$ cd apps/amos
$ npm run dev
AMOS ready · connector: openai-main

/prompt use coding-agent
Prompt switched to coding-agent
/external setup search
Serper search connected
/context budget
Context healthy · tools ready
/session save launch-research
Session saved
AMOS running in a terminal with the OpenAI connector and coding-agent prompt
AMOS running from apps/amos with an OpenAI connector. Open the screenshot to view it full size.

50 authentication templates, generic authenticated API access for every configured service, and specialized tool bundles for selected connectors

Google Google
GitHub GitHub
Discord Discord
Stripe Stripe
Notion Notion
HubSpot HubSpot
Jira Jira
Shopify Shopify
Telegram Telegram
Dropbox Dropbox
GitLab GitLab
Mailchimp Mailchimp
PayPal PayPal
Airtable Airtable
Sentry Sentry
Confluence Confluence
Intercom Intercom
Linear Linear
Datadog Datadog
Asana Asana
Trello Trello
Bitbucket Bitbucket
QuickBooks QuickBooks
Zendesk Zendesk
PagerDuty PagerDuty
Box Box
Brave Search Brave
Google Cloud Google Cloud
Google Drive Google Drive
RapidAPI RapidAPI
man-trigger appostrof
OneRingAI Feature Highlights

Production AI agents, every vendor and modality

Node.js 22+, strict TypeScript, connector-first authentication, unified inference APIs, and production agent infrastructure in one package.

feature-icon

Current multi-vendor APIs

OpenAI, Anthropic, Google, xAI, and more across text, image, video, embeddings, TTS, STT, and realtime voice—with one coherent API.

feature-icon

Plugin-first context and memory

Feature-flagged plugins assemble instructions, state, tools, persisted stores, compaction, and self-learning graph memory into one token-budgeted context. Context guide

feature-icon

Connectors for every system

Start from 50 authentication templates. Every configured service gets generic authenticated API access; selected services add specialized tool bundles. Connector catalog

feature-icon

Tools, permissions, and orchestration

Start with 39 connector-free tools in eight categories, then add connector, context-plugin, memory, orchestrator, and MCP tools dynamically. Tool catalog

feature-icon

Clean Architecture

The library is built on clean architecture principles, which makes building your own app as easy as configuring your infrastructure layer, and maintainability is a breeze.

feature-icon

Enterprise grade quality you can trust

The library is the core of Everworker.ai enterprise agentic platform, so is battle proven in its quality and resilience.

OneRingAI vs LangChain vs CrewAI

Wondering which library to choose? OneRingAI is lighter, fuller, straightforward and 100% typescript nodejs.

Comparison

OneRingAI vs LangChain vs CrewAI vs OpenClaw

Feature Comparison — reviewed August 2026

OneRingAI is a unified TypeScript agent library (~109K LOC, 20 deps) that replaces the sprawling ecosystems of LangChain/LangGraph (200K+ LOC, 15+ packages) and the Python-only CrewAI (~100K LOC, 33 deps) — with a connector-first architecture that treats authentication, security, resilience, and multi-vendor support as first-class primitives rather than afterthoughts.

About OpenClaw: OpenClaw (~355K GitHub stars) is a self-hosted personal AI assistant platform for messaging channels (WhatsApp, Slack, Telegram, etc.), not a developer SDK. It is included here for architectural comparison, but serves a fundamentally different use case.

1. Architecture Philosophy

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Core paradigm Connector-first (auth registry → agent → provider) Runnable composition (LCEL) → Graph nodes Role-based agent crews + event-driven flows Gateway → channels → skills
Language TypeScript (strict) TypeScript (primary), Python (separate repo) Python only TypeScript
LOC / Deps ~109K LOC / 20 deps ~200K+ LOC / 15+ packages ~100K LOC / 33 deps ~300K+ LOC / extensions
Type Developer SDK / library Developer SDK / framework Developer framework Self-hosted product
Setup surface Single Agent.create() entry point Models, agents, middleware, tools, and LangGraph primitives Role/goal/backstory agents, tasks, crews, and flows Install, configure channels, and run
OneRingAI's advantage: A compact, single-package TypeScript surface keeps the common path at Connector → Agent → Provider. Runtime performance depends on the workload and provider, so benchmark your own use case rather than relying on framework-wide percentage claims.

2. Multi-Vendor LLM Support

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Vendors 12 native (OpenAI, Anthropic, Google, Vertex, Groq, Together, Perplexity, Grok, DeepSeek, Mistral, Ollama, Custom) 36+ via dedicated @langchain/* packages 6 native + LiteLLM fallback for 20+ 30+ via extensions
Model registry Registry schema v2: 88 text/realtime records with lifecycle, aliases, endpoints, official sources, pricing, and capability metadata No centralized registry 100+ models mapped for context windows No registry
Cost calculation calculateCost(model, in, out) → exact USD Third-party (LangSmith) No built-in No built-in
Multi-key per vendor Named connectors: openai-main, openai-backup Not native Not native Auth profile rotation with failover
Vendor switching Change connector and model; prompts, tools, memory, and agent logic stay unchanged Change model integration and provider-specific config Change LLM/model config Change extension config
Thinking / reasoning Vendor-agnostic config — maps to Anthropic budgets, OpenAI effort, Google thinkingLevel Per-provider configuration No unified abstraction Per-provider
Why OneRingAI wins: Native vendor support with typed model registry and built-in cost tracking. Named connectors allow multi-key setups (prod/backup/dev). Vendor-agnostic thinking/reasoning config — write once, run on any provider.

3. Authentication & Connector System

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Auth model Centralized Connector registry (single source of truth) Credentials configured per model or tool integration; no shared connector registry equivalent Credentials configured per model or tool integration, commonly through environment or config Auth profiles per extension
OAuth 2.0 Built-in OAuth flows, AES-256-GCM encrypted storage, refresh-strategy enforcement, and 50 vendor templates No framework-level multi-service OAuth registry No framework-level multi-service OAuth registry Extension-specific authentication
Multi-user isolation userId + accountId scoping, connector allowlist per agent Implemented by the host application Managed team controls in CrewAI Enterprise; application scoping remains host-defined in OSS Designed around a single-user trust boundary
External API tools ConnectorTools.for('work-github') adds generic authenticated API access plus GitHub's specialized bundle. The catalog covers 50 auth templates, selected specialized bundles, and custom services. Community tool packages Via Composio (external) 5,400+ skills on ClawHub
OneRingAI's advantage: The Connector API combines provider credentials, multi-service OAuth, encrypted storage, multi-user scoping, and per-connector resilience behind one typed registry. Other frameworks generally configure credentials at the model, tool, extension, or host-application layer.

4. Security & Permissions

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Permission system 3-tier: user rules → delegation hierarchy → 8-policy chain Guardrails and middleware; no equivalent 3-tier permission-policy manager Task guardrails and human feedback; RBAC is part of CrewAI Enterprise Tool policy pipeline with exec approvals
Tool-level scoping Per-tool: always / session / once / never Human-in-the-loop middleware can gate selected tools Human feedback can gate workflow steps Exec approval per command
Built-in policies Allowlist, Blocklist, RateLimit, PathRestriction, BashFilter, SessionApproval, Role, UrlAllowlist PII detection, human-in-the-loop, model/tool call limits, and custom middleware Task guardrails, callbacks, and human feedback Tool allow/deny policy, sandboxing, and exec approvals
Circuit breakers Per-tool + per-provider (configurable thresholds) None None None
Audit trail Event-based: permission:allow, permission:deny, permission:audit LangSmith tracing or custom logging middleware Event listeners in OSS; managed traces in CrewAI Enterprise Mutation tracking and approval events
OneRingAI's advantage: Its security controls are packaged as a cohesive library layer: 3-tier permission evaluation, 8 policy types, per-tool circuit breakers, rate limiting, and bash filtering. LangChain, CrewAI, and OpenClaw also provide guardrails or approval controls, but with different scopes and deployment models.

5. Context Management

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Architecture Plugin-first AgentContextNextGen with working/in-context state, self-learning memory, background ingestion, tool catalog, and shared workspaces Short-term (state) + Long-term (Store API) + Legacy (Buffer/Summary) Unified Memory with scoped storage + Knowledge (RAG) Plugin-based context engine
Compaction Algorithmic (75% threshold), tool pairs removed together, pluggable strategies Message filtering / summarization Auto-summarization at token limits Built-in compaction
Token budgeting Per-plugin token tracking with detailed ContextBudget breakdown No native budget API Context window management (85% safety ratio) Provider-based
In-Context Memory Data stored DIRECTLY in prompt — LLM sees values immediately, priority-based eviction Not available Not available Not available
Long-term memory Entity/fact memory graph with semantic search, profiles, behavior rules, permissions, and optional background extraction Store API (namespace-based, cross-session) Deep recall with LLM analysis, composite scoring Wiki + knowledge plugins
Context plugins Feature-flagged built-ins + custom IContextPluginNextGen and IStoreHandler APIs No plugin system Not extensible Extensible via plugins
OneRingAI's advantage: Its plugin-based context system keeps frequently accessed InContextMemory directly in the prompt, with per-plugin token budgets for an exact breakdown. Custom plugins and store handlers use the same lifecycle.

6. Tool System

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Built-in tools 39 connector-free generated tools across 8 categories. Connector, context-plugin, memory, orchestrator, and MCP tools are discovered dynamically. 50+ via integrations 70+ via crewai-tools 60 bundled + 5,400 on ClawHub
Per-tool circuit breakers Yes — independent failure protection per tool No No No
Permission system 3-tier policy chain with 8 policies No built-in No built-in Exec approval pipeline
Desktop automation 11 tools (screenshot, mouse, keyboard, window) with multimodal images Not built-in Not built-in Not built-in
Custom tools Meta-tools: agent creates its own tools at runtime (save, load, draft, test) tool() function + Zod schema BaseTool class or @tool decorator Skills + plugins
Tool metrics Usage count, latency, success rate — no SaaS required LangSmith tracing has a free developer allocation and paid higher-volume tiers Managed observability is available in CrewAI Enterprise Local logs and events
Why OneRingAI wins: Per-tool circuit breakers mean one flaky API doesn't take down your agent. Desktop automation (computer use) is built-in. Meta-tools let agents create their own tools at runtime.

7. Multi-Agent Orchestration

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Orchestration model createOrchestrator() with 3 routing modes: DIRECT / DELEGATE / ORCHESTRATE LangGraph: stateful graphs with conditional edges Crew (sequential/hierarchical) + Flow (event-driven DAGs) Subagent spawning + registry
Communication SharedWorkspace (versioned, append-only log) + agent.inject() State passing via graph edges with reducers Task context chaining + Flow state Session-based messages
Planning phase UNDERSTAND → PLAN → APPROVE → EXECUTE → REPORT Custom via graph design Built-in planning=True Not available
Patterns Routing-based (direct, delegated, orchestrated) Supervisor, Swarm, Hierarchical, Pipeline Sequential, Hierarchical Flat subagent tree
Cross-framework Not yet Not yet A2A protocol (first-mover) ACP protocol
OneRingAI's advantage: Three routing modes combine direct assignment, interactive delegation with monitoring, and a structured planning phase. SharedWorkspace gives agents a versioned bulletin board for coordination.

8. Multi-Modal Support

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Image generation Built-in (GPT Image 2, Gemini 3.1 native generation/editing with normalized sizes and multi-image requests, Imagen, Grok Imagine) Via community packages DALL-E tool via crewai-tools Via skills/extensions
Video generation Built-in (Sora 2 with lifecycle metadata, Veo/Omni, Grok Imagine Video 1.5) Not native Not supported Not built-in
TTS / STT Built-in OpenAI, Google, and xAI TTS/STT, response-accurate xAI audio formats, raw 8 kHz telephony, normalized Gemini timestamps, multichannel xAI STT, strict 24 kHz OpenAI Realtime, and typed 8–48 kHz xAI Voice Agent sessions Community packages Not supported Via extensions
Model registries Dedicated registries: 19 image, 9 video, 7 TTS, 11 STT, and 12 embedding records with schema-v2 metadata No registries No registries No registries
Why OneRingAI wins: A complete multimodal pipeline in one library — text, images, video, embeddings, TTS, STT, and realtime speech-to-speech with typed lifecycle-aware registries.

9. MCP (Model Context Protocol)

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
MCP support Native: stdio + HTTP/HTTPS, auto-reconnect, health checks, resource & prompt support @langchain/mcp-adapters v1.1.0 (stdio + HTTP + SSE) Native: stdio + HTTP + SSE, retry with backoff Via mcporter bridge
Registry pattern MCPRegistry.create() / MCPRegistry.get() for managing multiple servers MultiServerMCPClient MCPServerConfig on agent Not native
Health monitoring Periodic ping, connect/disconnect/error events Configurable reconnection Retry with exponential backoff Not built-in
Why OneRingAI wins: First-class MCP integration with a registry pattern, health monitoring, and auto-reconnect for managing multiple servers.

10. Enterprise & Production Readiness

Feature OneRingAI LangChain / LangGraph CrewAI OpenClaw
Resilience Circuit breakers (per-connector + per-tool), retry w/ backoff + jitter, rate limiting Basic retries; no circuit breakers Basic retry; no circuit breakers Provider failover
Multi-tenant userId scoping, connector allowlist, OAuth token isolation, StorageContext Namespace-based primitives; application isolation is host-defined Team/RBAC controls in CrewAI Enterprise; application isolation is host-defined in OSS Designed around a single-user trust boundary
Observability Logger + Metrics + EventEmitter — no SaaS required LangSmith tracing has a free developer allocation and paid higher-volume tiers Event listeners in OSS; managed tracing in CrewAI Enterprise Event bus
API stability Semantic versioning, TypeScript strict mode Frequent breaking changes Memory system rewritten; some API churn CalVer (daily releases)
Tests 6,381 unit tests across 284 files, plus 21 authenticated live API checks Vitest matchers (recently added) Comprehensive pytest suite Community testing

11. Summary: Why OneRingAI

Dimension OneRingAI Advantage vs LangChain vs CrewAI vs OpenClaw
Auth Connector-first architecture with built-in multi-service OAuth 2.0 Credentials per model/tool integration Credentials per model/tool integration Auth profiles per extension
Security 3-tier permission system with 8 policy types Guardrails, middleware, and HITL; no equivalent permission manager Guardrails and human feedback; managed RBAC in Enterprise Tool policy, sandbox, and exec approvals
Resilience Built-in per-tool circuit breakers + rate limiting Retries/fallback middleware; no equivalent per-tool circuit breaker Retries and callbacks; no equivalent per-tool circuit breaker Provider failover and execution policy
Context Plugin-based context + InContextMemory + per-plugin token budgets Split memory systems Good Memory, no plugin system Not developer-accessible
Multi-modal Single library: text + image + video + TTS + STT Requires community packages Minimal support Via extensions only
Desktop Built-in computer use (11 tools) Not built-in Not built-in Not built-in
TypeScript Full strict mode type safety TS but heavy abstraction layers Python-only TS but not a developer SDK
Enterprise Multi-tenant primitives, permissions, hooks — built into the library, no SaaS required LangSmith offers a free developer trace allocation; paid tiers add scale and team features Managed deployment, observability, and RBAC are available in CrewAI Enterprise Self-hosted and designed around a single-user trust boundary

OneRingAI is a stable, connector-first TypeScript foundation for production agents: current vendor APIs, lifecycle-aware model registries, auth, security, resilience, multimodal inference, realtime voice, orchestration, tools, and context management in one package. No paid SaaS required.

Sources and scope — last checked 9 August 2026. OneRingAI facts are based on the current source and release documentation. Competitor capabilities were checked against primary documentation:

LangChain models, middleware, guardrails, and LangSmith billing; CrewAI OSS documentation and CrewAI Enterprise; OpenClaw tools and exec approvals. Counts, prices, and managed-product limits change frequently; verify them before quoting.