@chrysb/alphaclaw 0.5.5 → 0.5.7-beta.0

package/lib/server.js

@@ -72,6 +72,7 @@ const {
   isGatewayRunning,
   startGateway,
   restartGateway: restartGatewayWithReload,
+  restartGatewayLight: restartGatewayLightWithReload,
   attachGatewaySignalHandlers,
   ensureGatewayProxyConfig,
   syncChannelConfig,
@@ -90,7 +91,7 @@ const {
 } = require("./server/restart-required-state");
 const {
   ensureOpenclawRuntimeArtifacts,
-  installControlUiSkill,
+  resolveSetupUiUrl,
   syncBootstrapPromptFiles,
 } = require("./server/onboarding/workspace");
 const {
@@ -105,6 +106,9 @@ const { createDiscordApi } = require("./server/discord-api");
 const { createWatchdogNotifier } = require("./server/watchdog-notify");
 const { createWatchdog } = require("./server/watchdog");
 const { createDoctorService } = require("./server/doctor/service");
+const { createAgentsService } = require("./server/agents/service");
+const { createOperationEventsService } = require("./server/operation-events");
+const { runOnboardedBootSequence } = require("./server/startup");
 
 const { registerAuthRoutes } = require("./server/routes/auth");
 const { registerPageRoutes } = require("./server/routes/pages");
@@ -122,6 +126,7 @@ const { registerWatchdogRoutes } = require("./server/routes/watchdog");
 const { registerUsageRoutes } = require("./server/routes/usage");
 const { registerGmailRoutes } = require("./server/routes/gmail");
 const { registerDoctorRoutes } = require("./server/routes/doctor");
+const { registerAgentRoutes } = require("./server/routes/agents");
 
 const { PORT, kTrustProxyHops, SETUP_API_PREFIXES } = constants;
 
@@ -152,22 +157,24 @@ proxy.on("error", (err, req, res) => {
 });
 
 const authProfiles = createAuthProfiles();
-const loginThrottle = { ...createLoginThrottle(), getClientKey };
 const { shellCmd, clawCmd, gogCmd } = createCommands({ gatewayEnv });
-const resolveSetupUrl = () => {
-  const explicit =
+const agentsService = createAgentsService({
+  fs,
+  OPENCLAW_DIR: constants.OPENCLAW_DIR,
+  readEnvFile,
+  writeEnvFile,
+  reloadEnv,
+  restartGateway: () => restartGatewayWithReload(reloadEnv),
+  clawCmd,
+});
+const loginThrottle = { ...createLoginThrottle(), getClientKey };
+const resolveSetupUrl = () =>
+  resolveSetupUiUrl(
     process.env.ALPHACLAW_SETUP_URL ||
-    process.env.ALPHACLAW_BASE_URL ||
-    process.env.RENDER_EXTERNAL_URL ||
-    process.env.URL;
-  if (explicit) return String(explicit).trim();
-  if (process.env.RAILWAY_STATIC_URL) {
-    const domain = String(process.env.RAILWAY_STATIC_URL).trim();
-    if (!domain) return "";
-    return domain.startsWith("http") ? domain : `https://${domain}`;
-  }
-  return "";
-};
+      process.env.ALPHACLAW_BASE_URL ||
+      process.env.RENDER_EXTERNAL_URL ||
+      process.env.URL,
+  );
 const restartGateway = () => restartGatewayWithReload(reloadEnv);
 const openclawVersionService = createOpenclawVersionService({
   gatewayEnv,
@@ -176,6 +183,7 @@ const openclawVersionService = createOpenclawVersionService({
 });
 const alphaclawVersionService = createAlphaclawVersionService();
 const restartRequiredState = createRestartRequiredState({ isGatewayRunning });
+const operationEvents = createOperationEventsService();
 
 const { requireAuth, isAuthorizedRequest } = registerAuthRoutes({
   app,
@@ -333,11 +341,6 @@ const doSyncPromptFiles = () => {
     workspaceDir: constants.WORKSPACE_DIR,
     baseUrl: setupUiUrl,
   });
-  installControlUiSkill({
-    fs,
-    openclawDir: constants.OPENCLAW_DIR,
-    baseUrl: setupUiUrl,
-  });
   installGogCliSkill({ fs, openclawDir: constants.OPENCLAW_DIR });
 };
 registerTelegramRoutes({
@@ -380,6 +383,12 @@ registerDoctorRoutes({
   requireAuth,
   doctorService,
 });
+registerAgentRoutes({
+  app,
+  agentsService,
+  restartRequiredState,
+  operationEvents,
+});
 registerProxyRoutes({
   app,
   proxy,
@@ -415,13 +424,17 @@ server.on("upgrade", (req, socket, head) => {
 server.listen(PORT, "0.0.0.0", () => {
   console.log(`[alphaclaw] Express listening on :${PORT}`);
   if (isOnboarded()) {
-    doSyncPromptFiles();
-    reloadEnv();
-    syncChannelConfig(readEnvFile());
-    ensureGatewayProxyConfig(null);
-    startGateway();
-    watchdog.start();
-    gmailWatchService.start();
+    runOnboardedBootSequence({
+      doSyncPromptFiles,
+      reloadEnv,
+      syncChannelConfig,
+      readEnvFile,
+      ensureGatewayProxyConfig,
+      resolveSetupUrl,
+      startGateway,
+      watchdog,
+      gmailWatchService,
+    });
   } else {
     console.log("[alphaclaw] Awaiting onboarding via Setup UI");
   }

package/lib/setup/core-prompts/AGENTS.md

@@ -21,14 +21,15 @@ Before diving into implementation, share your plan when the work is **significan
 
 If any of these apply, outline your approach first — what you intend to do, in what order, and any trade-offs you see — then **wait for the user's sign-off** before proceeding. For straightforward, low-risk tasks, just get it done.
 
-### Show Your Work (IMPORTANT)
+### Save and Show Your Work (IMPORTANT)
 
-Mandatory: Anytime you add, edit, or remove files/resources, end your message with a **Changes committed** summary.
+Your `.openclaw` directory is version-controlled and this is how work survives container restarts.
 
-Use workspace-relative paths only for local files (no absolute paths). Include all internal resources (files, config, cron jobs, skills) and external resources (third-party pages, databases, integrations) that were created, modified, or removed.
+Anytime you add, edit, or remove workspace files, openclaw.json, cron.json, skills, or external resources (third-party pages, databases, integrations), **commit and push your changes to git**. Never force push; always pull first if there might be remote changes.
+
+Whenever you do this, end your message with a **Changes committed** summary. Use workspace-relative paths for local files.
 
 ```
-Changes committed ([abc1234](commit url)): <-- linked commit hash
+Changes committed ([abc1234](commit url)): <-- linked abbreviated hash, no backticks
 • path/or/resource (new|edit|delete) — brief description
 ```
-

package/lib/setup/core-prompts/TOOLS.md

@@ -23,14 +23,7 @@ Changes to env vars are made through the **Envars** tab (`{{SETUP_UI_URL}}#envar
 
 ### Google Workspace
 
-Google Workspace is connected via the **General** tab (`{{SETUP_UI_URL}}#general`). The user provides OAuth client credentials from Google Cloud Console, then authorizes access to the services they need (Gmail, Calendar, Drive, Sheets, Docs, Tasks, Contacts, Meet).
-
-## Git Discipline
-
-**Commit and push after every set of changes.** Your entire .openclaw directory (config, cron, workspace) is version controlled. This is how your work survives container restarts.
-
-Never force push. Always pull before pushing if there might be remote changes.
-After pushing, include a link to the commit using the abbreviated hash: [abc1234](https://github.com/owner/repo/commit/abc1234) format. No backticks.
+Google Workspace is connected via the **General** tab (`{{SETUP_UI_URL}}#general`). The user provides OAuth client credentials from Google Cloud Console, then authorizes access to the services they need (Gmail, Calendar, Drive, Sheets, Docs, Tasks, Contacts, Meet). Connected accounts and `gog` CLI usage are covered by the gog-cli skill.
 
 ## Telegram Formatting
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrysb/alphaclaw",
-  "version": "0.5.5",
+  "version": "0.5.7-beta.0",
   "publishConfig": {
     "access": "public"
   },

package/lib/setup/skills/control-ui/SKILL.md

@@ -1,62 +0,0 @@
----
-name: alphaclaw
-description: Know when and how to direct the user to the AlphaClaw UI for configuration tasks.
----
-
-# AlphaClaw UI
-
-There is a web-based Setup UI at `{{BASE_URL}}`. The **user** manages runtime configuration through it. You should NOT call these API endpoints yourself or write config files directly — instead, tell the user what they need to do and where to do it.
-
-## When to direct the user to the UI
-
-### Adding or changing environment variables
-
-When the user needs to add a new API key, token, or any env var:
-
-> You can add that in your Setup UI → **Envars** tab: {{BASE_URL}}#envars
-
-### Connecting a new channel (Telegram, Discord)
-
-> Add your bot token in the Setup UI → **Envars** tab ({{BASE_URL}}#envars), then approve the pairing request in the **General** tab ({{BASE_URL}}#general).
-
-### Approving or rejecting pairings
-
-When a user asks about pairing their Telegram or Discord account:
-
-> Open the Setup UI → **General** tab ({{BASE_URL}}#general). Pending pairing requests appear automatically — click **Approve** or **Reject**.
-
-### Connecting OpenAI Codex OAuth
-
-> Connect or reconnect Codex OAuth from the Setup UI → **Providers** tab ({{BASE_URL}}#providers). Click **Connect Codex OAuth** and follow the popup flow.
-
-### Connecting Google Workspace
-
-> Set up Google Workspace from the Setup UI → **General** tab ({{BASE_URL}}#general, Google section). You'll need your OAuth client credentials from Google Cloud Console.
-
-Supported Google services (user selects which to enable during OAuth):
-
-| Service  | Read            | Write            | Google API                     |
-| -------- | --------------- | ---------------- | ------------------------------ |
-| Gmail    | `gmail:read`    | `gmail:write`    | `gmail.googleapis.com`         |
-| Calendar | `calendar:read` | `calendar:write` | `calendar-json.googleapis.com` |
-| Drive    | `drive:read`    | `drive:write`    | `drive.googleapis.com`         |
-| Sheets   | `sheets:read`   | `sheets:write`   | `sheets.googleapis.com`        |
-| Docs     | `docs:read`     | `docs:write`     | `docs.googleapis.com`          |
-| Tasks    | `tasks:read`    | `tasks:write`    | `tasks.googleapis.com`         |
-| Contacts | `contacts:read` | `contacts:write` | `people.googleapis.com`        |
-| Meet     | `meet:read`     | `meet:write`     | `meet.googleapis.com`          |
-
-Default enabled: Gmail (read), Calendar (read+write), Drive (read), Sheets (read), Docs (read).
-
-The `gog` CLI is available to verify Google API access:
-
-```bash
-gog auth list --plain
-gog gmail labels list --account user@gmail.com
-gog calendar calendars --account user@gmail.com
-gog drive ls --account user@gmail.com
-gog sheets metadata SPREADSHEET_ID --account user@gmail.com
-gog contacts list --account user@gmail.com
-```
-
-Config lives at `/data/.openclaw/gogcli/`.