Web UI Testing with Claude for Chrome

Use this skill when manually testing the IronClaw web gateway UI via the Claude for Chrome browser extension.

Prerequisites

• IronClaw must be running with GATEWAY_ENABLED=true
• Note the gateway URL (default: http://127.0.0.1:3000/) and auth token
• The Claude for Chrome extension must be installed and connected

Starting the Server

CLI_ENABLED=false GATEWAY_AUTH_TOKEN=<your-token> cargo run

Wait for "Agent ironclaw ready and listening" in the logs before proceeding.

Test Checklist

1. Connection

• Navigate to http://127.0.0.1:3000/?token=<token>
• Verify "Connected" indicator in the top-right corner
• Verify all tabs are visible: Chat, Memory, Jobs, Routines, Extensions, Skills

2. Chat Tab

• Send a simple message (e.g., "Hello, what tools do you have?")
• Verify the LLM responds without errors
• If you see "Invalid schema for function" errors, the tool schema fix (PR #301) may not be merged yet

3. Skills Tab

• Click the Skills tab
• Verify "No skills installed" or a list of installed skills (no "Skills system not enabled" error)
• Search for "markdown" in the ClawHub search box
• Verify results appear with: name, version, description, relevance score, "updated X ago"
• Verify skill names are clickable links to clawhub.ai
• If search returns empty with a yellow warning banner, the registry may be unreachable

4. Skill Install (from search)

• Search for a skill (e.g., "markdown")
• Click "Install" on a result
• Confirm the install dialog
• Verify success toast appears
• Verify the skill appears in "Installed Skills" section

5. Skill Install (by URL)

• Scroll to "Install Skill by URL"
• Enter a skill name and a ClawHub download URL:
  • Name: markdown-viewer
  • URL: https://wry-manatee-359.convex.site/api/v1/download?slug=markdown-viewer
• Click Install
• Verify success toast and skill appears in installed list

6. Skill Remove

• Find an installed skill
• Click "Remove"
• Confirm removal
• Verify the skill disappears from the installed list

7. Other Tabs (smoke test)

• Memory: Should show the memory filesystem (may be empty)
• Jobs: Should show job list (may be empty)
• Routines: Should show routine list
• Extensions: Should show extension list with install options

Cleanup

After testing, remove any test-installed skills:

rm -rf ~/.ironclaw/installed_skills/<skill-name>

Stop the server with Ctrl+C or by killing the process.

Known Issues

• ClawHub registry at clawhub.ai is behind Vercel which blocks non-browser TLS fingerprints; the backend uses wry-manatee-359.convex.site directly
• Skill downloads are ZIP archives containing SKILL.md, not raw text
• The confirm() dialog for install may block browser automation; override with window.confirm = () => true in the console first