feat: Dashboard Backend Proxy – OpenClaw Gateway Integration

- DashboardController: /api/dashboard/status, agents, operations, chat/send, chat/messages, queue
- OpenClawGatewayClient: typed HttpClient mit Gateway tools/invoke
- Dashboard DTOs: DashboardAgentInfo, ChatRequest, ChatResponse, FeedEntry, QueueItem
- Gateway auth: Bearer-Password via Integrations:OpenClaw:Password
- Gateway-Down → graceful degradation (HTTP 200, leere Daten)
- Build: 0 errors, Tests: 3/3 passed

backend/Controllers/DashboardController.cs

@@ -0,0 +1,208 @@
+using Microsoft.AspNetCore.Mvc;
+using Nexus.Api.Models;
+using Nexus.Api.Services;
+
+namespace Nexus.Api.Controllers;
+
+[ApiController]
+[Route("api/dashboard")]
+public class DashboardController(OpenClawGatewayClient gateway, ILogger<DashboardController> logger)
+    : ControllerBase
+{
+    /// <summary>
+    /// Gateway health + session_status + subagents count.
+    /// Returns HTTP 200 even when gateway is down (gatewayOk: false).
+    /// </summary>
+    [HttpGet("status")]
+    public async Task<DashboardStatus> GetStatus()
+    {
+        try
+        {
+            return await gateway.GetStatusAsync();
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard status check failed");
+            return new DashboardStatus(false, "Offline", 0, 0);
+        }
+    }
+
+    /// <summary>
+    /// Returns all agents with their current status.
+    /// Combines sessions_list + sub_agents_list.
+    /// </summary>
+    [HttpGet("agents")]
+    public async Task<List<DashboardAgentInfo>> GetAgents()
+    {
+        try
+        {
+            return await gateway.GetAgentsAsync();
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard agents fetch failed");
+            return new List<DashboardAgentInfo>();
+        }
+    }
+
+    /// <summary>
+    /// Returns the latest assistant messages (operations/feed) from the Iris session.
+    /// Filtered to role == "assistant" — those are the work feed entries.
+    /// </summary>
+    [HttpGet("operations")]
+    public async Task<List<FeedEntry>> GetOperations([FromQuery] int limit = 20)
+    {
+        try
+        {
+            var messages = await gateway.GetSessionHistoryAsync("iris", Math.Clamp(limit, 1, 100));
+            var feed = new List<FeedEntry>();
+
+            foreach (var msg in messages)
+            {
+                if (!string.Equals(msg.Role, "assistant", StringComparison.OrdinalIgnoreCase))
+                    continue;
+
+                if (string.IsNullOrWhiteSpace(msg.Content))
+                    continue;
+
+                // Parse timestamp for display-friendly "time ago"
+                var ts = ParseTimestamp(msg.Timestamp);
+                var timeAgo = FormatTimeAgo(ts);
+
+                // Extract a short agent indicator and action from content
+                var (agent, action) = ExtractAgentAction(msg.Content);
+
+                feed.Add(new FeedEntry(agent, action, msg.Timestamp, timeAgo));
+            }
+
+            return feed;
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard operations fetch failed");
+            return new List<FeedEntry>();
+        }
+    }
+
+    /// <summary>
+    /// Send a chat message to the Iris session.
+    /// </summary>
+    [HttpPost("chat/send")]
+    public async Task<ChatResponse> SendChat([FromBody] ChatRequest request)
+    {
+        if (string.IsNullOrWhiteSpace(request.Message))
+            return new ChatResponse(false, null, "Message is required");
+
+        try
+        {
+            var sessionKey = string.IsNullOrWhiteSpace(request.SessionKey)
+                ? "iris"
+                : request.SessionKey.Trim();
+
+            return await gateway.SendChatMessageAsync(sessionKey, request.Message.Trim());
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard chat send failed");
+            return new ChatResponse(false, null, "Gateway nicht erreichbar");
+        }
+    }
+
+    /// <summary>
+    /// Returns chat messages (user + assistant only, not tool messages).
+    /// </summary>
+    [HttpGet("chat/messages")]
+    public async Task<List<MessageEntry>> GetMessages(
+        [FromQuery] string? sessionKey,
+        [FromQuery] int limit = 50,
+        [FromQuery] int offset = 0)
+    {
+        try
+        {
+            var key = string.IsNullOrWhiteSpace(sessionKey) ? "iris" : sessionKey.Trim();
+            var messages = await gateway.GetSessionHistoryAsync(key, Math.Clamp(limit, 1, 200), Math.Max(0, offset));
+
+            // Filter: only user and assistant messages (exclude tool/system)
+            return messages
+                .Where(m => string.Equals(m.Role, "user", StringComparison.OrdinalIgnoreCase)
+                         || string.Equals(m.Role, "assistant", StringComparison.OrdinalIgnoreCase))
+                .ToList();
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard messages fetch failed");
+            return new List<MessageEntry>();
+        }
+    }
+
+    /// <summary>
+    /// Returns the cron queue / pending tasks.
+    /// </summary>
+    [HttpGet("queue")]
+    public async Task<List<QueueItem>> GetQueue()
+    {
+        try
+        {
+            return await gateway.GetQueueAsync();
+        }
+        catch (Exception ex)
+        {
+            logger.LogWarning(ex, "Dashboard queue fetch failed");
+            return new List<QueueItem>();
+        }
+    }
+
+    // ========== Helpers ==========
+
+    private static DateTimeOffset ParseTimestamp(string timestamp)
+    {
+        if (DateTimeOffset.TryParse(timestamp, null, System.Globalization.DateTimeStyles.None, out var dt))
+            return dt;
+        return DateTimeOffset.UtcNow;
+    }
+
+    private static string FormatTimeAgo(DateTimeOffset ts)
+    {
+        var diff = DateTimeOffset.UtcNow - ts;
+        if (diff.TotalMinutes < 1) return "just now";
+        if (diff.TotalMinutes < 60) return $"{(int)diff.TotalMinutes}m ago";
+        if (diff.TotalHours < 24) return $"{(int)diff.TotalHours}h ago";
+        if (diff.TotalDays < 7) return $"{(int)diff.TotalDays}d ago";
+        return ts.ToString("MMM dd");
+    }
+
+    private static (string Agent, string Action) ExtractAgentAction(string content)
+    {
+        // Take first line or first ~80 chars as the action summary
+        var firstLine = content.Split('\n', 2)[0].Trim();
+        var summary = firstLine.Length > 80 ? firstLine[..80] + "…" : firstLine;
+
+        // Try to identify which agent this came from
+        var agent = "Iris";
+        foreach (var marker in new[] { "**Agent:**", "**Agent:** ", "*Agent:* ", "Agent:" })
+        {
+            var idx = content.IndexOf(marker, StringComparison.OrdinalIgnoreCase);
+            if (idx >= 0)
+            {
+                var after = content[(idx + marker.Length)..].TrimStart();
+                var end = after.IndexOfAny(['\n', '\r', ',', '.']);
+                var found = end > 0 ? after[..end].Trim() : after.Split('\n', 2)[0].Trim();
+                if (!string.IsNullOrWhiteSpace(found) && found.Length < 30)
+                {
+                    agent = found;
+                    break;
+                }
+            }
+        }
+
+        // Try to find agent name at the start in brackets like [Agent: Iris]
+        if (agent == "Iris")
+        {
+            var bracketMatch = System.Text.RegularExpressions.Regex.Match(content, @"\[Agent:\s*([^\]]+)\]");
+            if (bracketMatch.Success)
+                agent = bracketMatch.Groups[1].Value.Trim();
+        }
+
+        return (agent, summary);
+    }
+}

