@useorgx/openclaw-plugin

OrgX plugin for OpenClaw — connect your AI agents to OrgX for orchestration, quality gates, model routing, and a live dashboard.

60-Second Onboarding

1. Install the plugin.
2. Open http://127.0.0.1:18789/orgx/live.
3. Click Connect OrgX.
4. Sign in at useorgx.com and approve the connection.
5. Return to OpenClaw. The plugin stores a dedicated credential and runs first sync automatically.

Manual API key entry is still available as a permanent fallback from the onboarding panel.

Installation

openclaw plugins install @useorgx/openclaw-plugin

Or manually add to your OpenClaw config:

{
  "plugins": {
    "load": {
      "paths": ["@useorgx/openclaw-plugin"]
    },
    "entries": {
      "orgx": {
        "enabled": true,
        "config": {
          "apiKey": "oxk-your-api-key"
        }
      }
    }
  }
}

Configuration

Option	Type	Default	Description
apiKey	string	—	Your OrgX API key (get one at useorgx.com)
baseUrl	string	https://www.useorgx.com	OrgX API base URL
dashboardEnabled	boolean	true	Enable the live dashboard at /orgx/live

Features

🛠️ MCP Tools

The plugin registers these tools for your agents:

• orgx_status — Get current org status (initiatives, agents, tasks, decisions)
• orgx_sync — Bidirectional memory sync with OrgX
• orgx_spawn_check — Pre-spawn quality gate + model routing
• orgx_quality_score — Record quality scores for completed work
• orgx_create_entity — Create initiatives, tasks, decisions, etc.
• orgx_update_entity — Update entity status and fields
• orgx_list_entities — Query entities by type and status

📊 Live Dashboard

Access the OrgX command center at http://127.0.0.1:18789/orgx/live (or your gateway URL). The Vite dev server (http://localhost:5173) is only for local preview; the installed plugin runs on the OpenClaw port (18789).

Shows:

• Active initiatives with progress
• Agent status and current tasks
• Pending decisions requiring approval
• Activity stream
• Outbox replay visibility for buffered offline events

🎯 Model Routing

OrgX automatically routes tasks to the appropriate model tier:

Task Type	Model Tier	Example Models
Architecture, strategy, RFCs	opus	claude-opus-4
Implementation, code, docs	sonnet	claude-sonnet-4
Status checks, formatting	local	qwen2.5-coder

🚦 Quality Gates

Before spawning sub-agents, check the quality gate:

Agent calls orgx_spawn_check(domain: "engineering", taskId: "...")
  ↓
OrgX checks: rate limit, quality score threshold, task assignment
  ↓
Returns: { allowed: true, modelTier: "sonnet" }
  ↓
Agent spawns with recommended model

Feature Matrix

Capability	Status	Notes
Browser pairing onboarding	✅	POST /orgx/api/onboarding/start + polling flow
Manual API key fallback	✅	In onboarding gate and manual-key endpoint
Live sessions + activity + handoffs	✅	SSE with local fallback paths
Mission Control hierarchy view	✅	Initiative → workstream → milestone → task
Run control shortcuts	✅	Pause/resume/cancel/checkpoint/rollback in Session Detail
Outbox buffering + replay	✅	Local queue + auto replay on sync
Outbox observability in dashboard	✅	Pending/replay indicators in header/notifications
Plugin diagnostics (doctor)	✅	CLI + GET /orgx/api/health
Full-auto codex dispatch	✅	npm run job:dispatch with retries + rollups

CLI Commands

# Show org status
openclaw orgx status

# Manual sync
openclaw orgx sync --memory "..." --daily-log "..."

# Diagnostics (local + remote probe)
openclaw orgx doctor

# Diagnostics JSON without remote probe
openclaw orgx doctor --json --no-remote

Full-Auto Codex Dispatch Job

Reusable orchestration job to dispatch/monitor parallel codex --full-auto workers against OrgX tasks and report progress back through the reporting control plane (/api/client/live/activity + /api/client/live/changesets/apply).

export ORGX_API_KEY=oxk_...
export ORGX_USER_ID=user_...

npm run job:dispatch -- \
  --initiative_id=aa6d16dc-d450-417f-8a17-fd89bd597195 \
  --plan_file=/Users/hopeatina/Code/orgx-openclaw-plugin/docs/orgx-openclaw-launch-workstreams-plan-2026-02-14.md \
  --codex_args="--full-auto" \
  --concurrency=6

Key behavior:

• Pulls tasks from OrgX for selected workstreams
• Spawns parallel Codex workers per task
• Retries failures with backoff up to --max_attempts
• Emits activity and task status transitions into OrgX DB
• Persists resumable state to .orgx-codex-jobs/<job-id>/job-state.json

API Endpoints

When the plugin is loaded, these HTTP endpoints are available:

Endpoint	Description
GET /orgx/live	Live dashboard SPA
GET /orgx/api/status	Org status summary
GET /orgx/api/agents	Agent states
GET /orgx/api/activity	Activity feed
GET /orgx/api/initiatives	Initiative data
GET /orgx/api/health	Plugin diagnostics + outbox/sync health
GET /orgx/api/onboarding	Config/setup state
POST /orgx/api/onboarding/start	Start browser pairing flow
GET /orgx/api/onboarding/status	Poll pairing status / auto-connect
POST /orgx/api/onboarding/manual-key	Manual key validation and persist
POST /orgx/api/onboarding/disconnect	Clear local plugin credential
GET /orgx/api/live/sessions	Live session tree
GET /orgx/api/live/activity	Live activity feed
GET /orgx/api/live/stream	Live SSE stream
GET /orgx/api/handoffs	Handoff summaries

Requirements

• OpenClaw 2026.1.0 or later
• Node.js 18+
• OrgX account (browser pairing recommended, API key fallback supported)

Links

• OrgX — AI orchestration platform
• OpenClaw — Personal AI assistant framework
• OpenClaw Setup Guide
• Documentation
• GitHub

License

MIT