Skip to content

The Agent System

PikoClaw is not just a backend; it's part of a multi-agent system orchestrated by Geryon (OpenClaw) to handle complex tasks.

Agent Roles

1. PikoClaw (The Knowledge Extractor)

  • Role: Specialized agent for email data processing.
  • Responsibilities:
    • Parsing PST, MBOX, and EML files.
    • Building the knowledge graph of contacts and topics.
    • Redacting PII to ensure privacy.
    • Serving the extracted data via the FastAPI backend.
  • Nature: A highly specialized, non-conversational agent.

2. Geryon (The Orchestrator)

  • Role: The primary autonomous agent running locally via OpenClaw.
  • Responsibilities:
    • Receiving high-level tasks from the user.
    • Coordinating other agents (like PikoClaw and Claude) to fulfill tasks.
    • Generating code, writing documentation, and managing infrastructure.
    • Synthesizing results from multiple agents into a final response.
  • Nature: A multi-headed, autonomous, code-generating agent.

3. Claude (The Strategist)

  • Role: Cloud-based agent for strategic planning and high-level reasoning.
  • Responsibilities:
    • Providing strategic analysis for complex problems.
    • Orchestrating tasks across different platforms (e.g., GitHub, Cloudflare).
    • Summarizing large amounts of information.
  • Nature: A powerful, cloud-based reasoning engine.

Workflow Example

  1. A user uploads a PST file via the PikoClaw web UI.
  2. The PikoClaw backend processes the file, creating a knowledge graph.
  3. The user asks Geryon: "Summarize the key projects discussed in the archive and create a presentation."
  4. Geryon calls the PikoClaw API to get the main topics and contacts.
  5. Geryon passes this summary to Claude, asking it to create a strategic outline for a presentation.
  6. Geryon receives the outline from Claude and generates the Python code to create a PowerPoint presentation.
  7. Geryon returns the final presentation file to the user.