Skip to content

[Bug]: Symbolic links for skill directories under ~/.openclaw/skills/ are not consistently resolved #49408

Description

@RayJiang4S

[Description]

When adding an OpenClaw Skill by creating a symbolic link (e.g., ln -s) linking an external folder to the ~/.openclaw/skills/ directory, the Agent fails to recognize or load the skill during session initialization.

[Steps to Reproduce]

  1. Prepare a physical skill directory: Create a valid skill folder at an arbitrary location, e.g., /Users/ray/my-custom-skill/ containing a valid SKILL.md.
  2. Create a symbolic link: Run ln -s /Users/ray/my-custom-skill/ ~/.openclaw/skills/my-custom-skill.
  3. Start/Restart OpenClaw: Observe the available skills in the startup context or via internal checks.
  4. Observation: The skill my-custom-skill is absent from the available skills list, even though the symbolic link exists and is traversable via the terminal.

[Expected Behavior]

OpenClaw should recursively resolve symbolic links within the skills/ scan path, allowing developers to manage skills in central repositories while using them via links.

[Environment]

  • OpenClaw Version: v2026.3.13
  • OS: macOS 26.3 (Apple Silicon)
  • Node.js: v25.6.1

[Additional Context]

Converting the symbolic link into a regular physical directory (cp -r) resolves the issue immediately, confirming that the loading logic specifically struggles with symlinks.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions