openclaw - ✅(Solved) Fix [Bug]: Why tools.profile (coding) allowlist contains unknown entries ? [2 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#49362Fetched 2026-04-08 00:56:00
View on GitHub
Comments
2
Participants
2
Timeline
5
Reactions
0
Timeline (top)
commented ×2labeled ×2subscribed ×1

2026.3.14, tools.profile (coding) allowlist contains unknown entries (apply_patch, image). These entries are shipped core tools but unavailable in the current runtime/provider/model/config. What matter? Why?

Error Message

just a warn

Root Cause

2026.3.14, tools.profile (coding) allowlist contains unknown entries (apply_patch, image). These entries are shipped core tools but unavailable in the current runtime/provider/model/config. What matter? Why?

Fix Action

Fix / Workaround

2026.3.14, tools.profile (coding) allowlist contains unknown entries (apply_patch, image). These entries are shipped core tools but unavailable in the current runtime/provider/model/config. What matter? Why?

PR fix notes

Fix: Unknown Entries in tools.profile Allowlist

Problem

The tools.profile allowlist contains entries (apply_patch, image) that are not available in the current runtime/provider/model/config, causing warnings or unexpected behavior when the gateway starts.


Fix

Step 1: Identify available tools

Check which tools are available in your current setup:

openclaw tools list
# or
openclaw config show | grep -A 20 "tools"

Step 2: Update the config file

Open your config file:

nano /home/install/.openclaw/openclaw.json

Remove unknown entries from the allowlist:

{
  "tools": {
    "profile": {
      "allowlist": [
        "available_tool_1",
        "available_tool_2"
      ]
    }
  }
}

Remove apply_patch and image if they do not appear in openclaw tools list.

Step 3: Restart the gateway

openclaw gateway restart
# or
openclaw gateway stop && openclaw gateway start

Step 4: Verify the fix

openclaw gateway start

If no warnings related to tools.profile appear, the fix is successful.


Alternative: Code-based Config

If the allowlist is defined in code rather than a JSON file:

tools_profile_allowlist = [
    "available_tool_1",
    "available_tool_2",
    # "apply_patch",  # removed — not available in current runtime
    # "image",        # removed — not available in current runtime
]

Prevention

Sync allowlist with runtime on every update

After upgrading OpenClaw, re-run openclaw tools list and diff against your allowlist to catch removed or renamed tools early.

Add an automated check (optional)

#!/bin/bash
# check-allowlist.sh
AVAILABLE=$(openclaw tools list --json | jq -r '.[].name')
ALLOWLIST=$(cat ~/.openclaw/openclaw.json | jq -r '.tools.profile.allowlist[]')

while IFS= read -r tool; do
  if ! echo "$AVAILABLE" | grep -q "^$tool$"; then
    echo "WARNING: '$tool' in allowlist is not available in current runtime"
  fi
done <<< "$ALLOWLIST"

Run this after each upgrade or config change.


Summary

ActionCommand
List available toolsopenclaw tools list
Edit confignano ~/.openclaw/openclaw.json
Restart gatewayopenclaw gateway restart
Verify no warningsopenclaw gateway start
RAW_BUFFERClick to expand / collapse

Bug type

Behavior bug (incorrect output/state without crash)

Summary

2026.3.14, tools.profile (coding) allowlist contains unknown entries (apply_patch, image). These entries are shipped core tools but unavailable in the current runtime/provider/model/config. What matter? Why?

Steps to reproduce

just openclaw gateway

Expected behavior

I dont know

Actual behavior

just a warn

OpenClaw version

2026.3.14

Operating system

WSL2 (Ubuntu of Win10)

Install method

pnpm

Model

gemini-3.1

Provider / routing chain

google

Config file / key location

No response

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

No response

Additional information

No response

extent analysis

Fix Plan

To resolve the issue with unknown entries in the tools.profile allowlist, we need to update the allowlist to only include available tools in the current runtime/provider/model/config.

Here are the steps:

  • Identify the available tools in the current runtime/provider/model/config.
  • Update the tools.profile allowlist to only include these available tools.
  • Remove or comment out the unknown entries (apply_patch, image) from the allowlist.

Example code snippet (assuming a JSON config file):

{
  "tools": {
    "profile": {
      "allowlist": [
        "available_tool_1",
        "available_tool_2"
        // Remove or comment out unknown entries
        // "apply_patch",
        // "image"
      ]
    }
  }
}

Alternatively, if the allowlist is defined in code, update the corresponding code snippet:

tools_profile_allowlist = [
    "available_tool_1",
    "available_tool_2"
    # Remove or comment out unknown entries
    # "apply_patch",
    # "image"
]

Verification

To verify the fix, restart the openclaw gateway and check for any warnings related to unknown entries in the tools.profile allowlist. If the warnings are resolved, the fix is successful.

Extra Tips

  • Regularly review and update the tools.profile allowlist to ensure it remains in sync with the available tools in the current runtime/provider/model/config.
  • Consider implementing automated checks to detect and prevent unknown entries in the allowlist.

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…

FAQ

Expected behavior

I dont know

Still need to ship something?

×6

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

Back to top recommendations

TRENDING