Claude AI

Claude AI (Anthropic)

The robomotion claude CLI calls the Anthropic Claude API for text generation, document analysis, chat completions with history, and tool/function calling. It supports vision (image inputs), extended thinking mode, MCP server integration, and model listing.

When to use

• Generate text or chat responses with Claude models (Opus, Sonnet, Haiku)
• Analyze documents (PDF, images) using Claude's vision and Files API
• Use function calling / tool use with Claude for structured workflows
• Integrate with MCP servers for extended capabilities

Prerequisites

• robomotion CLI installed
• Package installed: robomotion install claude
• Anthropic API key configured via Robomotion vault

IMPORTANT: Session Mode Required for Multi-Step Operations

Each CLI command runs as a separate process — connection IDs from connect do NOT persist across calls. You MUST use --session on connect and pass --session-id to all subsequent commands.

Workflow

1. Install (once): robomotion install claude
2. Connect with session:

   robomotion claude connect_claude --session --output json
   # → {"outConnectionId":"<connection-id>","session_id":"<session-id>"}
   

3. Use the returned connection-id and session-id in all subsequent commands:

   robomotion claude generate_text --connection-id "<connection-id>" --system-prompt <prompt> --user-prompt <prompt> --session-id "<session-id>" --output json
   

4. Disconnect when done:

   robomotion claude disconnect_claude --connection-id "<connection-id>" --session-id "<session-id>" --output json
   

Always append --output json to get structured JSON results.

Commands Reference

• robomotion claude connect_claude --session --output json Connect to Anthropic Claude API and create a client session
• robomotion claude generate_text --connection-id --system-prompt --user-prompt --image-paths --image-paths [--model] [--custom-model] [--max-tokens] [--temperature] [--top-p] [--top-k] [--thinking-mode] [--thinking-budget] [--120] --session-id "<session-id>" --output json Generate text responses from Claude AI with optional vision capabilities
• robomotion claude generate_chat_text --connection-id --system-prompt --user-prompt --history [--model] [--custom-model] [--max-tokens] [--temperature] [--top-p] [--top-k] [--stop-sequences] [--thinking-mode] [--thinking-budget] [--120] --session-id "<session-id>" --output json Generate chat responses from Claude AI with conversation history support
• robomotion claude analyze_document --connection-id --system-prompt --user-prompt --file-paths --file-paths [--model] [--custom-model] [--max-tokens] [--temperature] [--top-p] [--top-k] [--thinking-mode] [--thinking-budget] [--300] --session-id "<session-id>" --output json Analyze documents using Claude AI with Beta Files API support
• robomotion claude call_tool --connection-id --prompt --tools --history [--model] [--custom-model] [--max-tokens] [--max-tool-rounds] [--120] --session-id "<session-id>" --output json Call tools using Claude AI function calling capabilities
• robomotion claude mcp_message --connection-id --prompt --mcp-servers [--model] [--custom-model] [--max-tokens] [--120] --session-id "<session-id>" --output json Send messages using Claude AI with Model Context Protocol (MCP) integration
• robomotion claude list_models --connection-id [--30] --session-id "<session-id>" --output json List available Claude models from the Anthropic API
• robomotion claude disconnect_claude --connection-id --session-id "<session-id>" --output json Disconnect from Claude API and release the client session

Environment

• ROBOMOTION_API_TOKEN (if vault credentials are needed)