Visionneuse TOTP locale pour Openclaw

Consultez et gérez des codes 2FA temporels sur un PC Linux avec un petit script Python sans dépendances.

maebahesioru
v1.0.0
Oct 13, 2026
0
51
0

Installer & Télécharger

1. ClawHub CLI

Le moyen le plus rapide d'installer une compétence directement depuis le registre.

npx clawhub@latest install local-totp-viewer

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<project>/skills/

Priorité : Espace de travail > Local > Intégré

3. Installation du prompt

Copiez ce prompt dans OpenClaw pour l'installer automatiquement.

Aide-moi à installer local-totp-viewer via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).

Vous préférez télécharger ?

Obtenez les fichiers bruts de la compétence dans une archive ZIP.

Qu'est-ce que Visionneuse TOTP locale ?

La visionneuse TOTP locale génère des mots de passe à usage unique temporels conformes à la RFC 6238 et les affiche en direct dans un terminal. Vous pouvez ainsi accéder aux codes 2FA sur un PC sans téléphone ni application d’authentification externe. Ce flux de travail d’Openclaw Skills explique également comment enregistrer des secrets à partir de valeurs Base32 ou d’URI otpauth:\/\/, ainsi que supprimer des comptes enregistrés.

Le script utilise la bibliothèque standard Python et stocke les noms des comptes et les secrets dans ~\/.2fa_secrets.json. Lors de l’enregistrement, il définit les permissions du fichier sur 600. Il s’agit d’un outil local simple, et non d’une application d’authentification complète : protégez le fichier de secrets, évitez de partager les secrets dans les conversations ou les journaux, et saisissez chaque code avant la fin de sa fenêtre de validité de 30 secondes.

Cas d'utilisation de Visionneuse TOTP locale

  • Afficher des codes 2FA sur un bureau Linux lorsque le téléphone est indisponible ou peu pratique.
  • Migrer des comptes de Google Authenticator vers un flux de travail local sur ordinateur.
  • Récupérer des codes à usage unique dans un processus sans interface graphique ou CLI où une personne confirme et saisit chaque code.
  • Ajouter un compte TOTP à partir d’un secret Base32 ou d’une URI otpauth:\/\/.
  • Répertorier les comptes enregistrés localement ou supprimer un compte devenu inutile.

Comment fonctionne Visionneuse TOTP locale

  1. Exécutez le script Python monofichier sans argument pour charger les secrets enregistrés et actualiser en continu les codes affichés.
  2. Pour ajouter un compte, indiquez un secret Base32 et un nom de compte, ou transmettez une URI otpauth:\/\/ ; le script ajoute le secret à son stockage JSON local.
  3. Le script calcule un code à partir du secret et du compteur temporel actuel, puis affiche le code ainsi que le nombre de secondes restantes dans la fenêtre de 30 secondes.
  4. Utilisez l’option de liste pour afficher les noms des comptes enregistrés ou l’option de suppression pour retirer un compte du stockage.
  5. Pour migrer depuis Google Authenticator, exportez les comptes, décodez la charge utile du QR, extrayez et encodez chaque secret en Base32, puis enregistrez les comptes un par un dans la visionneuse.

Configuration de Visionneuse TOTP locale

  1. Vérifiez que Python 3 est disponible sur le PC Linux.
  2. Enregistrez le script Python inclus dans la skill sous ~\/2fa_view.py. La visionneuse elle-même utilise uniquement la bibliothèque standard Python ; le décodage QR est une étape distincte et facultative pour la migration.
  3. Enregistrez un compte et lancez la visionneuse en direct avec des commandes telles que :
python3 ~\/2fa_view.py BASE32_SECRET account-name
python3 ~\/2fa_view.py
  1. Vous pouvez également enregistrer une URI otpauth:\/\/ prise en charge, répertorier les comptes ou en supprimer un :
python3 ~\/2fa_view.py 'otpauth:\/\/totp\/Example?secret=BASE32_SECRET&issuer=Example'
python3 ~\/2fa_view.py -l
python3 ~\/2fa_view.py -r account-name
  1. Pour migrer depuis Google Authenticator, exportez les comptes depuis l’application et décodez le QR de migration obtenu. La skill décrit l’utilisation d’une bibliothèque QR telle que pyzbar ; celle-ci n’est pas une dépendance à l’exécution de la visionneuse. Analysez le protobuf de migration, encodez chaque secret en Base32 et enregistrez les comptes individuellement.
  2. Avant de vous fier au script, comparez le calcul TOTP au vecteur de test RFC 6238 avec un banc de test configuré selon l’horodatage du vecteur et une sortie à huit chiffres. L’affichage normal de la visionneuse utilise six chiffres et une période de 30 secondes.

Schéma de données et taxonomie de Visionneuse TOTP locale

La visionneuse stocke les données dans ~\/.2fa_secrets.json sous la forme d’un objet JSON associant les libellés de compte à des chaînes de secrets Base32. Exemple :

{
  "account-name": "BASE32_SECRET"
}
  • Emplacement du fichier : ~\/.2fa_secrets.json dans le répertoire personnel de l’utilisateur actuel.
  • Permissions du fichier : Définies sur 600 lorsque le script enregistre le fichier ; gardez les secrets confidentiels et vérifiez les permissions si le fichier est créé ou modifié en dehors du script.
  • Libellés de compte : L’enregistrement direct utilise le nom de compte fourni. L’enregistrement par URI crée un libellé à partir de l’émetteur et des six premiers caractères du secret ; le script ne conserve pas l’ensemble des métadonnées de l’URI.
  • Données générées : Les codes TOTP sont calculés à l’exécution et affichés dans le terminal ; ils ne sont pas stockés comme enregistrements de compte.
  • Champs de migration : Le processus d’export Google Authenticator décrit extrait du protobuf de migration chaque secret, le nom du compte, l’émetteur, l’algorithme, le nombre de chiffres et le type OTP. Le chemin d’enregistrement par URI de la visionneuse stocke uniquement le secret et utilise ses paramètres intégrés de six chiffres et 30 secondes ; vérifiez donc la compatibilité des comptes utilisant des paramètres non standard.
  • Attention lors de l’affichage de la liste : La commande -l affiche les huit premiers caractères de chaque secret ainsi que le nom du compte. Évitez de partager cette sortie.

Fonctionnalités avancées de Visionneuse TOTP locale

  • Actualise en continu tous les codes enregistrés dans un terminal et affiche le nombre de secondes restantes dans la fenêtre actuelle de 30 secondes.
  • Permet d’ajouter directement des secrets à partir de valeurs Base32 ou d’URI otpauth:\/\/.
  • Fournit des opérations CLI simples pour répertorier les comptes et supprimer un compte nommé.
  • Documente une méthode de migration depuis l’export otpauth-migration:\/\/ de Google Authenticator, avec décodage QR et extraction des champs protobuf ; le décodage QR n’est pas intégré à la visionneuse.
  • Utilise un stockage JSON local et les fonctions HMAC, de hachage, Base32 et temporelles de la bibliothèque standard, sans dépendance à l’exécution envers des paquets tiers.
  • Fournit des conseils de sécurité pour protéger le fichier de secrets, éviter leur exposition dans les transcriptions et attendre une nouvelle fenêtre temporelle plutôt que de réessayer un code expiré.

SKILL.md


Chargement

Compétences Openclaw associées

En vedette*