Skip to content

Carry the MCP connection timeout in the published setup - #5

Merged
TheDesignFounder merged 1 commit into
mainfrom
fix/openclaw-cold-start-20260925
Sep 25, 2026
Merged

TheDesignFounder merged 1 commit into
mainfrom
fix/openclaw-cold-start-20260925

Conversation

@TheDesignFounder

Copy link
Copy Markdown
Owner

What broke

A clean OpenClaw host install on 2026-09-25 failed its first MCP probe with MCP server "dreamlayer" timed out: did not complete initialize within 5s. The cause is a cold start, not DreamLayer: npx -y @dreamlayer/mcp@0.4.0-beta.4 took about 50 seconds on an empty npm cache, and OpenClaw's default MCP connect timeout is 5 seconds. The run that succeeded used connectionTimeoutMs: 90000, but the published skill never showed it, so every new user would hit the same wall.

Changes

  • clawhub/dreamlayer-image-workflows/SKILL.md: the MCP config now carries "connectionTimeoutMs": 90000, and the paragraph beneath it states the measured cold-start time, OpenClaw's default, and the two ways out: raise the host's timeout, or npm i -g the package first.
  • docs/hermes-setup.md: same config, with a host-neutral version of the note.
  • docs/client-setup.md: a new OpenClaw section with the exact install, key and mcp add --connect-timeout 90 commands.
  • Frontmatter version moves from 1.0.0 to 1.0.2. ClawHub already served 1.0.1, so the repository was misleading anyone who read it; this publishes 1.0.2 deliberately and names it.
  • One stale line in docs/client-setup.md told readers beta.3 was the working version. It now refers to the current beta instead of a superseded one.

Validation

  • python3 scripts/validate.py passes.
  • The skill's JSON block parses and asserts connectionTimeoutMs == 90000 with the current pin.
  • A clean OpenClaw host install is repeated with the published config after merge; evidence lands in research/.

No claim about Unity changes here, and no account, credit or purchase is involved.

🤖 Generated with Claude Code

A clean OpenClaw host install on 2026-09-25 failed its first MCP probe. The cause
was not DreamLayer: `npx -y @dreamlayer/mcp@0.4.0-beta.4` took about 50 seconds on
a cold npm cache while OpenClaw waits 5 seconds by default and reports the server
as failed. The successful run used connectionTimeoutMs 90000, and the published
skill did not show it, so every new user hit the same wall.

The ClawHub skill's config now carries connectionTimeoutMs, and the paragraph
under it states the measured cold-start time, OpenClaw's default, and the two ways
out: raise the host's timeout, or install the package first. docs/hermes-setup.md
carries the same config and a host-neutral version of the note, and
docs/client-setup.md gains an OpenClaw section with the exact commands.

The skill frontmatter said 1.0.0 while ClawHub served 1.0.1, which would mislead
anyone reading the repository. This change publishes 1.0.2 deliberately and the
frontmatter names it.

One stale line in docs/client-setup.md told readers beta.3 was the working
version. It now refers to the current beta rather than naming a superseded one.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@TheDesignFounder
TheDesignFounder merged commit 9b673bd into main Sep 25, 2026
2 checks passed
@TheDesignFounder
TheDesignFounder deleted the fix/openclaw-cold-start-20260925 branch September 25, 2026 06:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant