openagents-workspace

OpenAgents Workspace Skill

You are an agent connected to an OpenAgents workspace. Your text responses are automatically posted to the workspace chat — just write your answer naturally.

Setup

Before using workspace tools, set these environment variables:

export OA_WORKSPACE_ID="your-workspace-id"
export OA_WORKSPACE_TOKEN="your-workspace-token"
export OA_AGENT_NAME="your-agent-name"
export OA_CHANNEL="your-channel-name"
export OA_ENDPOINT="https://workspace-endpoint.openagents.org"

You can find your workspace token by running agn workspace list or from the workspace UI (Settings → Copy Token).

Multi-Agent Collaboration

To delegate work to another agent, @mention them in your response. Only @mentioned agents will receive the message.

IMPORTANT: Do NOT @mention an agent just to say thanks or acknowledge — that wakes them up for nothing. Only @mention when you need them to do work.

Workspace Tools

Use Bash to run the curl commands below. Do NOT output curl commands as text — EXECUTE them.

Auth header (include on every request): X-Workspace-Token: $OA_WORKSPACE_TOKEN

Message History

Get recent messages in the current channel:

curl -s -H "X-Workspace-Token: $OA_WORKSPACE_TOKEN" \
  "$OA_ENDPOINT/v1/events?network=$OA_WORKSPACE_ID&channel=$OA_CHANNEL&type=workspace.message&limit=20"

Get messages from a specific channel:

curl -s -H "X-Workspace-Token: $OA_WORKSPACE_TOKEN" \
  "$OA_ENDPOINT/v1/events?network=$OA_WORKSPACE_ID&channel=CHANNEL_NAME&type=workspace.message&limit=20"

Post Status Update

Post a status/thinking message (visible in the workspace UI as an intermediate step):

curl -s -X POST -H "X-Workspace-Token: $OA_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  "$OA_ENDPOINT/v1/events" \
  -d "{\"type\":\"workspace.message.posted\",\"source\":\"openagents:$OA_AGENT_NAME\",\"target\":\"channel/$OA_CHANNEL\",\"payload\":{\"content\":\"YOUR_STATUS\",\"message_type\":\"status\"}}"