Skip to content

First-run setup wizard for new installs#72

Merged
lezama merged 1 commit into
mainfrom
feat/setup-wizard
May 19, 2026
Merged

First-run setup wizard for new installs#72
lezama merged 1 commit into
mainfrom
feat/setup-wizard

Conversation

@lezama
Copy link
Copy Markdown
Owner

@lezama lezama commented May 19, 2026

Summary

Adds a 3-step setup wizard reachable at admin.php?page=openclawp-setup and surfaced via a dismissible welcome notice on every admin screen until the user completes (or skips) it.

Steps:

  1. Welcome — what openclaWP is + "Get started" button.
  2. Provider — detect installed Connectors API providers (Ollama / Anthropic / OpenAI / Google); show install links for the missing ones.
  3. First agent — toggle the bundled openclawp-example agent on so there's something to chat with.

Completion is stored in openclawp_setup_completed; the welcome notice goes away once that flips to '1'.

Why

A fresh openclaWP install today drops the user on an empty Chat page with no obvious next step. The wizard takes them from zero to "I can talk to an agent" in ~30 seconds.

Test plan

  • Activate openclaWP on a fresh install — the welcome notice appears on every admin screen.
  • Click "Start setup" → land on step 1.
  • Walk through to "done" → notice disappears on next page load.
  • Skip from any step → still marks complete; notice gone.
  • Reactivate the plugin (which clears the option) and the notice returns.
  • Step 2 correctly detects whichever provider plugins are installed.
  • Step 3 sets the openclawp_setup_enable_example_agent option, which makes the bundled example agent appear in the Chat picker.

🤖 Generated with Claude Code

Adds a 3-step admin wizard (welcome → provider → first agent) reachable
at admin.php?page=openclawp-setup, surfaced via a dismissible welcome
notice on every wp-admin screen until openclawp_setup_completed is set.

Step 3 toggles openclawp_setup_enable_example_agent; the wizard hooks
openclawp_register_example_agent to bridge that option back to the
existing agent registrar without modifying it.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@lezama lezama merged commit caa1de8 into main May 19, 2026
5 of 6 checks passed
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