v2.10.2

Bug Fix

• fix: set tools.profile to "full" for deployed agents — openclaw onboard --mode local defaults tools.profile to "messaging", which only exposes Slack + session management tools to agents. This meant agents couldn't access exec/bash, file read/write/edit, Linear plugin tools, or other capabilities needed for bootstrap and normal operation. Agents now get the "full" tools profile on deploy.

v2.10.1

Bug Fix

• fix: fallback to manual systemd service when openclaw daemon install fails — openclaw 2026.3.2 has a bug where openclaw daemon install fails with "systemctl is-enabled unavailable" when the openclaw-gateway.service unit doesn't exist yet. Added a fallback that manually creates the systemd user service unit file with the correct NVM-based PATH when the CLI install fails.

v2.10.0

What's New

• Inline comments in generated clawup.yaml — clawup init now adds helpful inline comments to the generated manifest, making it easier to understand and customize (#c489b57)

v2.9.3

Bug Fixes

• Consistent template variable resolution — {{AGENT_NAME}}, {{AGENT_ROLE}}, {{AGENT_EMOJI}}, and per-agent envVars now resolve correctly in workspace files and hook scripts. Previously, agent-specific variables were added after template processing, causing {{VAR}} placeholders to silently pass through unresolved.

v2.9.2

Bug Fixes

• Linear plugin agentMapping: Resolve actual agent display name instead of leaving the $AGENT_NAME placeholder as a literal string
• Linear plugin UUID: Fall back to Pulumi config for linearUserUuid so the UUID auto-resolved during clawup setup is properly read back

Tests

• Add regression tests for Linear agentMapping resolution (9 tests covering display name fallback chain, UUID resolution, and placeholder guard)

v2.9.1

Bug Fixes

• Template vars in hook environment: manifest.templateVars (e.g., GITHUB_REPO, LINEAR_TEAM) are now spread into agent env vars, written to .profile, and available in hooks
• Non-fatal hook execution: Hook failures in postProvision and preStart phases now log warnings instead of aborting the provisioner — phase_daemon always runs
• clawup push --openclaw recovery: Adds daemon install + auto-approve device pairing after gateway restart, recovering agents where cloud-init failed

v2.9.0

What's New

Refactor

• Merge deps into hooks pipeline: Deps (gh, brave-search) now execute as postProvisionHooks entries instead of separate phase_deps_root/phase_deps_post bash phases — one unified execution path for all provisioning scripts (#176)
• Brave Search now has a real postInstallScript that configures OpenClaw via openclaw config set, removing the hardcoded special case

Features

• SEO and LLM search optimization: OG images, sitemaps, llms.txt for web dashboard

Docs

• Updated hooks execution timeline to reflect deps-in-hooks architecture
• Added "How Deps Integrate with PostProvision" section with ordering examples
• Comprehensive plugin guide with manifest reference
• Updated READMEs with current CLI commands and ASCII art

v2.8.0

What's New

Features

• Multi-level hooks: Generalized hooks to swarm, identity, and plugin levels (#175)

Fixes

• Redact secrets from hook error log messages
• Add missing resolve hook to openclaw-linear example manifest

Docs

• Plugin hooks guide and expanded onboard docs
• Mark all plugin hooks as experimental
• Updated docs and README for 3-level hooks architecture

Tests

• Comprehensive tests for multi-level hooks

v2.7.1

Bug Fix

• fix: resolve identity-bundled plugin manifests before built-in registry — resolvePlugin() checked the built-in PLUGIN_MANIFEST_REGISTRY before identity-bundled manifests, so user overrides (e.g. adding an onboard hook to a built-in plugin like slack) were silently ignored. Local/identity overrides now take precedence over built-in defaults.

🤖 Generated with Claude Code

v2.7.0

Plugin Onboard Hooks

Adds interactive onboard hooks for first-time plugin setup flows (e.g., creating a Slack app, configuring OAuth).

New Features

• clawup onboard — standalone command to run plugin onboard hooks interactively
• clawup setup --onboard — run onboard hooks during setup (deprecated command, still works)
• OnboardHookSchema in plugin manifests — plugins can declare hooks.onboard with description, inputs (envVar/prompt/instructions/validator), script, and runOnce semantics
• runOnce support — skips onboard if all required secrets are already present
• Secret redaction — onboard hook output is automatically redacted for common token formats (Slack, GitHub, Linear, etc.)

What's in a Plugin Onboard Hook

hooks:
  onboard:
    description: "Set up Slack app for this agent"
    runOnce: true
    inputs:
      slackBotToken:
        envVar: SLACK_BOT_TOKEN
        prompt: "Enter your Slack bot token"
        validator: "xoxb-"
    script: "node setup-slack.js"

Also Includes

• All changes from v2.6.0 (one-step deploy flow — clawup deploy handles setup automatically)