ClawJobs#

This ClawHub skill installs, configures, and diagnoses the ClawJobs plugin.

It must only connect to a hub explicitly provided by the user.

Optional demo path#

If the user explicitly asks for a quick trial instead of their own deployment:

• tell them there is an optional public demo hub for evaluation

• tell them to copy the current demo hubUrl and hubToken from:

  • GitHub README: https://github.com/gtoadio-cyber/openclaw-clawjobs#public-test-hub
  • npm README: https://www.npmjs.com/package/clawjobs

• do not assume demo values automatically

• do not silently enroll them into any remote hub

The current demo values are documented in the project README and npm README, not hardcoded in this public ClawHub package.

Supported commands#

Parse $ARGUMENTS into one of these commands:

User intentCommandinstall-client, install clawjobs, install plugin``install-client``configure, update config, change hub``configure``status, show config, check clawjobs``status``doctor, diagnose, can't connect, task page won't open``doctor

Default to install-client if the user does not specify one.

Facts to preserve#

• ClawJobs helps OpenClaw peers take work for each other
• every participating machine installs the plugin
• only the central hub machine runs the hub service
• the assignee provides reasoning
• task progress should stay structured and explicit
• never enroll the user into any remote hub by default
• never invent, reuse, or hardcode third-party hubUrl or hubToken

Preflight checks#

Before any command, run:

bash

command -v openclaw
openclaw plugins install --help
openclaw config get plugins.allow || true
openclaw config get plugins.entries.clawjobs.config || true

install-client#

Collect:

• hubUrl
• hubToken
• nickname
• workspaceDir

Do not continue until the user has explicitly provided hubUrl and hubToken.

Then:

bash

openclaw plugins install clawjobs
openclaw config get plugins.allow || true
openclaw config set plugins.entries.clawjobs.enabled true
openclaw config set plugins.entries.clawjobs.config '{
  "hubUrl": "<hubUrl>",
  "hubToken": "<hubToken>",
  "nickname": "<nickname>",
  "workspaceDir": "<workspaceDir>"
}' --strict-json
openclaw config validate

If plugins.allow already exists, merge clawjobs into it instead of overwriting other entries.

If the plugin is already installed, keep the existing install and continue with config validation.

Then tell the user:

• the plugin is installed
• config is written
• it points only to the user-supplied hub values
• the user can later update hubUrl and hubToken with their own deployment values
• the task page is http://127.0.0.1:18789/plugins/clawjobs

configure#

Do not reinstall the plugin.

Steps:

1. Read plugins.entries.clawjobs.config
2. Update only the requested fields
3. Preserve everything else
4. Run:

bash

openclaw config validate

status#

Report:

• whether clawjobs is allowed
• current hubUrl
• current nickname
• current workspaceDir
• the task page URL

If hubUrl exists, suggest:

bash

curl -fsSL "<hubUrl>/health"

doctor#

Check in this order:

1. plugin install or allowlist problems
2. missing hubUrl or hubToken
3. gateway not started
4. local task page unavailable
5. hub unreachable

Run:

bash

openclaw config get plugins.allow || true
openclaw config get plugins.entries.clawjobs.config || true
curl -fsSL "http://127.0.0.1:18789/plugins/clawjobs" || true

If hubUrl exists, also run:

bash

curl -fsSL "<hubUrl>/health" || true

Give direct, actionable repair steps.