feat: add interactive setup wizard by UltraInstinct0x · Pull Request #55 · openclaw/openclaw

UltraInstinct0x · 2025-12-28T12:36:42Z

Summary

Add src/cli/wizard.ts with reusable prompt utilities (promptSelect, promptMultiSelect, promptInput, promptConfirm, runWizard)
Add src/infra/prerequisites.ts for system prerequisite checking (Node.js, pnpm, Git, ffmpeg, Tailscale, permissions)
Add src/commands/setup-wizard.ts implementing a 5-step interactive wizard:
1. Prerequisites check
2. Deployment pattern selection (local/cloud-gateway/headless)
3. Provider selection (WhatsApp/Telegram/Discord)
4. Workspace configuration (path and optional agent name)
5. Summary and confirmation
Modify src/commands/setup.ts to add --wizard and --quick flags with TTY-aware defaults
Update src/cli/program.ts to register the new options with help examples

Test plan

Run clawdis setup --wizard in a TTY terminal and verify the interactive wizard appears
Run clawdis setup --quick and verify non-interactive setup completes
Run clawdis setup in a non-TTY environment (piped) and verify quick mode is used
Verify clawdis setup --help shows the new options and examples
Verify build passes: pnpm build
Verify lint passes: pnpm lint

🤖 Generated with Claude Code

- Add src/infra/prerequisites.ts with unified prerequisite checking - Add src/commands/doctor.ts for system health diagnostics - Register doctor command in CLI with --json and --verbose flags - Add comprehensive tests for both modules - Checks: Node.js, pnpm, Git, config, workspace, credentials, API keys, network

- Add fixId to prerequisite results for fixable issues - Implement auto-fix for: config, workspace, WhatsApp login, API key - Prompt user before applying each fix - Re-run checks after fixes to show updated status - Suggest --fix when issues are detected

- One-liner installation: curl ... | bash - Platform detection (macOS, Linux) - Auto-install Node.js via nvm/fnm/brew - Auto-install pnpm via corepack or npm - Clone/update repository - Build and create clawdis symlink - Run initial setup - Supports --unattended flag for CI

- Multi-stage Dockerfile for minimal image size - ARM64 support for Oracle Cloud Ampere - Non-root user for security - Health check endpoint - docker-compose.yml with volume mounts for persistence - docker-compose.override.yml.example with Tailscale sidecar - .dockerignore for efficient builds

…erequisites feat: add prerequisites module and doctor command

…staller feat: add universal installer script

…cker feat: add Docker support

steipete · 2025-12-31T11:50:53Z

On my list to review soon, ty!

steipete · 2025-12-31T15:44:52Z

Huh, what does this do with Docker?

I smell mechants of complexity!

steipete · 2025-12-31T15:46:13Z

src/infra/prerequisites.ts

+/**
+ * Check if pnpm is installed.
+ */
+export async function checkPnpm(): Promise<PrerequisiteCheckResult> {


pnpm is not something we should enforce. That's a user choice.

steipete · 2025-12-31T15:46:28Z

src/infra/prerequisites.ts

+/**
+ * Check if Git is installed.
+ */
+export async function checkGit(): Promise<PrerequisiteCheckResult> {


There shouldn't be need for git.

steipete · 2025-12-31T15:46:43Z

src/infra/prerequisites.ts

+/**
+ * Check if ffmpeg is installed (required for media processing).
+ */
+export async function checkFfmpeg(): Promise<PrerequisiteCheckResult> {


steipete · 2025-12-31T15:48:52Z

Not certain this goes towards my vision. It's a valid choice and quite opinionated; my vision is more a single nom or homebrew cast you just start and i'll work. Defo do not want to require Docker, other tools are progressively used if use wants to. Thanks for the effort tho! I keep this open a abit to think more about it, maybe I can bring some ideas back into the first run experience.

UltraInstinct0x · 2025-12-31T17:33:03Z

Yeah, I figured but forgot to close this, sorry.
I just gave up, rm rf'ed everything from my cloud server and Mac.
It appears to me that I don't really understand what is going on here and claude keeps telling me contradicting stories from the docs so I'll just leave it to you and try to contribute in the future when I don't have to read thousands of lines to see where its going.
Thanks, happy new year!

After a gateway restart, Chrome's SingletonLock/SingletonSocket/SingletonCookie files persist on the Docker volume while their /tmp targets are gone. This causes Chrome to hang or timeout on subsequent launches. Remove these files in launchOpenClawChrome() before spawning, which is safe because ensurePortAvailable() already confirmed no Chrome is running on that port. Closes openclaw#55 Co-authored-by: Claude Opus 4.5 <[email protected]>

After a gateway restart, Chrome's SingletonLock/SingletonSocket/SingletonCookie files persist on the Docker volume while their /tmp targets are gone. This causes Chrome to hang or timeout on subsequent launches. Remove these files in launchOpenClawChrome() before spawning, which is safe because ensurePortAvailable() already confirmed no Chrome is running on that port. Closes openclaw#55 Co-Authored-By: Claude Opus 4.5 <[email protected]>

After a gateway restart, Chrome's SingletonLock/SingletonSocket/SingletonCookie files persist on the Docker volume while their /tmp targets are gone. This causes Chrome to hang or timeout on subsequent launches. Remove these files in launchOpenClawChrome() before spawning, which is safe because ensurePortAvailable() already confirmed no Chrome is running on that port. Closes openclaw#55 Co-authored-by: Claude Opus 4.5 <[email protected]>

…enclaw#55)

…ction - Replace non-existent generateText with completeSimple from pi-ai - Use explicit Sonnet model (claude-sonnet-4-20250514) for extraction - Add condenseMessagesForExtraction: compact text repr instead of raw JSON - Add buildContextTransfer: safe defaults for all schema fields - Add parseJsonFromResponse: robust JSON extraction from LLM output - Export helper functions via __testing for unit tests - Add 16 unit tests covering all extraction helpers - All 43 tests pass, build clean

After a gateway restart, Chrome's SingletonLock/SingletonSocket/SingletonCookie files persist on the Docker volume while their /tmp targets are gone. This causes Chrome to hang or timeout on subsequent launches. Remove these files in launchOpenClawChrome() before spawning, which is safe because ensurePortAvailable() already confirmed no Chrome is running on that port. Closes openclaw#55 Co-authored-by: Claude Opus 4.5 <[email protected]>

focal55

The overall schema structure is well-designed, and the tables are normalized correctly. The use of pgvector and the corresponding HNSW index is also set up properly.

However, there is a critical security issue: Row Level Security (RLS) is enabled on all tables, but the required CREATE POLICY statements are missing from the migration script. Enabling RLS without defining policies will block all non-superuser access to the tables.

Please add the specific RLS policies to the 001_initial_schema.sql migration file to ensure that users can only access their own data. For example:

-- For profiles
create policy "Users can view their own profile" on public.profiles
  for select using (auth.uid() = id);

create policy "Users can update their own profile" on public.profiles
  for update using (auth.uid() = id);

-- Similar policies should be created for all other user-specific tables
-- (user_progress, study_sessions, user_achievements, daily_activity)
-- to check that auth.uid() = user_id.

-- For doc_chunks, a public read-only policy is needed
create policy "All users can read doc_chunks" on public.doc_chunks
  for select using (true);

This will make the database schema secure and reproducible from the migration script alone.

)

…aw#55)\n\nBreaks the infinite approval loop on LINE OA stateless runtime by:\n- Adding LineExecApprovalHandler (confirm template with Approve/Deny buttons)\n- Intercepting exec_approval= postbacks in handlePostbackEvent before processMessage\n- Extracting shared shouldSkipRichChannelForwarding utility\n- Wiring handler into LINE monitor lifecycle (start/stop)\n\nNew files:\n- src/infra/exec-approval-utils.ts (shared approval target resolution)\n- src/line/exec-approvals.ts (LINE exec approval handler)\n- src/line/exec-approvals.test.ts (unit + integration tests)\n\nModified:\n- src/line/bot-handlers.ts (postback interception)\n- src/line/bot.ts (pass handler through LineBotOptions)\n- src/line/monitor.ts (instantiate + lifecycle)\n- src/infra/exec-approval-forwarder.ts (use shared skip function)"

…andler.start() async initialization was being fire-and-forget.\nThis caused a race condition where the gateway client might not be ready\nwhen postbacks are processed. Now properly awaits initialization before\nmessage processing starts, with graceful degradation if startup fails."

* fix(sre:PLA-813): harden consumer approval bug triage * test(sre:PLA-813): allowlist fake linear secret fixture * fix(sre:PLA-813): address PR review findings * fix(sre:PLA-813): address follow-up review findings

ronan-dandelion-cult · 2026-03-29T18:36:32Z

Ronan's findings from code trace

The tool construction gates both look correct:

continuation.enabled === true — confirmed in our config (~/.openclaw/openclaw.json)
drainsContinuationDelegateQueue === true — set in get-reply-run.ts:713 for the main reply path

The tool is created in openclaw-tools.ts:253 when both conditions are met:

...(options?.config?.agents?.defaults?.continuation?.enabled === true &&
options?.drainsContinuationDelegateQueue === true
  ? [createContinueDelegateTool({ agentSessionKey: options?.agentSessionKey })]
  : []),

Both gates should be open. Yet no prince sees continue_delegate in their tool list.

Possible root causes:

Provider-side tool filtering (GitHub Copilot provider may be dropping it during schema serialization)
Tool name not matching the provider's tool allowlist
The tool is constructed but not making it into the model's visible tool schema

The regression is likely in the tool serialization layer or provider adapter, not in tool construction. Worth adding a debug log at the point where tools are serialized to the provider to confirm the tool is present pre-serialization.

Build: 2b53fa4 (OpenClaw 2026.3.24). All 4 princes on same build, all confirm tool missing.

MiniMax M2 models (including M2.7) are trained heavily on Chinese data and occasionally leak CJK (Chinese/Japanese/Korean) ideographs and punctuation into non-CJK language outputs (German, English, etc.). This is a known model-level bug: - GitHub MiniMax-M2 Issue openclaw#100 (Korean → Chinese leakage) - OpenClaw Issue openclaw#17121 (Japanese → Chinese/Russian leakage) - MiniMax-M2 Issue openclaw#55 (CJK/Latin punctuation confusion) System prompt instructions alone cannot reliably prevent this because the leakage originates at the token probability level, not from the model ignoring instructions. Changes: - Add stripLeakedCjkChars() post-processing filter that detects when text is predominantly non-CJK (<20% CJK ideographs by character count) and strips stray CJK characters + replaces CJK punctuation with Latin equivalents - Wire into all three text sanitization paths: 1. extractAssistantText (pi-embedded-utils.ts) -- final message 2. sanitizeTextContent (sessions-helpers.ts) -- subagent/session text 3. emitBlockChunk (pi-embedded-subscribe.ts) -- streaming chunks - Safety: text with >20% CJK content is left untouched (intentional CJK language use) - 17 tests covering German, English, mixed content, intentional CJK preservation, edge cases Fixes openclaw#17121

UltraInstinct0x and others added 9 commits December 28, 2025 15:13

feat: add interactive setup wizard

843e5ce

Merge pull request #1 from UltraInstinct0x/feature/ultrainstinct0x-pr…

44d15bf

…erequisites feat: add prerequisites module and doctor command

Merge pull request #2 from UltraInstinct0x/feature/ultrainstinct0x-in…

b94338f

…staller feat: add universal installer script

Merge pull request #3 from UltraInstinct0x/feature/ultrainstinct0x-do…

9180e4b

…cker feat: add Docker support

Merge branch 'main' into feature/ultrainstinct0x-wizard

3ade71c

openclaw deleted a comment from greptile-apps bot Dec 31, 2025

Merge branch 'main' into feature/ultrainstinct0x-wizard

074a6f0

steipete reviewed Dec 31, 2025

View reviewed changes

UltraInstinct0x closed this Dec 31, 2025

PrivacySmurf pushed a commit to PrivacySmurf/openclaw that referenced this pull request Feb 18, 2026

feat(compaction): auto-extract context transfer during compaction (op…

e50bf68

…enclaw#55)

focal55 suggested changes Feb 25, 2026

View reviewed changes

songliu0403-rgb pushed a commit to songliu0403-rgb/openclaw that referenced this pull request Feb 26, 2026

fix(electron): register activate handler after app is ready (openclaw#55

b63c222

)

This was referenced Mar 19, 2026

fix(acpx): stabilize bound completion feedback routing #50084

Closed

fix(telegram): route topic-bound subagent completion to canonical target #52754

Open

Arry8 mentioned this pull request Mar 24, 2026

feat: cron improvements, skill triggers, twilio-sms, webchat attachments, control-ui IP guard #53237

Closed

6 tasks

drobison00 mentioned this pull request Mar 28, 2026

[octriage test] Live workflow for issue #55 drobison00/openclaw#2

Draft

Foundry421 mentioned this pull request Mar 30, 2026

fix: strip leaked CJK characters from MiniMax model output #57590

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add interactive setup wizard#55

feat: add interactive setup wizard#55
UltraInstinct0x wants to merge 10 commits intoopenclaw:mainfrom
UltraInstinct0x:feature/ultrainstinct0x-wizard

UltraInstinct0x commented Dec 28, 2025

Uh oh!

steipete commented Dec 31, 2025

Uh oh!

steipete commented Dec 31, 2025

Uh oh!

steipete Dec 31, 2025

Uh oh!

steipete Dec 31, 2025

Uh oh!

steipete Dec 31, 2025

Uh oh!

steipete commented Dec 31, 2025

Uh oh!

UltraInstinct0x commented Dec 31, 2025

Uh oh!

focal55 left a comment

Uh oh!

ronan-dandelion-cult commented Mar 29, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

UltraInstinct0x commented Dec 28, 2025

Summary

Test plan

Uh oh!

steipete commented Dec 31, 2025

Uh oh!

steipete commented Dec 31, 2025

Uh oh!

steipete Dec 31, 2025

Choose a reason for hiding this comment

Uh oh!

steipete Dec 31, 2025

Choose a reason for hiding this comment

Uh oh!

steipete Dec 31, 2025

Choose a reason for hiding this comment

Uh oh!

steipete commented Dec 31, 2025

Uh oh!

UltraInstinct0x commented Dec 31, 2025

Uh oh!

focal55 left a comment

Choose a reason for hiding this comment

Uh oh!

ronan-dandelion-cult commented Mar 29, 2026

Ronan's findings from code trace

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants