From 176e862431f36ad0b8d0cf3970765100e5473dd8 Mon Sep 17 00:00:00 2001
From: nyk <93952610+0xNyk@users.noreply.github.com>
Date: Sat, 14 Mar 2026 16:29:24 +0700
Subject: [PATCH] fix(ui): improve agent panel empty state with discovery hints
(#348)
Replace the unhelpful "POST /api/agents with X-Api-Key header" message
with a user-friendly hint explaining that agents are auto-discovered
from Claude, Codex, and Hermes directories, and that gateway mode shows
registered agents.
Adds missing noAgentsHint translation key across all 10 locales.
Closes #321
---
messages/ar.json | 1 +
messages/de.json | 1 +
messages/en.json | 1 +
messages/es.json | 1 +
messages/fr.json | 1 +
messages/ja.json | 1 +
messages/ko.json | 1 +
messages/pt.json | 1 +
messages/ru.json | 1 +
messages/zh.json | 1 +
src/components/panels/agent-squad-panel-phase3.tsx | 1 -
11 files changed, 10 insertions(+), 1 deletion(-)
diff --git a/messages/ar.json b/messages/ar.json
index 8e198d2..f0c2f19 100644
--- a/messages/ar.json
+++ b/messages/ar.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ إضافة وكيل",
"refresh": "تحديث",
"noAgents": "لم يُعثر على وكلاء",
+ "noAgentsHint": "يتم اكتشاف الوكلاء المحليين تلقائيًا من أدلة Claude و Codex و Hermes. في وضع البوابة، سيظهر هنا أيضًا الوكلاء المسجلون في بوابة OpenClaw الخاصة بك.",
"addFirstAgent": "أضف وكيلك الأول للبدء",
"session": "الجلسة",
"totalTasks": "إجمالي المهام",
diff --git a/messages/de.json b/messages/de.json
index 3feae57..e9c74f3 100644
--- a/messages/de.json
+++ b/messages/de.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ Agent hinzufügen",
"refresh": "Aktualisieren",
"noAgents": "Keine Agenten gefunden",
+ "noAgentsHint": "Lokale Agenten werden automatisch aus den Claude-, Codex- und Hermes-Verzeichnissen erkannt. Im Gateway-Modus werden auch beim OpenClaw-Gateway registrierte Agenten hier angezeigt.",
"addFirstAgent": "Fügen Sie Ihren ersten Agenten hinzu, um zu beginnen",
"session": "Sitzung",
"totalTasks": "Aufgaben gesamt",
diff --git a/messages/en.json b/messages/en.json
index cde3798..fcb57d7 100644
--- a/messages/en.json
+++ b/messages/en.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ Add Agent",
"refresh": "Refresh",
"noAgents": "No agents found",
+ "noAgentsHint": "Local agents are auto-discovered from Claude, Codex, and Hermes directories. In gateway mode, agents registered with your OpenClaw gateway will also appear here.",
"addFirstAgent": "Add your first agent to get started",
"session": "Session",
"totalTasks": "Total Tasks",
diff --git a/messages/es.json b/messages/es.json
index 58b4eba..0003eb1 100644
--- a/messages/es.json
+++ b/messages/es.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ Agregar agente",
"refresh": "Actualizar",
"noAgents": "No se encontraron agentes",
+ "noAgentsHint": "Los agentes locales se descubren automáticamente desde los directorios de Claude, Codex y Hermes. En modo gateway, los agentes registrados en tu gateway OpenClaw también aparecerán aquí.",
"addFirstAgent": "Agrega tu primer agente para comenzar",
"session": "Sesión",
"totalTasks": "Tareas totales",
diff --git a/messages/fr.json b/messages/fr.json
index 5df21f8..315b2b1 100644
--- a/messages/fr.json
+++ b/messages/fr.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ Ajouter un agent",
"refresh": "Actualiser",
"noAgents": "Aucun agent trouvé",
+ "noAgentsHint": "Les agents locaux sont découverts automatiquement depuis les répertoires Claude, Codex et Hermes. En mode passerelle, les agents enregistrés sur votre passerelle OpenClaw apparaîtront également ici.",
"addFirstAgent": "Ajoutez votre premier agent pour commencer",
"session": "Session",
"totalTasks": "Tâches totales",
diff --git a/messages/ja.json b/messages/ja.json
index 20426f8..3d5a489 100644
--- a/messages/ja.json
+++ b/messages/ja.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ エージェントを追加",
"refresh": "更新",
"noAgents": "エージェントが見つかりません",
+ "noAgentsHint": "ローカルエージェントは Claude、Codex、Hermes のディレクトリから自動検出されます。ゲートウェイモードでは、OpenClaw ゲートウェイに登録されたエージェントもここに表示されます。",
"addFirstAgent": "最初のエージェントを追加して開始",
"session": "セッション",
"totalTasks": "タスク総数",
diff --git a/messages/ko.json b/messages/ko.json
index a323a45..6be6b9e 100644
--- a/messages/ko.json
+++ b/messages/ko.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ 에이전트 추가",
"refresh": "새로 고침",
"noAgents": "에이전트를 찾을 수 없습니다",
+ "noAgentsHint": "로컬 에이전트는 Claude, Codex, Hermes 디렉토리에서 자동으로 검색됩니다. 게이트웨이 모드에서는 OpenClaw 게이트웨이에 등록된 에이전트도 여기에 표시됩니다.",
"addFirstAgent": "첫 번째 에이전트를 추가하여 시작하세요",
"session": "세션",
"totalTasks": "총 작업",
diff --git a/messages/pt.json b/messages/pt.json
index 35ab18d..acc2e4b 100644
--- a/messages/pt.json
+++ b/messages/pt.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ Adicionar agente",
"refresh": "Atualizar",
"noAgents": "Nenhum agente encontrado",
+ "noAgentsHint": "Agentes locais são descobertos automaticamente dos diretórios Claude, Codex e Hermes. No modo gateway, agentes registrados no seu gateway OpenClaw também aparecerão aqui.",
"addFirstAgent": "Adicione seu primeiro agente para começar",
"session": "Sessão",
"totalTasks": "Total de tarefas",
diff --git a/messages/ru.json b/messages/ru.json
index a93f04d..664adff 100644
--- a/messages/ru.json
+++ b/messages/ru.json
@@ -1527,6 +1527,7 @@
"addAgent": "+ Добавить агента",
"refresh": "Обновить",
"noAgents": "Агенты не найдены",
+ "noAgentsHint": "Локальные агенты автоматически обнаруживаются из каталогов Claude, Codex и Hermes. В режиме шлюза здесь также будут отображаться агенты, зарегистрированные на вашем шлюзе OpenClaw.",
"addFirstAgent": "Добавьте первого агента для начала работы",
"session": "Сессия",
"totalTasks": "Всего задач",
diff --git a/messages/zh.json b/messages/zh.json
index 6b66927..abce579 100644
--- a/messages/zh.json
+++ b/messages/zh.json
@@ -1749,6 +1749,7 @@
"addAgent": "+ 添加代理",
"refresh": "刷新",
"noAgents": "未找到代理",
+ "noAgentsHint": "本地代理会从 Claude、Codex 和 Hermes 目录自动发现。在网关模式下，注册到 OpenClaw 网关的代理也会显示在此处。",
"addFirstAgent": "添加您的第一个代理以开始使用",
"session": "会话",
"totalTasks": "任务总数",
diff --git a/src/components/panels/agent-squad-panel-phase3.tsx b/src/components/panels/agent-squad-panel-phase3.tsx
index 0385236..ff6a25d 100644
--- a/src/components/panels/agent-squad-panel-phase3.tsx
+++ b/src/components/panels/agent-squad-panel-phase3.tsx
@@ -385,7 +385,6 @@ export function AgentSquadPanelPhase3() {
{t('noAgentsHint')}
- POST /api/agents with X-Api-Key header
) : (