council-blackboard
Visible OpenClaw–Open WebUI council rooms with typed blackboards and session handovers.
Council blackboard
Use when the user asks OpenClaw and an Open WebUI model to confer, compare approaches, review one another, or form a multi-model council.
Rules
- Create a fresh board and Open WebUI room for every new council:
python skills/council-blackboard/scripts/council.py room --topic "..." --user-id USER_ID - Give the user the returned
chat_urlimmediately. The WebUI room is the visible transcript; the JSON board is the auditable source of truth. - Validate before every hop. Read the goal, typed entries, revision, next capability, and unresolved questions.
- Do one bounded contribution per hop. Never rewrite another writer's entry.
- Record observations as facts, conclusions as inferences, user choices as user_decisions, and checks as evidence/test_results.
- The Open WebUI model uses the attached
Council Blackboardtool to read the board, contribute, and call an isolated OpenClaw council session. - A council handover must name the board path, WebUI chat ID/URL, current revision, decisions, unresolved questions, next capability, and receipt locators. Do not dump private memory into the room.
- The user may join either side at any time. Treat the newest authenticated user contribution as authoritative user context; preserve it as a user decision when it changes scope or constraints.
- Stop on
needs_user, a safety boundary, a failed board validation, or exhausted hops. - Completion still needs independent verification under the blackboard policy.
Configuration
The scripts default to ~/.openclaw/workspace and can be configured through environment variables rather than hard-coded machine paths.
Useful variables include:
OPENCLAW_WORKSPACEOPENWEBUI_BASE_URLOPENWEBUI_DBCOUNCIL_BLACKBOARD_SCRIPTCOUNCIL_ROOM_SCRIPTCOUNCIL_WEBUI_MODELCOUNCIL_WEBUI_MODEL_NAMECOUNCIL_OPENCLAW_MODELCOUNCIL_OPENCLAW_AGENTCOUNCIL_USER_WRITER
OpenClaw to WebUI
Create the room before models confer. Use council.py room; then work from the returned board. The browser-visible URL is derived from OPENWEBUI_BASE_URL and the created chat ID.
WebUI to OpenClaw
The WebUI model calls consult_openclaw with a bounded question and its current position. The tool appends the WebUI contribution, routes the board, invokes a dedicated OpenClaw session key, and returns the OpenClaw reply into the visible WebUI chat.
Handover
Use handover when switching lead model or pausing. Keep it operational and short: outcome, constraints, decisions, evidence, failures, open questions, exact next action.
- Downloads
- Security audit
- Review
- Last updated
- 3mo ago
- Current version
- v0.1.0
- License
- MIT-0
