OpenClaw

Connecter Obsidian et Linear avec OpenClaw : Cas Réel Research

Avant : du contexte recopié à chaque session. Après : un agent qui lit Obsidian, suit Linear et signale la review. Jason Cyr montre son setup OpenClaw complet.

La Pince

09 août 2026 — 5 min de lecture

Bon dimanche ! ☕

Aujourd'hui, on plonge dans un cas réel qui touche un problème très concret : comment éviter que son agent reparte de zéro à chaque conversation. Le setup publié par Jason Cyr relie Obsidian, Linear, un canal de messagerie et OpenClaw pour construire un assistant qui lit le contexte, prend du travail, produit un artefact et laisse une trace exploitable.

C'est un système de travail personnel, documenté publiquement, avec des templates et une boucle opérationnelle assez claire pour être reproduite.

🎯 Le Cas : Un Agent avec Mémoire de Travail

Auteur : Jason Cyr (source GitHub)
Contexte : designer et créateur de contenu qui veut relier notes, tâches et conversations au lieu de recopier le même contexte dans chaque prompt.
Objectif : transformer OpenClaw en coéquipier persistant capable de lire Obsidian, suivre Linear, notifier dans Slack ou un autre canal, et maintenir l'état des projets.

📖 L'Histoire

Le problème de départ est familier : les assistants IA sont puissants pendant une session, puis amnésiques à la suivante. Pour un travail créatif ou produit, cette amnésie coûte cher. Il faut reposter les guidelines, rappeler les décisions, résumer l'état du projet, expliquer où se trouvent les fichiers, puis recommencer quelques jours plus tard.

Jason Cyr décrit son système comme "the exact system I use every day". L'idée centrale est simple : ne pas demander à l'agent de tout garder en mémoire interne. On lui donne plutôt un espace de travail lisible et modifiable, puis des règles strictes pour écrire ce qui compte. Obsidian devient le cerveau partagé, Linear structure le travail, Slack sert de couche temps réel, OpenClaw fait le lien.

La première version utile n'a pas besoin d'être spectaculaire. Elle peut commencer par un vault Obsidian organisé, un AGENTS.md, un PROJECT_CONTEXT.md par projet, et une convention : tout ce qui doit survivre à une session doit être écrit dans un fichier. C'est presque banal, mais c'est justement ce qui rend le cas intéressant. La continuité ne vient pas d'un prompt magique, elle vient d'un système de dossiers, de statuts et de rituels.

La boucle finale ressemble à une petite équipe : l'humain crée une issue Linear, l'assigne à l'agent, l'agent lit les notes pertinentes, produit un brouillon dans Obsidian, passe l'issue en review, puis envoie un message. Dans l'exemple donné, le workflow sert à produire le script d'une vidéo YouTube de 10 à 12 minutes : contexte de chaîne, anciennes performances, guidelines, draft, feedback, itération.

🔧 Le Setup Technique

Architecture Agent

Le système repose sur quatre couches :

Humain
  ├─ Obsidian : notes, projets, daily logs, contexte long terme
  ├─ Linear : backlog, assignation, statuts, review
  ├─ Slack ou autre canal : demandes rapides, notifications, check-ins
  └─ OpenClaw : agent persistant, fichiers de personnalité, outils et intégrations

Le point fort de cette architecture est la séparation des responsabilités. Obsidian conserve la connaissance, Linear garde la file de travail visible, le canal de messagerie gère l'interaction rapide, et OpenClaw orchestre sans enfermer toute la logique dans une seule conversation.

Fichiers Clés

SOUL.md

# SOUL.md — Who You Are

## Core Truths

**Be genuinely helpful, not performatively helpful.**
**Have opinions.**
**Be resourceful before asking.**
**Earn trust through competence.**

## Boundaries

- Private things stay private
- When in doubt, ask before acting externally
- You're not the user's voice

Ce fichier ne liste pas des commandes. Il fixe le comportement attendu : chercher avant de demander, être prudent avec les actions externes, et travailler avec une personnalité stable.

AGENTS.md

## Memory

- Daily notes (`memory/YYYY-MM-DD.md`) — raw logs
- Long-term memory (`MEMORY.md`) — curated insights
- Project context (`PROJECT_CONTEXT.md` per project)

**Write it down.** Don't keep mental notes.

Le passage décisif est là : "Write it down." Dans un système agentique, la mémoire fiable est souvent un protocole d'écriture plus qu'une base vectorielle sophistiquée.

PROJECT_CONTEXT.md

# [Project Name]

**Status:** [Not Started / In Progress / In Review / Done]
**Target:** [Deadline or milestone]

## Summary
## Key Decisions
## Current State
## Linear Issues
## Files & Artifacts
## Notes

Ce template rend un projet récupérable à froid. Un humain ou un agent peut rouvrir le dossier et comprendre l'objectif, les décisions et les artefacts sans relire tout l'historique.

Étapes de Mise en Place

Installer OpenClaw :

npm install -g openclaw

Initialiser le workspace :

openclaw init

Créer ou choisir un vault Obsidian, idéalement avec une structure stable :

My Vault/
├── 1. Projects/
├── 2. Areas/
├── 3. Resources/
├── 4. Archive/
├── Daily Notes/
└── AGENTS.md

Ajouter un PROJECT_CONTEXT.md dans chaque projet actif.
Connecter le modèle :

openclaw config set anthropic.apiKey YOUR_API_KEY

Déclarer le chemin du vault dans la configuration ou dans TOOLS.md :

### Obsidian Vault
- Path: /path/to/your/obsidian/vault
- System: PARA
- Daily Notes: Daily Notes/YYYY-MM-DD.md

Connecter le canal de communication choisi : Slack dans le cas de Jason, mais Discord, Telegram, WhatsApp, Signal, iMessage ou Google Chat peuvent jouer le même rôle si l'intégration OpenClaw est disponible.
Brancher Linear via OAuth et webhooks, puis utiliser une convention de statuts :

Backlog -> Todo -> In Progress -> In Review -> Done

Inscrire la règle de synchronisation dans AGENTS.md :

Every time you work on a project:
1. Update PROJECT_CONTEXT.md
2. Update Linear
3. Notify via Slack

📊 Les Résultats

Gains mesurés :

Moins de contexte recopié : notes, guidelines et décisions vivent déjà dans Obsidian.
Boucle de review plus nette : Linear indique ce qui est en cours, en review ou terminé.
Coût prévisible : Jason estime l'usage quotidien avec Claude autour de 20 à 50 dollars par mois selon l'intensité.
Workflow reproductible : le dépôt contient les templates AGENTS.md, SOUL.md, USER.md, PROJECT_CONTEXT.md, DAILY_NOTE.md et MEMORY.md.

Limites rencontrées :

L'intégration Linear demande plus qu'un simple token : OAuth, webhooks, statuts et permissions doivent être compris.
La qualité dépend fortement de la discipline documentaire. Si les notes ne sont pas maintenues, l'agent lit du bruit.
Le canal temps réel peut devenir intrusif si les check-ins ne sont pas cadrés.
Les actions externes doivent rester sous contrôle humain : poster, envoyer, publier ou représenter l'utilisateur exige une règle explicite.

🧐 Analyse Critique

✅ Ce qui est bien fait

La mémoire est matérialisée. Le setup ne fait pas semblant qu'un agent "se souvient" naturellement. Il impose des fichiers, des notes quotidiennes et un contexte projet. C'est moins glamour qu'un graphe magique, mais beaucoup plus vérifiable.
La boucle de travail est observable. Linear donne une trace : assignation, statut, commentaire, review. C'est essentiel si on veut traiter l'agent comme un collaborateur et pas seulement comme une fenêtre de chat.
Les outils restent remplaçables. Slack peut devenir Telegram ou Discord. Obsidian peut être remplacé par un autre système de fichiers ou de notes. Linear peut inspirer un équivalent Jira ou Asana. L'architecture compte plus que les marques.
Le système prévoit la prudence. Les templates disent clairement de demander avant les actions externes et de protéger le privé. C'est une bonne base pour éviter l'automatisation trop confiante.

⚠️ Points d'attention

Le vault peut devenir un dépotoir. Si l'agent écrit partout, la mémoire devient vite inutilisable. Il faut des chemins nommés, des templates stricts et une hygiène de revue.
Linear ne remplace pas le jugement. Passer une issue en review ne prouve pas que le travail est correct. Le statut doit déclencher une vérification humaine, pas l'éviter.
Les notifications doivent être sobres. Un agent proactif utile peut devenir une source de bruit. Mieux vaut deux check-ins bien pensés qu'une présence permanente.
Les secrets et données privées méritent une politique dédiée. Un vault Obsidian peut contenir beaucoup d'informations sensibles. Avant de donner un accès large, il faut décider ce que l'agent peut lire, écrire et citer.

💡 Améliorations possibles

Ajouter un dossier reviews/ ou decision-log/ pour séparer décisions validées et notes brutes.
Créer des prompts de fin de tâche qui listent fichiers modifiés, hypothèses, risques et prochaine action.
Mettre un cron OpenClaw de synthèse hebdomadaire pour condenser les daily notes vers MEMORY.md.
Définir des niveaux d'autonomie par projet : lecture seule, écriture locale, actions API internes, actions externes avec validation.

🎓 Ce qu'on en retient

Leçons clés :

La continuité d'un agent vient d'abord de conventions écrites, pas seulement du modèle.
Un bon workflow agentique relie mémoire, tâches et communication au lieu de tout faire dans le chat.
La règle "écrire ce qui compte" transforme un assistant ponctuel en système exploitable.

Pour aller plus loin :

À dimanche prochain pour un nouveau cas ! 🦞