import AppKit import Observation import OpenClawDiscovery import OpenClawIPC import OpenClawKit import SwiftUI struct GeneralSettings: View { @Bindable var state: AppState @AppStorage(cameraEnabledKey) private var cameraEnabled: Bool = false private let healthStore = HealthStore.shared private let gatewayManager = GatewayProcessManager.shared @State private var gatewayDiscovery = GatewayDiscoveryModel( localDisplayName: InstanceIdentity.displayName) @State private var gatewayStatus: GatewayEnvironmentStatus = .checking @State private var remoteStatus: RemoteStatus = .idle @State private var showRemoteAdvanced = false private let isPreview = ProcessInfo.processInfo.isPreview private var isNixMode: Bool { ProcessInfo.processInfo.isNixMode } private var remoteLabelWidth: CGFloat { 88 } var body: some View { ScrollView(.vertical) { VStack(alignment: .leading, spacing: 18) { VStack(alignment: .leading, spacing: 12) { SettingsToggleRow( title: "OpenClaw active", subtitle: "Pause to stop the OpenClaw gateway; no messages will be processed.", binding: self.activeBinding) self.connectionSection Divider() SettingsToggleRow( title: "Launch at login", subtitle: "Automatically start OpenClaw after you sign in.", binding: self.$state.launchAtLogin) SettingsToggleRow( title: "Show Dock icon", subtitle: "Keep OpenClaw visible in the Dock instead of menu-bar-only mode.", binding: self.$state.showDockIcon) SettingsToggleRow( title: "Play menu bar icon animations", subtitle: "Enable idle blinks and wiggles on the status icon.", binding: self.$state.iconAnimationsEnabled) SettingsToggleRow( title: "Allow Canvas", subtitle: "Allow the agent to show and control the Canvas panel.", binding: self.$state.canvasEnabled) SettingsToggleRow( title: "Allow Camera", subtitle: "Allow the agent to capture a photo or short video via the built-in camera.", binding: self.$cameraEnabled) SettingsToggleRow( title: "Enable Peekaboo Bridge", subtitle: "Allow signed tools (e.g. `peekaboo`) to drive UI automation via PeekabooBridge.", binding: self.$state.peekabooBridgeEnabled) SettingsToggleRow( title: "Enable debug tools", subtitle: "Show the Debug tab with development utilities.", binding: self.$state.debugPaneEnabled) } Spacer(minLength: 12) HStack { Spacer() Button("Quit OpenClaw") { NSApp.terminate(nil) } .buttonStyle(.borderedProminent) } } .frame(maxWidth: .infinity, alignment: .leading) .padding(.horizontal, 22) .padding(.bottom, 16) } .onAppear { guard !self.isPreview else { return } self.refreshGatewayStatus() } .onChange(of: self.state.canvasEnabled) { _, enabled in if !enabled { CanvasManager.shared.hideAll() } } } private var activeBinding: Binding { Binding( get: { !self.state.isPaused }, set: { self.state.isPaused = !$0 }) } private var connectionSection: some View { VStack(alignment: .leading, spacing: 10) { Text("OpenClaw runs") .font(.title3.weight(.semibold)) .frame(maxWidth: .infinity, alignment: .leading) Picker("Mode", selection: self.$state.connectionMode) { Text("Not configured").tag(AppState.ConnectionMode.unconfigured) Text("Local (this Mac)").tag(AppState.ConnectionMode.local) Text("Remote (another host)").tag(AppState.ConnectionMode.remote) } .pickerStyle(.menu) .labelsHidden() .frame(width: 260, alignment: .leading) if self.state.connectionMode == .unconfigured { Text("Pick Local or Remote to start the Gateway.") .font(.footnote) .foregroundStyle(.secondary) .fixedSize(horizontal: false, vertical: true) } if self.state.connectionMode == .local { // In Nix mode, gateway is managed declaratively - no install buttons. if !self.isNixMode { self.gatewayInstallerCard } TailscaleIntegrationSection( connectionMode: self.state.connectionMode, isPaused: self.state.isPaused) self.healthRow } if self.state.connectionMode == .remote { self.remoteCard } } } private var remoteCard: some View { VStack(alignment: .leading, spacing: 10) { self.remoteTransportRow if self.state.remoteTransport == .ssh { self.remoteSshRow } else { self.remoteDirectRow } self.remoteTokenRow GatewayDiscoveryInlineList( discovery: self.gatewayDiscovery, currentTarget: self.state.remoteTarget, currentUrl: self.state.remoteUrl, transport: self.state.remoteTransport) { gateway in self.applyDiscoveredGateway(gateway) } .padding(.leading, self.remoteLabelWidth + 10) self.remoteStatusView .padding(.leading, self.remoteLabelWidth + 10) if self.state.remoteTransport == .ssh { DisclosureGroup(isExpanded: self.$showRemoteAdvanced) { VStack(alignment: .leading, spacing: 8) { LabeledContent("Identity file") { TextField("/Users/you/.ssh/id_ed25519", text: self.$state.remoteIdentity) .textFieldStyle(.roundedBorder) .frame(width: 280) } LabeledContent("Project root") { TextField("/home/you/Projects/openclaw", text: self.$state.remoteProjectRoot) .textFieldStyle(.roundedBorder) .frame(width: 280) } LabeledContent("CLI path") { TextField("/Applications/OpenClaw.app/.../openclaw", text: self.$state.remoteCliPath) .textFieldStyle(.roundedBorder) .frame(width: 280) } } .padding(.top, 4) } label: { Text("Advanced") .font(.callout.weight(.semibold)) } } // Diagnostics VStack(alignment: .leading, spacing: 4) { Text("Control channel") .font(.caption.weight(.semibold)) if !self.isControlStatusDuplicate || ControlChannel.shared.lastPingMs != nil { let status = self.isControlStatusDuplicate ? nil : self.controlStatusLine let ping = ControlChannel.shared.lastPingMs.map { "Ping \(Int($0)) ms" } let line = [status, ping].compactMap(\.self).joined(separator: " · ") if !line.isEmpty { Text(line) .font(.caption) .foregroundStyle(.secondary) } } if let hb = HeartbeatStore.shared.lastEvent { let ageText = age(from: Date(timeIntervalSince1970: hb.ts / 1000)) Text("Last heartbeat: \(hb.status) · \(ageText)") .font(.caption) .foregroundStyle(.secondary) } if let authLabel = ControlChannel.shared.authSourceLabel { Text(authLabel) .font(.caption) .foregroundStyle(.secondary) } } if self.state.remoteTransport == .ssh { Text("Tip: enable Tailscale for stable remote access.") .font(.footnote) .foregroundStyle(.secondary) .lineLimit(1) } else { Text("Tip: use Tailscale Serve so the gateway has a valid HTTPS cert.") .font(.footnote) .foregroundStyle(.secondary) .lineLimit(2) } } .transition(.opacity) .onAppear { self.gatewayDiscovery.start() } .onDisappear { self.gatewayDiscovery.stop() } } private var remoteTransportRow: some View { HStack(alignment: .center, spacing: 10) { Text("Transport") .font(.callout.weight(.semibold)) .frame(width: self.remoteLabelWidth, alignment: .leading) Picker("Transport", selection: self.$state.remoteTransport) { Text("SSH tunnel").tag(AppState.RemoteTransport.ssh) Text("Direct (ws/wss)").tag(AppState.RemoteTransport.direct) } .pickerStyle(.segmented) .frame(maxWidth: 320) } } private var remoteSshRow: some View { let trimmedTarget = self.state.remoteTarget.trimmingCharacters(in: .whitespacesAndNewlines) let validationMessage = CommandResolver.sshTargetValidationMessage(trimmedTarget) let canTest = !trimmedTarget.isEmpty && validationMessage == nil return VStack(alignment: .leading, spacing: 4) { HStack(alignment: .center, spacing: 10) { Text("SSH target") .font(.callout.weight(.semibold)) .frame(width: self.remoteLabelWidth, alignment: .leading) TextField("user@host[:22]", text: self.$state.remoteTarget) .textFieldStyle(.roundedBorder) .frame(maxWidth: .infinity) self.remoteTestButton(disabled: !canTest) } if let validationMessage { Text(validationMessage) .font(.caption) .foregroundStyle(.red) .padding(.leading, self.remoteLabelWidth + 10) } } } private var remoteDirectRow: some View { VStack(alignment: .leading, spacing: 6) { HStack(alignment: .center, spacing: 10) { Text("Gateway") .font(.callout.weight(.semibold)) .frame(width: self.remoteLabelWidth, alignment: .leading) TextField("wss://gateway.example.ts.net", text: self.$state.remoteUrl) .textFieldStyle(.roundedBorder) .frame(maxWidth: .infinity) self.remoteTestButton( disabled: self.state.remoteUrl.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty) } Text( "Direct mode requires wss:// for remote hosts. ws:// is only allowed for localhost/127.0.0.1.") .font(.caption) .foregroundStyle(.secondary) .padding(.leading, self.remoteLabelWidth + 10) } } private var remoteTokenRow: some View { VStack(alignment: .leading, spacing: 6) { HStack(alignment: .center, spacing: 10) { Text("Gateway token") .font(.callout.weight(.semibold)) .frame(width: self.remoteLabelWidth, alignment: .leading) SecureField("remote gateway auth token (gateway.remote.token)", text: self.$state.remoteToken) .textFieldStyle(.roundedBorder) .frame(maxWidth: .infinity) } Text("Used when the remote gateway requires token auth.") .font(.caption) .foregroundStyle(.secondary) .padding(.leading, self.remoteLabelWidth + 10) if self.state.remoteTokenUnsupported { Text( "The current gateway.remote.token value is not plain text. OpenClaw for macOS cannot use it directly; enter a plaintext token here to replace it.") .font(.caption) .foregroundStyle(.orange) .padding(.leading, self.remoteLabelWidth + 10) } } } private func remoteTestButton(disabled: Bool) -> some View { Button { Task { await self.testRemote() } } label: { if self.remoteStatus == .checking { ProgressView().controlSize(.small) } else { Text("Test remote") } } .buttonStyle(.borderedProminent) .disabled(self.remoteStatus == .checking || disabled) } private var controlStatusLine: String { switch ControlChannel.shared.state { case .connected: "Connected" case .connecting: "Connecting…" case .disconnected: "Disconnected" case let .degraded(msg): msg } } @ViewBuilder private var remoteStatusView: some View { switch self.remoteStatus { case .idle: EmptyView() case .checking: Text("Testing…") .font(.caption) .foregroundStyle(.secondary) case let .ok(success): VStack(alignment: .leading, spacing: 2) { Label(success.title, systemImage: "checkmark.circle.fill") .font(.caption) .foregroundStyle(.green) if let detail = success.detail { Text(detail) .font(.caption) .foregroundStyle(.secondary) .fixedSize(horizontal: false, vertical: true) } } case let .failed(message): Text(message) .font(.caption) .foregroundStyle(.secondary) .lineLimit(2) } } private var isControlStatusDuplicate: Bool { guard case let .failed(message) = self.remoteStatus else { return false } return message == self.controlStatusLine } private var gatewayInstallerCard: some View { VStack(alignment: .leading, spacing: 8) { HStack(spacing: 10) { Circle() .fill(self.gatewayStatusColor) .frame(width: 10, height: 10) Text(self.gatewayStatus.message) .font(.callout) .frame(maxWidth: .infinity, alignment: .leading) } if let gatewayVersion = self.gatewayStatus.gatewayVersion, let required = self.gatewayStatus.requiredGateway, gatewayVersion != required { Text("Installed: \(gatewayVersion) · Required: \(required)") .font(.caption) .foregroundStyle(.secondary) } else if let gatewayVersion = self.gatewayStatus.gatewayVersion { Text("Gateway \(gatewayVersion) detected") .font(.caption) .foregroundStyle(.secondary) } if let node = self.gatewayStatus.nodeVersion { Text("Node \(node)") .font(.caption) .foregroundStyle(.secondary) } if case let .attachedExisting(details) = self.gatewayManager.status { Text(details ?? "Using existing gateway instance") .font(.caption) .foregroundStyle(.secondary) } if let failure = self.gatewayManager.lastFailureReason { Text("Last failure: \(failure)") .font(.caption) .foregroundStyle(.red) } Button("Recheck") { self.refreshGatewayStatus() } .buttonStyle(.bordered) Text("Gateway auto-starts in local mode via launchd (\(gatewayLaunchdLabel)).") .font(.caption) .foregroundStyle(.secondary) .lineLimit(2) } .padding(12) .background(Color.gray.opacity(0.08)) .cornerRadius(10) } private func refreshGatewayStatus() { Task { let status = await Task.detached(priority: .utility) { GatewayEnvironment.check() }.value self.gatewayStatus = status } } private var gatewayStatusColor: Color { switch self.gatewayStatus.kind { case .ok: .green case .checking: .secondary case .missingNode, .missingGateway, .incompatible, .error: .orange } } private var healthCard: some View { let snapshot = self.healthStore.snapshot return VStack(alignment: .leading, spacing: 6) { HStack(spacing: 8) { Circle() .fill(self.healthStore.state.tint) .frame(width: 10, height: 10) Text(self.healthStore.summaryLine) .font(.callout.weight(.semibold)) } if let snap = snapshot { let linkId = snap.channelOrder?.first(where: { if let summary = snap.channels[$0] { return summary.linked != nil } return false }) ?? snap.channels.keys.first(where: { if let summary = snap.channels[$0] { return summary.linked != nil } return false }) let linkLabel = linkId.flatMap { snap.channelLabels?[$0] } ?? linkId?.capitalized ?? "Link channel" let linkAge = linkId.flatMap { snap.channels[$0]?.authAgeMs } Text("\(linkLabel) auth age: \(healthAgeString(linkAge))") .font(.caption) .foregroundStyle(.secondary) Text("Session store: \(snap.sessions.path) (\(snap.sessions.count) entries)") .font(.caption) .foregroundStyle(.secondary) if let recent = snap.sessions.recent.first { let lastActivity = recent.updatedAt != nil ? relativeAge(from: Date(timeIntervalSince1970: (recent.updatedAt ?? 0) / 1000)) : "unknown" Text("Last activity: \(recent.key) \(lastActivity)") .font(.caption) .foregroundStyle(.secondary) } Text("Last check: \(relativeAge(from: self.healthStore.lastSuccess))") .font(.caption) .foregroundStyle(.secondary) } else if let error = self.healthStore.lastError { Text(error) .font(.caption) .foregroundStyle(.red) } else { Text("Health check pending…") .font(.caption) .foregroundStyle(.secondary) } HStack(spacing: 12) { Button { Task { await self.healthStore.refresh(onDemand: true) } } label: { if self.healthStore.isRefreshing { ProgressView().controlSize(.small) } else { Label("Run Health Check", systemImage: "arrow.clockwise") } } .disabled(self.healthStore.isRefreshing) Divider().frame(height: 18) Button { self.revealLogs() } label: { Label("Reveal Logs", systemImage: "doc.text.magnifyingglass") } } } .padding(12) .background(Color.gray.opacity(0.08)) .cornerRadius(10) } } private enum RemoteStatus: Equatable { case idle case checking case ok(RemoteGatewayProbeSuccess) case failed(String) } extension GeneralSettings { private var healthRow: some View { VStack(alignment: .leading, spacing: 6) { HStack(spacing: 10) { Circle() .fill(self.healthStore.state.tint) .frame(width: 10, height: 10) Text(self.healthStore.summaryLine) .font(.callout) .frame(maxWidth: .infinity, alignment: .leading) } if let detail = self.healthStore.detailLine { Text(detail) .font(.caption) .foregroundStyle(.secondary) .fixedSize(horizontal: false, vertical: true) } HStack(spacing: 10) { Button("Retry now") { Task { await HealthStore.shared.refresh(onDemand: true) } } .disabled(self.healthStore.isRefreshing) Button("Open logs") { self.revealLogs() } .buttonStyle(.link) .foregroundStyle(.secondary) } .font(.caption) } } @MainActor func testRemote() async { self.remoteStatus = .checking switch await RemoteGatewayProbe.run() { case let .ready(success): self.remoteStatus = .ok(success) case let .authIssue(issue): self.remoteStatus = .failed(issue.statusMessage) case let .failed(message): self.remoteStatus = .failed(message) } } private func revealLogs() { let target = LogLocator.bestLogFile() if let target { NSWorkspace.shared.selectFile( target.path, inFileViewerRootedAtPath: target.deletingLastPathComponent().path) return } let alert = NSAlert() alert.messageText = "Log file not found" alert.informativeText = """ Looked for openclaw logs in /tmp/openclaw/. Run a health check or send a message to generate activity, then try again. """ alert.alertStyle = .informational alert.addButton(withTitle: "OK") alert.runModal() } private func applyDiscoveredGateway(_ gateway: GatewayDiscoveryModel.DiscoveredGateway) { MacNodeModeCoordinator.shared.setPreferredGatewayStableID(gateway.stableID) GatewayDiscoverySelectionSupport.applyRemoteSelection(gateway: gateway, state: self.state) } } private func healthAgeString(_ ms: Double?) -> String { guard let ms else { return "unknown" } return msToAge(ms) } #if DEBUG struct GeneralSettings_Previews: PreviewProvider { static var previews: some View { GeneralSettings(state: .preview) .frame(width: SettingsTab.windowWidth, height: SettingsTab.windowHeight) .environment(TailscaleService.shared) } } @MainActor extension GeneralSettings { static func exerciseForTesting() { let state = AppState(preview: true) state.connectionMode = .remote state.remoteTransport = .ssh state.remoteTarget = "user@host:2222" state.remoteUrl = "wss://gateway.example.ts.net" state.remoteToken = "example-token" state.remoteIdentity = "/tmp/id_ed25519" state.remoteProjectRoot = "/tmp/openclaw" state.remoteCliPath = "/tmp/openclaw" let view = GeneralSettings(state: state) view.gatewayStatus = GatewayEnvironmentStatus( kind: .ok, nodeVersion: "1.0.0", gatewayVersion: "1.0.0", requiredGateway: nil, message: "Gateway ready") view.remoteStatus = .failed("SSH failed") view.showRemoteAdvanced = true _ = view.body state.connectionMode = .unconfigured _ = view.body state.connectionMode = .local view.gatewayStatus = GatewayEnvironmentStatus( kind: .error("Gateway offline"), nodeVersion: nil, gatewayVersion: nil, requiredGateway: nil, message: "Gateway offline") _ = view.body } } #endif