La majorité de la configuration se gère depuis le panneau Paramètres du tableau de bord. La passerelle surveille config.json et config.local.json, de sorte que la plupart des changements prennent effet dès qu'ils sont enregistrés. Un champ qui nécessite encore un redémarrage s'identifie dans l'interface; le champ de commande slash Slack est le paramètre actuel qui ne prend effet qu'au démarrage et porte un badge Redémarrage requis pour appliquer les changements. Les changements d'identifiants nécessitent également un redémarrage avant que l'intégration affectée se reconnecte.
| Section | Ce que vous configurez |
|---|---|
| Overview | État rapide, heures de programmation et informations système |
| Imports | Paramètres importés depuis une autre instance |
| Chat | Mode de mémoire, modèles, comportement du compositeur, motifs de liens et délais d'expiration |
| Display | Thème, typographie, terminal et disposition |
| Voice | Fournisseur de dictée, microphone, voix TTS et vitesse |
| Notifications | Préférences de bannière et d'alertes de bureau |
| Secrets | Identifiants en écriture seule pour les intégrations gérées, notamment WakaTime |
| Shortcuts | Personnalisation des raccourcis clavier |
| Skills | Découverte des Skills et limites d'injection de déclencheurs |
| Messaging Channels | Slack, Discord, Telegram, Teams, Webex, WeCom, WeChat et autres canaux |
| Browser | Paramètres d'automatisation du navigateur |
| Computer Use | Automatisation du bureau natif |
| Remote crews | Connexions SSH, AWS SSM et Fargate |
| Security | Bac à sable, commandes refusées et gouvernance |
| Developer | Backends d'agents, télémétrie et Aperçus de fonctionnalités |
| About | Version, canal de publication et mises à jour |
L'intégration WakaTime est désactivée par défaut. Lorsqu'elle est activée, Crew envoie des signaux d'activité de programmation à WakaTime et consulte les statistiques du compte.
wakatime.enabled à true dans $KIROCREW_HOME/config.json (par défaut : ~/.kiro/crew/config.json).WAKATIME_API_KEY est stockée uniquement dans le coffre-fort; Crew ne la lit pas depuis .env ni config.json.Par défaut, la carte affiche 7 derniers jours. Choisissez Aujourd'hui, 7 derniers jours, 30 derniers jours ou 6 derniers mois pour voir le temps total de programmation, la moyenne quotidienne, les projets actifs et la répartition par langage et par projet. Exporter les heures (CSV) et Exporter les heures (JSON) téléchargent les heures regroupées par projet pour la plage de dates sélectionnée.
Obtenez une clé API dans les paramètres du compte WakaTime.
kirocrew config get kirocrew config get agent.sandbox kirocrew config set dashboard.bot_name "X" kirocrew config set --local dashboard.bot_name "X" kirocrew config edit
--local écrit dans config.local.json, dont les valeurs remplacent config.json et survivent à une mise à jour. Les deux fichiers utilisent du JSON standard; les clés omises utilisent les valeurs par défaut actuelles. Le chargeur en direct applique les changements ordinaires sans redémarrer les sessions. Lorsqu'un champ est marqué comme nécessitant un redémarrage, redémarrez après l'avoir enregistré.
{ "agent": { "approval_mode": "auto", "sandbox": "auto" }, "session": { "timeout_secs": 3600, "autocompact_pct": 70 }, "dashboard": { "default_memory_mode": "persistent" }, "skills": { "max_triggered": 0 } }
| Clé | Valeur par défaut | Signification |
|---|---|---|
agent.chat_turn_timeout_secs | 14400 | Délai maximal écoulé pour un tour de clavardage |
agent.subagent_timeout_secs | 10800 | Délai maximal écoulé pour un sous-agent |
agent.subagent_max_turns | 1000 | Budget d'appels d'outils par sous-agent, plafonné à 1000 |
agent.session_control | true | Permet aux agents admissibles de créer, lire, envoyer des messages et arrêter des sessions pairs |
agent.refusal_fallback_model | "" | Modèle utilisé pour une nouvelle tentative après un refus de filtre de contenu; vide désactive la nouvelle tentative |
session.timeout_secs | 3600 | Délai d'expiration de session inactive en secondes; 0 désactive le balayage d'inactivité |
session.autocompact_pct | 70 | Pourcentage d'utilisation du contexte qui démarre la compaction automatique |
orchestrator.max_plan_duration_seconds | 7200 | Limite de l'ensemble du plan pour les plans d'exécution automatique sans supervision; 0 la supprime |
agent.sandbox | "auto" | Posture normale du bac à sable pour les sous-processus d'agent |
agent.sandbox_allow_unsandboxed_exec | false | Autorise l'exécution sans bac à sable uniquement lorsque explicitement activé |
dashboard.default_memory_mode | "persistent" | Mode de mémoire pour les nouveaux chats du tableau de bord : persistent, incognito ou temporary |
dashboard.model_picker_hidden_models | [] | Modèles masqués par Modèles sélectionnables; Auto et le modèle actif restent visibles |
dashboard.link_patterns | [] | Paires d'expression régulière JavaScript et modèle d'URL absolue utilisées par les Motifs de liens texte |
dashboard.terminal.completion.enabled | true | Active la saisie semi-automatique des commandes et des chemins dans le terminal |
skills.max_triggered | 0 | Nombre maximum de Skills correspondants injectés par message; 0 désactive l'injection de déclencheurs, pas la découverte |
wakatime.enabled | false | Active le rapport des heures de programmation après que la clé API est stockée dans le coffre-fort de secrets |
telemetry.enabled | false | Active les métriques locales de latence et de taux de défaillance; elles ne les exportent pas |
auto_update | true | Vérifie les mises à jour des installations source au démarrage et toutes les douze heures |
instances.enabled | false | Active la gestion des équipes distantes et multi-instances |
instances.warm_set_cap | 0 | Limite de tunnels actifs fixe; 0 la dimensionne automatiquement, plafonnée à 8 |
capabilities.publish | Désactivée | Capacité de gouvernance pour la publication publique d'artefacts |
publish.allowed_destinations | [] | Fournisseurs autorisés sous le plafond de gouvernance de publication |
Activez Paramètres → Développeur → Aperçus de fonctionnalités → Décisions (Jev) uniquement après avoir examiné la destination et les catégories de données indiquées sur la carte. Le consentement est stocké en dehors de config.json, de sorte qu'un agent ne peut pas activer le transfert en modifiant les paramètres.
Activer le commutateur principal n'arme pas chaque comportement. Choisissez Auto (Jev) dans le sélecteur de modèle d'un chat pour le routage de modèle par tour, et Auto (Jev) sur le bouton d'envoi actif pour les décisions Diriger-ou-Mettre-en-file. La sélection automatique de Skills nécessite également skills.max_triggered supérieur à zéro; ce paramètre active globalement l'injection de déclencheurs par message, pas seulement Jev. Le filtrage de la mémoire rappelée et les mesures optionnelles de risque d'outil et de compaction ont chacun leur propre commutateur de consentement.
Paramètres pertinents :
| Clé | Valeur par défaut | Signification |
|---|---|---|
decisions.bucket | 100 | Pourcentage des sessions autrement admissibles incluses dans l'échantillon stable |
decisions.history_budget_chars | 0 | Nombre maximum de caractères de conversation antérieure envoyés avec une décision; 0 n'en envoie aucun |
decisions.model_route.simple | "" | Modèle pour les messages que Jev classe comme simples; vide conserve le modèle actuel |
decisions.model_route.medium | "" | Modèle pour les messages moyens |
decisions.model_route.complex | "" | Modèle pour les messages complexes |
Une sélection concrète de modèle l'emporte toujours sur Auto (Jev). Les tâches planifiées, les sous-agents, les requêtes d'application et les tours d'équipes distantes conservent leurs propres paramètres de modèle.
Choisissez un thème, une typographie et une langue d'interface dans Paramètres → Affichage. L'interface est disponible en anglais, allemand, espagnol, français, italien, portugais, russe, hindi, bengali, chinois, coréen et japonais. La langue de réponse de l'agent suit votre conversation plutôt que ce paramètre d'affichage.
Les identifiants des canaux se trouvent dans le coffre-fort de secrets chiffré ou dans ~/.kiro/crew/.env, pas dans config.json. Configurez-les dans Paramètres → Canaux de messagerie. Le fichier .env est lisible et modifiable uniquement par son propriétaire.
| Variable | Valeur par défaut | Objectif |
|---|---|---|
KIROCREW_HOME | ~/.kiro/crew | Répertoire de données pour la configuration, la mémoire, les journaux et les identifiants |
KIROCREW_PORT | 5476 | Port de la passerelle |
KIROCREW_CREW_LOG | non définie | Définissez à 1 et redémarrez pour enregistrer le journal Crew en ajout seulement et le registre de session facultatifs |
Définissez-les avant de démarrer la passerelle. Utilisez --port pour remplacer KIROCREW_PORT pour une seule invocation.
L'état persistant réside sous ~/.kiro/crew/, sauf si KIROCREW_HOME pointe ailleurs. Consultez Installation pour la disposition des répertoires.
Configuration