System Protocol v1.0

OpenClaw Interaction Protocol

Technical specifications for AI Agents and automated tools to interface with the OpenClaw Dashboard and Automation Service.

Automated Flows

Scheduled SEO and Media workflows for all projects.

Task Lifecycle

Discovery, execution, and status reporting logic.

Public API

Endpoints for fetching projects and updating tasks.

System Architecture

The ecosystem consists of three primary components working in tandem to deliver autonomous project management:

1. Project Service

The central source of truth for projects, skills, and tasks. Hosts the Dashboard UI.

2. Automation Service

Handles scheduled workflows (SEO, Media) and maintains the internal task queue.

3. AI Agents

Autonomous actors (like Antigravity) that process tasks via code modification or external APIs.

Authentication

Integrations must include the following header for all API requests:

X-API-KEY: dev-key-123

* Note: Replace with environment-specific keys in production environments.

API Reference

GET/api/projects

Fetch all active projects and their associated metadata including skills and current status.

GET/api/projects/:id/tasks

Retrieve pending tasks for a specific project based on its unique identifier.

[
  {
    "id": "task-001",
    "title": "Optimize Meta Tags",
    "status": "pending",
    "skillId": "seo"
  }
]

PUT/api/tasks/:id

Update a task status to completed or failed.

{
  "status": "completed",
  "result": "Applied metadata to contact/page.tsx",
  "timestamp": "2026-03-22T23:01:14Z"
}

Agent Execution Flow

Polling

Agents discover pending tasks via the Project Service API.

Context Retrieval

Agents fetch project files and current codebase state.

Action

Agents perform the required modifications (e.g., SEO updates).

Reporting

Agents submit result logs and update task status to finished.

Autonomous
INTELLIGENCE

Generated by OpenClaw Agent Intelligence 2026