clawport-ui 0.6.4 → 0.6.6

package/README.md

@@ -122,7 +122,7 @@ All AI calls -- chat, vision, TTS, transcription -- route through the gateway. O
 
 | Variable | Description | How to find it |
 |----------|-------------|----------------|
-| `WORKSPACE_PATH` | Path to your OpenClaw workspace | Default: `~/.openclaw/workspace` |
+| `WORKSPACE_PATH` | Path to your OpenClaw workspace | Default: `~/.openclaw/agents/main/workspace` (or legacy `~/.openclaw/workspace`) |
 | `OPENCLAW_BIN` | Path to the `openclaw` binary | Run `which openclaw` |
 | `OPENCLAW_GATEWAY_TOKEN` | Gateway auth token | Run `openclaw gateway status` |
 
@@ -132,7 +132,7 @@ All AI calls -- chat, vision, TTS, transcription -- route through the gateway. O
 |----------|-------------|
 | `ELEVENLABS_API_KEY` | ElevenLabs API key for voice indicators on agent profiles |
 
-Running `clawport setup` auto-detects all required values and writes `.env.local`. See [SETUP.md](SETUP.md) for manual configuration, agent customization, and troubleshooting.
+Running `clawport setup` auto-detects all required values and writes `.env.local`. When installed globally, if the package directory isn't writable, setup writes to `~/.config/clawport-ui/.env.local` instead. See [SETUP.md](SETUP.md) for manual configuration, agent customization, and troubleshooting.
 
 ---
 
@@ -171,7 +171,7 @@ clawport help     # Show usage
 ## Testing
 
 ```bash
-npm test             # 501 tests across 23 suites (Vitest)
+npm test             # 536 tests across 24 suites (Vitest)
 npx tsc --noEmit     # Type-check (zero errors)
 npx next build       # Production build
 ```

package/bin/clawport.mjs

@@ -150,9 +150,15 @@ ${dim(`Package root: ${PKG_ROOT}`)}
 `)
 }
 
+function portArgs() {
+  const hasPort = extraArgs.some((a) => a === '--port' || a.startsWith('--port=') || a === '-p')
+  if (!hasPort && process.env.PORT) return ['--port', process.env.PORT]
+  return []
+}
+
 function cmdDev() {
   console.log(`\n  ${bold('Starting ClawPort dev server...')}\n`)
-  run(NEXT_BIN, ['dev', ...extraArgs])
+  run(NEXT_BIN, ['dev', ...portArgs(), ...extraArgs])
 }
 
 function cmdStart() {
@@ -164,7 +170,7 @@ function cmdStart() {
   })
   build.on('close', (code) => {
     if (code !== 0) process.exit(code)
-    run(NEXT_BIN, ['start', ...extraArgs])
+    run(NEXT_BIN, ['start', ...portArgs(), ...extraArgs])
   })
 }
 
@@ -286,9 +292,10 @@ async function cmdDoctor() {
   }
   check(workspaceOk, 'Workspace structure', workspaceFix)
 
-  // 7. Port 3000 available
-  const portFree = await checkPort(3000)
-  check(portFree, 'Port 3000 available', 'Port 3000 is in use. Use: clawport dev --port 3001')
+  // 7. Port available
+  const port = Number(process.env.PORT) || 3000
+  const portFree = await checkPort(port)
+  check(portFree, `Port ${port} available`, `Port ${port} is in use. Use: clawport dev --port ${port + 1}`)
 
   // Summary
   console.log()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawport-ui",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "Open-source dashboard for managing, monitoring, and chatting with your OpenClaw AI agents.",
   "homepage": "https://clawport.dev",
   "repository": {