backend/Models/Dashboard.cs

@@ -0,0 +1,47 @@
+namespace Nexus.Api.Models;
+
+public sealed record DashboardAgentInfo(
+    string Id,
+    string Name,
+    string Role,
+    string Model,
+    bool IsActive,
+    string? CurrentTask
+);
+
+public sealed record MessageEntry(
+    string Role,
+    string Content,
+    string Timestamp
+);
+
+public sealed record ChatRequest(
+    string Message,
+    string? SessionKey
+);
+
+public sealed record ChatResponse(
+    bool Ok,
+    string? Reply,
+    string? Error
+);
+
+public sealed record FeedEntry(
+    string Agent,
+    string Action,
+    string Timestamp,
+    string Time
+);
+
+public sealed record DashboardStatus(
+    bool GatewayOk,
+    string IrisStatus,
+    int ActiveAgents,
+    int PendingTasks
+);
+
+public sealed record QueueItem(
+    string Id,
+    string Name,
+    string Status
+);

backend/Program.cs

@@ -112,6 +112,13 @@ builder.Services.AddHttpClient("gateway", client =>
     client.Timeout = TimeSpan.FromSeconds(5);
 });
 
+builder.Services.AddHttpClient<OpenClawGatewayClient>(client =>
+{
+    client.BaseAddress = new(builder.Configuration["Integrations:OpenClaw:BaseUrl"]
+        ?? "http://127.0.0.1:18789");
+    client.Timeout = TimeSpan.FromSeconds(5);
+});
+
 // --- Application Services ---
 builder.Services.AddTransient<ModelRoutingService>();
 builder.Services.AddScoped<IAuthService, AuthService>();

