From agentworkforce-relay
Orchestrates headless multi-agent sessions via Agent Relay: spawns teams, creates coordination channels, manages lifecycle, runs parallel workloads across Claude/Codex/Gemini agents.
npx claudepluginhub joshuarweaver/cascade-code-general-misc-4 --plugin agentworkforce-relayThis skill uses the workspace's default tool permissions.
Run headless multi-agent sessions: start infrastructure, join a workspace, create channels, spawn teams, coordinate via messaging, and manage lifecycle.
Applies Acme Corporation brand guidelines including colors, fonts, layouts, and messaging to generated PowerPoint, Excel, and PDF documents.
Builds DCF models with sensitivity analysis, Monte Carlo simulations, and scenario planning for investment valuation and risk assessment.
Calculates profitability (ROE, margins), liquidity (current ratio), leverage, efficiency, and valuation (P/E, EV/EBITDA) ratios from financial statements in CSV, JSON, text, or Excel for investment analysis.
Run headless multi-agent sessions: start infrastructure, join a workspace, create channels, spawn teams, coordinate via messaging, and manage lifecycle.
agent-relay CLI installed (npm i -g agent-relay)rk_live_...) — get one at https://agentrelay.com/openclaw or run agent-relay up to auto-createANTHROPIC_API_KEY or claude auth login| Action | Command |
|---|---|
| Start broker | agent-relay up --workspace-key rk_live_KEY --no-spawn |
| Start broker (background) | agent-relay up --workspace-key rk_live_KEY --background --no-spawn |
| Check status | agent-relay status |
| Spawn agent | agent-relay spawn NAME CLI "task" |
| Spawn with team | agent-relay spawn NAME CLI --team TEAM "task" |
| List agents | agent-relay agents |
| View logs | agent-relay agents:logs NAME |
| Send to channel | agent-relay send '#channel' 'message' |
| Send DM | agent-relay send AGENT 'message' |
| Kill agent | agent-relay agents:kill NAME |
| Stop broker | agent-relay down |
npx -y @agent-relay/openclaw@latest setup rk_live_YOUR_KEY --name orchestrator
This registers you on the workspace and configures mcporter for channel/DM tools.
agent-relay up --workspace-key rk_live_YOUR_KEY --no-spawn
Critical: Pass --workspace-key so spawned agents inherit the workspace connection. Without it, agents can't communicate via Relaycast channels.
mcporter call relaycast create_channel name=my-project topic="Project coordination"
mcporter call relaycast join_channel channel=my-project
agent-relay spawn architect claude --team my-team "Your task..."
agent-relay spawn developer claude --team my-team "Your task..."
agent-relay spawn tester claude --team my-team "Your task..."
Spawned agents communicate through the broker's workspace connection.
# Post to channel
agent-relay send '#channel-name' 'your message'
# DM another agent
agent-relay send agent-name 'your message'
# Check inbox
agent-relay inbox
mcporter call relaycast post_message channel=my-project text="Status update"
mcporter call relaycast get_messages channel=my-project limit=20
mcporter call relaycast send_dm to=architect text="Review the design"
| CLI | Use For | Notes |
|---|---|---|
claude | Most reliable for coding tasks | --print --permission-mode bypassPermissions under the hood |
droid | OpenCode-based, needs PTY | Don't use --cwd flag (broker can't auto-accept permission prompts — see PR #570) |
gemini | Google models | Use gemini-2.5-pro (not preview) for stability |
codex | OpenAI Codex | Requires PTY |
Include communication instructions in every agent's task:
You are ROLE on the TEAM team.
## Communication
Post updates to #channel: agent-relay send '#channel' 'your message'
Check for messages: agent-relay inbox
DM a teammate: agent-relay send teammate-name 'message'
## Your Team
- agent-a (role) — does X
- agent-b (role) — does Y
## Tasks
1. ...
2. Post progress to #channel
3. When done: openclaw system event --text 'Done: description' --mode now
# Check all agents
agent-relay agents
# Tail an agent's output
agent-relay agents:logs NAME -n 500
# Check channel conversation
mcporter call relaycast get_messages channel=my-project limit=20
# Check who's online
mcporter call relaycast list_agents status=online
# Kill a stuck agent
agent-relay agents:kill NAME
# Kill all agents in a team
agent-relay agents | grep TEAM | awk '{print $1}' | xargs -I{} agent-relay agents:kill {}
# Stop everything
agent-relay down
registerOrRotate pattern: on 409, rotates the agent tokenSpawn agent A → wait for completion → spawn agent B with A's output.
Spawn N agents simultaneously, each on a subtask. Monitor via channel. Collect results.
All agents join same channel, post updates, read each other's work on a shared git branch.
| Issue | Fix |
|---|---|
| Agents can't message | Broker must have --workspace-key |
| Droid stuck at approval | Don't use --cwd with droid agents |
| Agent name conflict (409) | Use unique names or let SDK registerOrRotate handle it |
| Channel not found | Create it first via mcporter call relaycast create_channel |
| Agent idle but no output | Check agent-relay agents:logs NAME for errors |
| npx setup fails in spawned agent | Agents inherit broker's workspace — no setup needed |
agent-relay send fails for DM | Spawned agents can broadcast to channels but DMs may not work for non-Relaycast-registered agents |