OrchardOS#

OrchardOS is an OpenClaw plugin that gives your agents a persistent task board. Create projects, add tasks, and let the built-in queue runner dispatch them as subagents automatically.

Install#

bash

openclaw plugins install clawhub:openclaw-orchard
openclaw gateway restart

Configure (optional)#

Orchard works after install with the plugin entry enabled. If you want to tune models, limits, database path, or queue cadence, configure the orchard plugin entry in openclaw.json.

Common options:

• dbPath
• roles.executor.model
• roles.architect.enabled
• limits.maxConcurrentExecutors
• queueIntervalMs

Agent tools#

Available in every agent session after install:

ToolDescriptionorchard_project_createCreate a new projectorchard_project_listList all projectsorchard_task_addAdd a task to a projectorchard_task_listList tasks (filter by project, status)orchard_task_doneMark a task done with a summaryorchard_task_blockMark a task blocked with a reasonorchard_task_commentAdd a comment to a taskorchard_wakeTrigger the queue runner immediately

REST API#

Main gateway API routes use the normal OpenClaw bearer-token auth model.

MethodPathDescriptionGET/POST/orchard/projectsList / create projectsGET/POST/orchard/projects/:id/tasksList / add tasksGET/PUT/orchard/tasks/:idGet / update taskPOST/orchard/tasks/:id/commentsAdd commentGET/orchard/tasks/:id/runsRun historyPOST/orchard/wakeTrigger queue runnerGET/orchard/uiWeb dashboard

How it works#

1. Create a project with a goal
2. Add tasks ( ready status) via tools, API, or dashboard
3. Queue runner polls every 5 minutes (configurable), dispatches ready tasks as subagents
4. Executors use orchard_task_done / orchard_task_block to report back
5. Architect wakes when queue is empty to generate new tasks toward the project goal