backend/Services/OpenClawGatewayClient.cs

@@ -0,0 +1,269 @@
+using System.Net.Http.Headers;
+using System.Net.Http.Json;
+using System.Text.Json;
+using System.Text.Json.Nodes;
+using Nexus.Api.Models;
+
+namespace Nexus.Api.Services;
+
+public sealed class OpenClawGatewayClient(HttpClient httpClient, IConfiguration configuration)
+{
+    private static readonly JsonSerializerOptions JsonOptions = new()
+    {
+        PropertyNameCaseInsensitive = true,
+        PropertyNamingPolicy = JsonNamingPolicy.CamelCase
+    };
+
+    private string? GetPassword()
+    {
+        var password = configuration["Integrations:OpenClaw:Password"];
+        if (string.IsNullOrWhiteSpace(password))
+            password = configuration["Integrations:OpenClaw:Token"];
+        return string.IsNullOrWhiteSpace(password) ? null : password;
+    }
+
+    private void ApplyAuth(HttpRequestMessage request)
+    {
+        var password = GetPassword();
+        if (password is not null)
+            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", password);
+    }
+
+    public async Task<JsonNode?> InvokeToolAsync(string tool, object? args = null)
+    {
+        try
+        {
+            using var request = new HttpRequestMessage(HttpMethod.Post, "/tools/invoke");
+            ApplyAuth(request);
+
+            var body = new Dictionary<string, object?> { ["tool"] = tool };
+            if (args is not null)
+                body["args"] = args;
+
+            request.Content = JsonContent.Create(body);
+
+            using var response = await httpClient.SendAsync(request);
+            if (!response.IsSuccessStatusCode)
+                return null;
+
+            var json = await response.Content.ReadAsStringAsync();
+            if (string.IsNullOrWhiteSpace(json))
+                return null;
+
+            return JsonNode.Parse(json);
+        }
+        catch
+        {
+            return null;
+        }
+    }
+
+    public async Task<List<DashboardAgentInfo>> GetAgentsAsync()
+    {
+        var agents = new List<DashboardAgentInfo>();
+
+        // Get sessions list (active agents/sessions)
+        var sessionsResult = await InvokeToolAsync("sessions_list");
+        if (sessionsResult is not null)
+        {
+            var sessions = sessionsResult.AsArray();
+            if (sessions is not null)
+            {
+                foreach (var session in sessions)
+                {
+                    if (session is null) continue;
+                    var id = session["sessionKey"]?.GetValue<string>() ?? session["id"]?.GetValue<string>() ?? "";
+                    var name = session["name"]?.GetValue<string>() ?? id;
+                    var model = session["model"]?.GetValue<string>() ?? "";
+                    var status = session["status"]?.GetValue<string>() ?? "";
+                    var isActive = status.Equals("active", StringComparison.OrdinalIgnoreCase);
+
+                    agents.Add(new DashboardAgentInfo(
+                        Id: id,
+                        Name: name,
+                        Role: DeriveRole(id),
+                        Model: model,
+                        IsActive: isActive,
+                        CurrentTask: session["currentTask"]?.GetValue<string>()
+                    ));
+                }
+            }
+        }
+
+        // Also get subagents list
+        var subagentsResult = await InvokeToolAsync("sub_agents_list");
+        if (subagentsResult is not null && subagentsResult is JsonArray subArray)
+        {
+            foreach (var sub in subArray)
+            {
+                if (sub is null) continue;
+                var id = sub["id"]?.GetValue<string>() ?? "";
+                if (agents.Any(a => a.Id == id)) continue;
+
+                var name = sub["name"]?.GetValue<string>() ?? id;
+                var model = sub["model"]?.GetValue<string>() ?? "";
+                var status = sub["status"]?.GetValue<string>() ?? "";
+                var isActive = status.Equals("active", StringComparison.OrdinalIgnoreCase) ||
+                               status.Equals("running", StringComparison.OrdinalIgnoreCase);
+
+                agents.Add(new DashboardAgentInfo(
+                    Id: id,
+                    Name: name,
+                    Role: DeriveRole(id),
+                    Model: model,
+                    IsActive: isActive,
+                    CurrentTask: sub["currentTask"]?.GetValue<string>()
+                ));
+            }
+        }
+
+        return agents.Count > 0 ? agents : new List<DashboardAgentInfo>();
+    }
+
+    public async Task<List<MessageEntry>> GetSessionHistoryAsync(string sessionKey, int limit = 50, int offset = 0)
+    {
+        try
+        {
+            var result = await InvokeToolAsync("sessions_history", new
+            {
+                sessionKey,
+                limit,
+                offset
+            });
+
+            if (result is null)
+                return new List<MessageEntry>();
+
+            var messages = new List<MessageEntry>();
+            var array = result as JsonArray ?? result.AsArray();
+            if (array is null) return messages;
+
+            foreach (var msg in array)
+            {
+                if (msg is null) continue;
+                var role = msg["role"]?.GetValue<string>() ?? "";
+                var content = msg["content"]?.GetValue<string>() ?? "";
+                var timestamp = msg["timestamp"]?.GetValue<string>()
+                    ?? msg["ts"]?.GetValue<string>()
+                    ?? msg["createdAt"]?.GetValue<string>()
+                    ?? DateTimeOffset.UtcNow.ToString("o");
+
+                messages.Add(new MessageEntry(role, content, timestamp));
+            }
+
+            return messages;
+        }
+        catch
+        {
+            return new List<MessageEntry>();
+        }
+    }
+
+    public async Task<ChatResponse> SendChatMessageAsync(string sessionKey, string message)
+    {
+        try
+        {
+            var result = await InvokeToolAsync("sessions_send", new
+            {
+                sessionKey,
+                message
+            });
+
+            if (result is null)
+                return new ChatResponse(false, null, "Gateway nicht erreichbar");
+
+            var ok = result["ok"]?.GetValue<bool>() ?? result["success"]?.GetValue<bool>() ?? false;
+            var reply = result["reply"]?.GetValue<string>()
+                ?? result["response"]?.GetValue<string>()
+                ?? result["content"]?.GetValue<string>();
+            var error = result["error"]?.GetValue<string>();
+
+            return new ChatResponse(ok, reply, error);
+        }
+        catch (Exception ex)
+        {
+            return new ChatResponse(false, null, $"Fehler: {ex.Message}");
+        }
+    }
+
+    public async Task<List<QueueItem>> GetQueueAsync()
+    {
+        try
+        {
+            var result = await InvokeToolAsync("cron_list");
+            if (result is null)
+                return new List<QueueItem>();
+
+            var items = new List<QueueItem>();
+            var array = result as JsonArray ?? result.AsArray();
+            if (array is null) return items;
+
+            foreach (var entry in array)
+            {
+                if (entry is null) continue;
+                var id = entry["id"]?.GetValue<string>() ?? "";
+                var name = entry["name"]?.GetValue<string>() ?? id;
+                var status = entry["status"]?.GetValue<string>() ?? "unknown";
+
+                items.Add(new QueueItem(id, name, status));
+            }
+
+            return items;
+        }
+        catch
+        {
+            return new List<QueueItem>();
+        }
+    }
+
+    public async Task<DashboardStatus> GetStatusAsync()
+    {
+        var gatewayOk = false;
+        var irisStatus = "Offline";
+        var activeAgents = 0;
+        var pendingTasks = 0;
+
+        try
+        {
+            // Check gateway health
+            using var pingRequest = new HttpRequestMessage(HttpMethod.Get, "/");
+            ApplyAuth(pingRequest);
+            using var pingResponse = await httpClient.SendAsync(pingRequest);
+            gatewayOk = pingResponse.IsSuccessStatusCode;
+
+            if (gatewayOk)
+            {
+                // Get session status
+                var sessionResult = await InvokeToolAsync("session_status");
+                if (sessionResult is not null)
+                {
+                    irisStatus = sessionResult["status"]?.GetValue<string>() ?? "Active";
+                }
+
+                // Get agents for active count
+                var agents = await GetAgentsAsync();
+                activeAgents = agents.Count(a => a.IsActive);
+
+                // Get queue/cron for pending tasks
+                var queue = await GetQueueAsync();
+                pendingTasks = queue.Count;
+            }
+        }
+        catch
+        {
+            gatewayOk = false;
+        }
+
+        return new DashboardStatus(gatewayOk, irisStatus, activeAgents, pendingTasks);
+    }
+
+    private static string DeriveRole(string agentId) => agentId.ToLowerInvariant() switch
+    {
+        "iris" => "Orchestrator",
+        "programmer" => "Developer",
+        "reviewer" => "Reviewer",
+        "architekt" => "Architect",
+        "main" => "Assistant",
+        _ => "Custom"
+    };
+}