机器人AI工作流

Try the CLI built from these libraries (no install needed)

npx @robota-sdk/agent-cli

Or install globally

npm install -g @robota-sdk/agent-cli robota

**No Node.js? Install the standalone binary** (macOS / Linux / Windows — nothing else required):

What You Can Build With It

- Multi-provider agents with fallback — Anthropic, OpenAI, Google Gemini, DeepSeek, Qwen and Gemma, plus any OpenAI-compatible endpoint. FallbackProvider (agent-framework) moves a turn to another model when the primary is overloaded or failing; the CLI exposes it as --fallback-model. Providers guide - Tools with runtime validation — zod-validated function tools, plus built-in coding tools (shell, read, write, edit, glob, grep, web fetch and search). Building agents - Permissions, hooks and sandboxing — permission modes (plan, default, acceptEdits, bypassPermissions, auto), allow/ask/deny rules, lifecycle hooks, and an OS-level sandbox for shell commands (bubblewrap on Linux/WSL2, Seatbelt on macOS). Permissions and hooks - Sessions and a workspace daemon — saved, resumable and forkable sessions; background sessions that outlive the terminal; and one long-lived runtime per workspace (robota daemon start) that the desktop app and the full terminal UI (robota --attach) connect to. Sessions and daemon - MCP, both directions — connect to MCP servers (stdio or remote, including OAuth sign-in) with agent-mcp, and serve an Robota session as an MCP server with agent-transport-mcp (robota mcp serve). MCP guide - Devices and remote control — link your own devices, send messages and files between sessions, hand a session off to another device, and co-drive a session from a browser over pairing-gated peer-to-peer WebRTC. Devices and remote - Plugins and events — lifecycle plugins for conversation history, logging, usage, limits, performance, error handling, execution analytics and webhooks, on the same plugin contract you can implement yourself. Plugins guide

Quick Start — Embed the Library

The minimal set is agent-core plus one agent-provider-<vendor> package; add agent-tools when the agent calls tools. Published packages need Node.js 22.12 or later.

npm install @robota-sdk/agent-core @robota-sdk/agent-provider-anthropic

import { ConversationAgent } from '@robota-sdk/agent-core';
import { AnthropicProvider } from '@robota-sdk/agent-provider-anthropic';

const agent = new ConversationAgent({
  name: 'MyAgent',
  aiProviders: [new AnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY })],
  defaultModel: {
    provider: 'anthropic',
    model: 'claude-sonnet-4-6',
  },
  systemMessage: 'You are a helpful assistant.',
});

const response = await agent.run('Hello!');

Runtime migration and compatibility

Use the CLI coding assistant

```bash

Packages

Every package below is published on npm under @robota-sdk/, and all of them share one version. The packages index on the docs site covers each one.

Start here (embedding):

App assembly — sessions, permissions, runtime:

Multi-agent conversation — coordinate independent agents and people in a shared conversation:

Product composition — build your own product on the same runtime:

Transports and UI — put a session behind a protocol or a screen:

Contracts — type-only packages shared across layers:

Agent interface: