Lesson 2 of 6 · 0%Assign role boundaries and inspectable handoffsNext
Course map

Multi-Agent Workflows, Goals and Production Operations

0 of 6 complete0 of 6

Lesson 2.1 · 50 minutes

Assign role boundaries and inspectable handoffs

Separate authority, workspace, and routing decisions so a multi-agent workflow does not become a shared-credential shortcut.

Skip course map
Current lessonAssign role boundaries and inspectable handoffs0% complete · 0/6 lessons

Multi-Agent Workflows, Goals and Production Operations

0% complete · Current: Assign role boundaries and inspectable handoffs

Verifiedon 2026.7.1-2

Action boundary

Before you act

Expected result
Each role has a narrow workspace, input/output contract, and authority boundary; every handoff can be reviewed without opening a private session.
Failure mode
Roles share a broad workspace or credentials, and a prose summary replaces the source artifact required to validate the handoff.
Rollback
Remove broad bindings, preserve only non-sensitive artifacts, rotate any improperly exposed credential, and recreate roles with least privilege.

Isolation is a design decision

OpenClaw documents a multi-agent setup as isolated agents with their own workspace, state directory, and session history, connected by routing bindings. A workspace is a default working directory, not automatically a hard sandbox: absolute host paths remain reachable unless sandboxing is configured. Treat that distinction as a production control, not a detail.

For the capstone, create four role cards:

Role May read May write May decide
Researcher approved public source list source ledger whether a URL meets intake format
Verifier source ledger and public sources claim-review record whether a claim is evidenced
Editor accepted claims only draft bulletin wording within the approved facts
Publication owner acceptance pack and draft approval record publish, hold, or request changes

No role receives a production publishing credential. The publication owner performs the consequential action separately after reviewing the pack.

Lab: make a handoff card

For each edge in your graph, create a card with: task ID; producer role; consumer role; input fingerprint; output location; acceptance criteria; sensitivity label; expiry/deadline; retry count; and stop/rollback action. Add a link or path to the actual artifact—not a private chat transcript.

Validation check: Give the verifier only the researcher card and output. If they cannot reproduce the accept/reject decision, the handoff is incomplete.

Anti-pattern: shared “ops” agent

A single agent with every workspace, every channel binding, and authority to publish may be convenient, but it hides separation of duties and makes incident containment expensive. Start with distinct least-privilege roles; combine them only when the evidence shows the overhead is unjustified and the authority remains explicit.

Learner artifact

Create a redacted, annotated mock of the agents list and bindings view. Highlight one isolated workspace per role, a read-only researcher route, and the absence of a publication-channel binding for all automation roles. Do not use a real account or show credentials.

Source provenanceVerification and sources

Review receipt rr_multi_agent_boundaries_handoffs

Outcome
approved
Method
source-review
Reviewer
scout-independent-review
Reviewed

Evidence

Limitations

  • Sandbox and channel bindings require operator-specific review before use.

Open the public evidence snapshot

Lesson checkpoint

Ready to move on?

Mark this lesson complete when you can apply its outcome without relying on the examples above.