Smart Agent

Name: Smart Agent
Rating: 3.5 (1 reviews)
Author: xinlingzhifei

By xinlingzhifei 👁 24 views ▲ 0 votes

OpenClaw smart agent runtime, plugin, and workspace skill for single-machine multi-agent orchestration.

GitHub

Install

pip install "git+https://github.com/xinlingzhifei/openclaw-smart-agent.git"

README

# OpenClaw Smart Agent

[![CI](https://github.com/xinlingzhifei/openclaw-smart-agent/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/xinlingzhifei/openclaw-smart-agent/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/xinlingzhifei/openclaw-smart-agent?display_name=tag)](https://github.com/xinlingzhifei/openclaw-smart-agent/releases)
[![License](https://img.shields.io/github/license/xinlingzhifei/openclaw-smart-agent)](https://github.com/xinlingzhifei/openclaw-smart-agent/blob/main/LICENSE)
[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/)

OpenClaw Smart Agent is a GitHub-publishable bundle for single-machine multi-agent orchestration in OpenClaw. It combines:

- a Python runtime for identity enhancement, registration, routing, monitoring, and recovery
- an OpenClaw plugin that exposes the runtime as agent tools
- a workspace skill that teaches the host agent when and how to use those tools

## What v1 includes

- Zero-configuration identity enhancement from YAML templates
- SQLite-backed agent registry and task persistence
- Smart scoring router using skills, load, and priority weighting
- Health monitoring for heartbeat timeout, CPU or memory pressure, and repeated errors
- Recovery flow that requeues work when an agent becomes unhealthy
- REST API plus CLI for local operation

## What v1 does not include

- Cross-machine distributed scheduling
- Built-in LLM inference
- Full process supervisor or container orchestration

## Architecture

```mermaid
flowchart LR
    OA["OpenClaw Host"] --> PL["Plugin Tools"]
    PL --> API["FastAPI Runtime"]
    API --> ID["Identity Enhancer"]
    API --> RG["Agent Registry"]
    API --> RT["Task Router"]
    API --> HM["Health Monitor"]
    HM --> RC["Recovery Manager"]
    RG --> DB["SQLite State Store"]
    RT --> DB
    RC --> DB
```

## Repository layout

- `src/openclaw_smart_agent/`: Python runtime package
- `plugin/`: OpenClaw plugin package and TypeScript entrypoint
- `skills/openclaw-smart-agent/`: workspace skill bundle
- `config/config.example.yaml`: sample runtime config
- `scripts/install.sh`: bootstrap script for source installs

## Install from GitHub

### Runtime only

Use this when you want the Python runtime and CLI:

```bash
python -m pip install "git+https://github.com/xinlingzhifei/openclaw-smart-agent.git"
openclaw-smart-agent init-config --output config/config.yaml
openclaw-smart-agent serve --config config/config.yaml
```

### Full bundle from a cloned repository

Use this when you also want the workspace skill and plugin package that live in the repository:

```bash
git clone https://github.com/xinlingzhifei/openclaw-smart-agent.git
cd openclaw-smart-agent
./scripts/install.sh
openclaw-smart-agent serve --config config/config.yaml
```

The install script copies the workspace skill into `${OPENCLAW_WORKSPACE:-~/.openclaw/workspace}/skills/openclaw-smart-agent`.

## OpenClaw integration

1. Start the runtime service:

```bash
openclaw-smart-agent serve --config config/config.yaml
```

2. Publish the plugin package from `plugin/` to npm or ClawHub.

3. Install that published plugin in OpenClaw.

4. Restart OpenClaw so it picks up the workspace skill from `skills/openclaw-smart-agent/`.

The plugin talks to the runtime through `http://127.0.0.1:8787` by default. Override it with `OPENCLAW_SMART_AGENT_BASE_URL`.

## API quick start

- `POST /api/v1/agents/create`
- `GET /api/v1/agents/status`
- `POST /api/v1/tasks/publish`

Example:

```bash
curl -X POST http://127.0.0.1:8787/api/v1/agents/create \
  -H "content-type: application/json" \
  -d '{"identity":"Python开发"}'
```

## Development

```bash
python -m pip install -e ".[dev]"
python -m pytest tests -q
npm --prefix plugin install --no-audit --no-fund
npm --prefix plugin run check
```

## Compatibility notes

- Verified in this repository against Python 3.14 and Node 24.
- The current OpenClaw plugin entry follows the official `openclaw.plugin.json` plus `openclaw.extensions` package metadata model.
- The PRD mentioned `skill.json`, but current OpenClaw documentation uses `SKILL.md` for workspace skills and `openclaw.plugin.json` for plugins, so this repository follows the current upstream format.

integration