+
+
+
+
+ Prefer the command line?
+
+ This wizard is just one way to get started. You can also run any openclaw command directly using
+ Railway's built-in Console — an in-browser shell scoped to this service, no SSH client needed.
+
-
+
- Open your project in the Railway dashboard +
- Click this service, then open the Console tab +
- Use the connected shell (top) and file browser (bottom) to run commands, e.g.: +
openclaw onboard
+openclaw models set anthropic/claude-sonnet-4-20250514
diff --git a/src/public/styles.css b/src/public/styles.css
index 56097d3..f11c354 100644
--- a/src/public/styles.css
+++ b/src/public/styles.css
@@ -102,6 +102,76 @@ img { max-width: 100%; height: auto; }
.card-compact { padding: 1.25rem; }
+.console-card {
+ background: var(--bg-card);
+ border: 1px solid #818cf8;
+ border-radius: 0.75rem;
+ padding: 1.5rem;
+ box-shadow: var(--shadow-card);
+}
+
+.console-card-header {
+ display: flex;
+ align-items: center;
+ gap: 0.625rem;
+ margin-bottom: 0.75rem;
+}
+
+.console-icon {
+ width: 2rem;
+ height: 2rem;
+ border-radius: 0.5rem;
+ background: rgba(99,102,241,0.15);
+ color: #6366f1;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ flex-shrink: 0;
+}
+
+.console-card-desc {
+ font-size: 0.875rem;
+ color: var(--text-secondary);
+ line-height: 1.5;
+ margin-bottom: 0.875rem;
+}
+
+.console-card-desc code {
+ font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+ font-size: 0.8125rem;
+ color: #6366f1;
+}
+
+.console-steps {
+ font-size: 0.875rem;
+ color: var(--text-secondary);
+ line-height: 1.6;
+ margin: 0 0 0.875rem;
+ padding-left: 1.25rem;
+}
+
+.console-cmd {
+ background: var(--bg-muted);
+ border: 1px solid var(--border);
+ border-radius: 0.5rem;
+ padding: 0.75rem 0.875rem;
+ margin: 0;
+ overflow-x: auto;
+}
+
+.console-cmd code {
+ font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+ font-size: 0.8125rem;
+ color: var(--text);
+ white-space: pre;
+}
+
+@media (prefers-color-scheme: dark) {
+ .console-card { border-color: #312e81; }
+ .console-icon { color: #818cf8; }
+ .console-card-desc code { color: #818cf8; }
+}
+
.card + .card,
.card-group > * + * { margin-top: 1.5rem; }
@@ -230,14 +300,10 @@ img { max-width: 100%; height: auto; }
.link-teal { color: #0d9488; transition: color 0.15s; }
.link-teal:hover { color: #14b8a6; }
-.link-purple { color: #9333ea; transition: color 0.15s; }
-.link-purple:hover { color: #a855f7; }
@media (prefers-color-scheme: dark) {
.link-teal { color: #2dd4bf; }
.link-teal:hover { color: #5eead4; }
- .link-purple { color: #c084fc; }
- .link-purple:hover { color: #d8b4fe; }
}
.inline-link {
@@ -1081,125 +1147,9 @@ img { max-width: 100%; height: auto; }
.fade-slide-start { opacity: 0; transform: translateX(1rem); }
.fade-slide-end { opacity: 1; transform: translateX(0); }
-.tui-body {
- background: #0a0a0a;
- color: #e5e5e5;
- overflow: hidden;
-}
-
-.tui-header {
- display: flex;
- align-items: center;
- justify-content: space-between;
- padding: 0.75rem 1rem;
- border-bottom: 1px solid #262626;
-}
-
-.tui-logo-section {
- display: flex;
- align-items: center;
- gap: 0.75rem;
-}
-
-.tui-logo { height: 1.5rem; }
-
-.tui-label {
- color: #737373;
- font-size: 0.875rem;
-}
-
-.tui-status {
- display: flex;
- align-items: center;
- gap: 0.5rem;
- font-size: 0.875rem;
-}
-
-.status-dot {
- width: 0.5rem;
- height: 0.5rem;
- border-radius: 50%;
-}
-
-.status-dot-yellow { background: #eab308; }
.status-dot-green { background: #22c55e; }
.status-dot-red { background: #ef4444; }
-.status-text { color: #a3a3a3; }
-
-.tui-loading-overlay {
- position: absolute;
- inset: 0;
- top: 56px;
- background: #0a0a0a;
- display: flex;
- align-items: center;
- justify-content: center;
- z-index: 40;
-}
-
-.tui-loading-text {
- color: #a3a3a3;
- font-size: 0.875rem;
-}
-
-.tui-spinner {
- width: 2rem;
- height: 2rem;
- border: 2px solid #404040;
- border-top-color: #a855f7;
- border-radius: 50%;
- animation: spin 0.8s linear infinite;
- margin: 0 auto 1rem;
-}
-
-.tui-error-overlay {
- position: fixed;
- inset: 0;
- background: rgba(10,10,10,0.9);
- display: flex;
- align-items: center;
- justify-content: center;
- z-index: 50;
-}
-
-.tui-error-card {
- background: #171717;
- border: 1px solid #262626;
- border-radius: 0.5rem;
- padding: 1.5rem;
- max-width: 28rem;
- margin: 0 1rem;
- text-align: center;
-}
-
-.tui-error-title {
- color: #f87171;
- font-size: 1.125rem;
- font-weight: 500;
- margin-bottom: 0.5rem;
-}
-
-.tui-error-msg {
- color: #a3a3a3;
- font-size: 0.875rem;
- margin-bottom: 1rem;
-}
-
-.tui-reconnect-btn {
- background: #dc2626;
- color: #fff;
- border: none;
- border-radius: 0.375rem;
- padding: 0.5rem 1rem;
- font-size: 0.875rem;
- font-family: var(--font-sans);
- font-weight: 500;
- cursor: pointer;
- transition: background-color 0.15s;
-}
-.tui-reconnect-btn:hover { background: #b91c1c; }
-
.log-autoscroll-toggle {
display: inline-flex;
align-items: center;
diff --git a/src/public/tui.html b/src/public/tui.html
deleted file mode 100644
index 2d233ee..0000000
--- a/src/public/tui.html
+++ /dev/null
@@ -1,193 +0,0 @@
-
-
-
-
-
- 🦞 OpenClaw TUI
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/src/server.js b/src/server.js
index fc81672..cc37cc1 100644
--- a/src/server.js
+++ b/src/server.js
@@ -9,7 +9,6 @@ import { pathToFileURL } from "node:url";
import express from "express";
import httpProxy from "http-proxy";
import pty from "node-pty";
-import { WebSocketServer } from "ws";
import {
canServeGatewayRequest,
describeGatewayHealth,
@@ -122,16 +121,6 @@ const OPENCLAW_ENTRY =
process.env.OPENCLAW_ENTRY?.trim() || "/openclaw/dist/entry.js";
const OPENCLAW_NODE = process.env.OPENCLAW_NODE?.trim() || "node";
-const ENABLE_WEB_TUI = process.env.ENABLE_WEB_TUI?.toLowerCase() === "true";
-const TUI_IDLE_TIMEOUT_MS = Number.parseInt(
- process.env.TUI_IDLE_TIMEOUT_MS ?? "300000",
- 10,
-);
-const TUI_MAX_SESSION_MS = Number.parseInt(
- process.env.TUI_MAX_SESSION_MS ?? "1800000",
- 10,
-);
-
function clawArgs(args) {
return [OPENCLAW_ENTRY, ...args];
}
@@ -876,7 +865,6 @@ app.get("/setup/api/status", requireSetupAuth, async (_req, res) => {
gatewayTarget: GATEWAY_TARGET,
openclawVersion: version,
authGroups,
- tuiEnabled: ENABLE_WEB_TUI,
});
});
@@ -1820,148 +1808,6 @@ app.get("/setup/api/logs/stream", requireSetupAuth, (req, res) => {
});
});
-app.get("/tui", requireSetupAuth, (_req, res) => {
- if (!ENABLE_WEB_TUI) {
- return res
- .status(403)
- .type("text/plain")
- .send("Web TUI is disabled. Set ENABLE_WEB_TUI=true to enable it.");
- }
- if (!isConfigured()) {
- return res.redirect("/setup");
- }
- res.sendFile(path.join(process.cwd(), "src", "public", "tui.html"));
-});
-
-let activeTuiSession = null;
-
-function verifyTuiAuth(req) {
- if (!SETUP_PASSWORD) return false;
- const header = req.headers.authorization || "";
- const [scheme, encoded] = header.split(" ");
- if (scheme !== "Basic" || !encoded) return false;
- const decoded = Buffer.from(encoded, "base64").toString("utf8");
- const idx = decoded.indexOf(":");
- const password = idx >= 0 ? decoded.slice(idx + 1) : "";
- const passwordHash = crypto.createHash("sha256").update(password).digest();
- const expectedHash = crypto.createHash("sha256").update(SETUP_PASSWORD).digest();
- return crypto.timingSafeEqual(passwordHash, expectedHash);
-}
-
-function createTuiWebSocketServer(httpServer) {
- const wss = new WebSocketServer({ noServer: true });
-
- wss.on("connection", (ws, req) => {
- const clientIp = req.socket?.remoteAddress || "unknown";
- log.info("tui", `session started from ${clientIp}`);
-
- let ptyProcess = null;
- let idleTimer = null;
- let maxSessionTimer = null;
-
- activeTuiSession = {
- ws,
- pty: null,
- startedAt: Date.now(),
- lastActivity: Date.now(),
- };
-
- function resetIdleTimer() {
- if (activeTuiSession) {
- activeTuiSession.lastActivity = Date.now();
- }
- clearTimeout(idleTimer);
- idleTimer = setTimeout(() => {
- log.info("tui", "session idle timeout");
- ws.close(4002, "Idle timeout");
- }, TUI_IDLE_TIMEOUT_MS);
- }
-
- function spawnPty(cols, rows) {
- if (ptyProcess) return;
-
- log.info("tui", `spawning PTY with ${cols}x${rows}`);
- ptyProcess = pty.spawn(OPENCLAW_NODE, clawArgs(["tui"]), {
- name: "xterm-256color",
- cols,
- rows,
- cwd: WORKSPACE_DIR,
- env: {
- ...process.env,
- OPENCLAW_STATE_DIR: STATE_DIR,
- OPENCLAW_WORKSPACE_DIR: WORKSPACE_DIR,
- TERM: "xterm-256color",
- },
- });
-
- if (activeTuiSession) {
- activeTuiSession.pty = ptyProcess;
- }
-
- idleTimer = setTimeout(() => {
- log.info("tui", "session idle timeout");
- ws.close(4002, "Idle timeout");
- }, TUI_IDLE_TIMEOUT_MS);
-
- maxSessionTimer = setTimeout(() => {
- log.info("tui", "max session duration reached");
- ws.close(4002, "Max session duration");
- }, TUI_MAX_SESSION_MS);
-
- ptyProcess.onData((data) => {
- if (ws.readyState === ws.OPEN) {
- ws.send(data);
- }
- });
-
- ptyProcess.onExit(({ exitCode, signal }) => {
- log.info("tui", `PTY exited code=${exitCode} signal=${signal}`);
- if (ws.readyState === ws.OPEN) {
- ws.close(1000, "Process exited");
- }
- });
- }
-
- ws.on("message", (message) => {
- resetIdleTimer();
- try {
- const msg = JSON.parse(message.toString());
- if (msg.type === "resize" && msg.cols && msg.rows) {
- const cols = Math.min(Math.max(msg.cols, 10), 500);
- const rows = Math.min(Math.max(msg.rows, 5), 200);
- if (!ptyProcess) {
- spawnPty(cols, rows);
- } else {
- ptyProcess.resize(cols, rows);
- }
- } else if (msg.type === "input" && msg.data && ptyProcess) {
- ptyProcess.write(msg.data);
- }
- } catch (err) {
- log.warn("tui", `invalid message: ${err.message}`);
- }
- });
-
- ws.on("close", () => {
- log.info("tui", "session closed");
- clearTimeout(idleTimer);
- clearTimeout(maxSessionTimer);
- if (ptyProcess) {
- try {
- ptyProcess.kill();
- } catch {}
- }
- activeTuiSession = null;
- });
-
- ws.on("error", (err) => {
- log.error("tui", `WebSocket error: ${err.message}`);
- });
- });
-
- return wss;
-}
-
const proxy = httpProxy.createProxyServer({
target: GATEWAY_TARGET,
ws: true,
@@ -2047,7 +1893,6 @@ app.use(async (req, res) => {
const server = app.listen(PORT, () => {
log.info("wrapper", `listening on port ${PORT}`);
log.info("wrapper", `setup wizard: http://localhost:${PORT}/setup`);
- log.info("wrapper", `web TUI: ${ENABLE_WEB_TUI ? "enabled" : "disabled"}`);
log.info("wrapper", `configured: ${isConfigured()}`);
void probeDeviceBootstrapSdk();
@@ -2068,36 +1913,7 @@ const server = app.listen(PORT, () => {
}
});
-const tuiWss = createTuiWebSocketServer(server);
-
server.on("upgrade", async (req, socket, head) => {
- const url = new URL(req.url, `http://${req.headers.host}`);
-
- if (url.pathname === "/tui/ws") {
- if (!ENABLE_WEB_TUI) {
- socket.write("HTTP/1.1 403 Forbidden\r\n\r\n");
- socket.destroy();
- return;
- }
-
- if (!verifyTuiAuth(req)) {
- socket.write("HTTP/1.1 401 Unauthorized\r\nWWW-Authenticate: Basic realm=\"OpenClaw TUI\"\r\n\r\n");
- socket.destroy();
- return;
- }
-
- if (activeTuiSession) {
- socket.write("HTTP/1.1 409 Conflict\r\n\r\n");
- socket.destroy();
- return;
- }
-
- tuiWss.handleUpgrade(req, socket, head, (ws) => {
- tuiWss.emit("connection", ws, req);
- });
- return;
- }
-
if (!isConfigured()) {
socket.destroy();
return;
@@ -2120,14 +1936,6 @@ async function gracefulShutdown(signal) {
clearInterval(setupRateLimiter.cleanupInterval);
}
- if (activeTuiSession) {
- try {
- activeTuiSession.ws.close(1001, "Server shutting down");
- activeTuiSession.pty.kill();
- } catch {}
- activeTuiSession = null;
- }
-
server.close();
if (gatewayProc) {
-
- 
-
- Terminal
-
-
-
-
- Connecting...
-
-