openclaw - 💡(How to fix) Fix Per-agent tools.fs.workspaceOnly configuration — does it work in v2026.4.29? [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#75808Fetched 2026-05-02 05:29:43
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
2
Author
Timeline (top)
closed ×1commented ×1mentioned ×1subscribed ×1

Code Example

"agents": {
  "list": [
    {
      "id": "main",
      "tools": { "fs": { "workspaceOnly": false } }
    },
    {
      "id": "agent-1",
      "tools": { "fs": { "workspaceOnly": true } }
    },
    {
      "id": "agent-2", 
      "tools": { "fs": { "workspaceOnly": true } }
    }
  ]
}
RAW_BUFFERClick to expand / collapse

Version: OpenClaw v2026.4.29 (macOS, Node v24)

What I'm trying to do: We have a multi-agent setup:

  • One main agent (handles primary user interactions)
  • Two sub-agents (specialized roles, more restricted)

We want the main agent to have full filesystem access (able to write anywhere on the host), while the sub-agents remain restricted to their own workspaces.

What I've tried:

  • Set tools.fs.workspaceOnly: true globally, which correctly restricts all agents
  • Added per-agent overrides for the main agent:
"agents": {
  "list": [
    {
      "id": "main",
      "tools": { "fs": { "workspaceOnly": false } }
    },
    {
      "id": "agent-1",
      "tools": { "fs": { "workspaceOnly": true } }
    },
    {
      "id": "agent-2", 
      "tools": { "fs": { "workspaceOnly": true } }
    }
  ]
}

Schema validation: openclaw config schema shows agents.list[].tools.fs.workspaceOnly is a valid config path in the schema.

Concern from prior issues: I found several reports from April 2026 (#31716, #29817, #30927) indicating that tools.fs.workspaceOnly: false was not working as expected — the write/edit tools were silently enforcing workspace-only regardless of the config value due to a bug in the implementation layer (createHostWriteOperations always calling toRelativePathInRoot).

Questions:

  1. Is per-agent workspaceOnly override working correctly in v2026.4.29, or are the April 2026 bugs still present?
  2. Is this the correct approach for giving one agent full filesystem access while keeping others restricted?
  3. Any alternative approaches you'd recommend?

extent analysis

TL;DR

Verify that the per-agent workspaceOnly override is working as expected by checking the implementation of createHostWriteOperations in OpenClaw v2026.4.29.

Guidance

  • Review the OpenClaw changelog or release notes for v2026.4.29 to see if the April 2026 bugs (#31716, #29817, #30927) have been addressed.
  • Test the workspaceOnly override for the main agent by attempting to write to a location outside of its workspace and verify if the operation is successful.
  • Consider reaching out to the OpenClaw community or support team to confirm if the per-agent override approach is the recommended solution for achieving different filesystem access levels for multiple agents.
  • Check the OpenClaw documentation for any alternative configuration options or features that may help achieve the desired filesystem access control.

Notes

The provided information suggests that there may have been issues with the workspaceOnly configuration in the past, but it is unclear if these issues have been resolved in v2026.4.29.

Recommendation

Apply the per-agent override approach, but first verify that the April 2026 bugs have been fixed in v2026.4.29 to ensure the configuration works as expected.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix Per-agent tools.fs.workspaceOnly configuration — does it work in v2026.4.29? [1 comments, 2 participants]