| name | cognitive-brain |
| description | Cognitive Brain |
๐ง Cognitive Brain
่ทจไผ่ฏ่ฎฐๅฟไธ่ฎค็ฅ็ณป็ป | Cross-Session Memory & Cognition System
่ฎฉ AI ๆฅๆๅไบบ็ฑปไธๆ ท็่ฎฐๅฟใๆ่ๅ้ขๆต่ฝๅ
Version: 2.7.2 | License: MIT
โจ ๅ่ฝ็นๆง | Features
| ๅ่ฝ | Feature | ๆ่ฟฐ |
|---|
| ๐ ๅฎๆถๅ
ฑไบซ | Real-time Sharing | ่ทจไผ่ฏๆฏซ็ง็บง่ฎฐๅฟๅๆญฅ |
| ๐ง ๅๅฑ่ฎฐๅฟ | Four-Layer Memory | ๆๅฎ/ๅทฅไฝ/ๆ
ๆฏ/่ฏญไน่ฎฐๅฟๆถๆ |
| ๐ญ ่ช็ฑๆ่ | Free Thinking | ้ไปปๅก้ฉฑๅจ็ๆ่ฏๆตๆ่ |
| ๐ฎ ๆบ่ฝ้ขๆต | Prediction | ้ขๆต็จๆท้ๆฑ๏ผ้ขๅ ่ฝฝ่ฎฐๅฟ |
| ๐ ๅฏ่งๅ | Visualization | ็ฅ่ฏๅพ่ฐฑใๆถ้ด็บฟใๆ่ฆ |
| ๐ ่ๆณ็ฝ็ป | Association Network | ๆฆๅฟตๅ
ณ่๏ผๆฟๆดปๆฉๆฃ็ฎๆณ |
๐ ๅฟซ้ๅผๅง | Quick Start
ๅฎ่ฃ
| Installation
clawhub install cognitive-brain
cd ~/.openclaw/workspace/skills
git clone <repository> cognitive-brain
cd cognitive-brain && npm install
ๅบ็กไฝฟ็จ | Basic Usage
node scripts/brain.cjs encode "็จๆท็้กน็ฎๅซ Alpha"
node scripts/brain.cjs recall "้กน็ฎ"
node scripts/brain.cjs health_check
๐๏ธ ๆถๆๆฆ่ง | Architecture
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅบ็จๅฑ | Application โ
โ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โ
โ โ ๅฟ่ทณๅๆ โ โ ่ช็ฑๆ่ โ โ ้ขๆต้ขๅ ่ฝฝ โ โ
โ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅฎๆถๅฑ | Real-time (Redis) โ
โ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โ
โ โ Pub/Sub โ โ ๅทฅไฝ่ฎฐๅฟ โ โ ๅ
ฑไบซไธไธๆ โ โ
โ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆไน
ๅฑ | Persistence (PostgreSQL) โ
โ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โ
โ โ ็ณป็ป่ฎฐๅฟ โ โ ๆ
ๆฏ่ฎฐๅฟ โ โ ่ฏญไน่ฎฐๅฟ โ โ
โ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ง ๅๅฑ่ฎฐๅฟๆจกๅ | Four-Layer Memory
| ๅฑ็บง | Layer | ๆ็ปญๆถ้ด | ็จ้ |
|---|
| ๆๅฎ่ฎฐๅฟ | Sensory | ๆฏซ็ง็บง | ็ฌๆถๆ็ฅ็ผๅฒ |
| ๅทฅไฝ่ฎฐๅฟ | Working | ๅ้~ๅฐๆถ | ๆดป่ทๅค็ๅทฅไฝๅบ |
| ๆ
ๆฏ่ฎฐๅฟ | Episodic | ้ฟๆ | ไธชไบบ็ปๅใไบไปถ |
| ่ฏญไน่ฎฐๅฟ | Semantic | ้ฟๆ | ไบๅฎใๆฆๅฟตใ็ฅ่ฏ |
๐ ๅ
ฑไบซๅทฅไฝๅบ | Shared Workspace
ๆ ธๅฟ่กจ | Core Tables
| ่กจๅ | Table | ่ฏดๆ |
|---|
system_memory | System Memory | ๆฟไปฃ MEMORY.md๏ผ่ทจไผ่ฏๅ
ฑไบซ |
shared_context | Shared Context | ไผ่ฏ้ดไธดๆถไธไธๆ |
memory_changes | Memory Changes | ๅๆดๆฅๅฟ๏ผๅฎๆถ่ฟฝ่ธช |
ไฝฟ็จ็คบไพ | Usage
node scripts/shared_memory.cjs set "user_name" "master" profile
node scripts/shared_memory.cjs user
node scripts/shared_memory.cjs lessons
๐ง ๆ ธๅฟๆจกๅ | Core Modules
่ฎฐๅฟๆไฝ | Memory Operations
node scripts/encode.cjs --content "ๅ
ๅฎน" --metadata '{"type":"fact"}'
node scripts/recall.cjs --query "ๅ
ณ้ฎ่ฏ" --options '{"limit":5}'
node scripts/associate.cjs spread "ๆฆๅฟตA,ๆฆๅฟตB"
ๆ่ไธๅๆ | Thinking & Reflection
node scripts/heartbeat_reflect.cjs check
node scripts/free_think.cjs think
ๅฏ่งๅ | Visualization
node scripts/visualize.cjs mermaid > graph.md
node scripts/visualize.cjs html > graph.html
node scripts/timeline.cjs recent 7
๐ Hook ้ๆ | OpenClaw Hooks
cognitive-recall
่งฆๅไบไปถ | Event: message:preprocessed
ๅ่ฝ | Functions:
- ๅนถ่กๆฃ็ดข่ฎฐๅฟ + ๆ่ฎญ + ้ขๆต
- ๆณจๅ
ฅไธไธๆๅฐๆถๆฏ
- ่ชๅจ็ผ็ ็จๆทๆถๆฏ
ๆณจๅ
ฅๆ ผๅผ | Injection Format:
[๐ฎ ้ขๆต]
็จๆทๅฏ่ฝ็ไธไธๆญฅ้ๆฑ
[/้ขๆต]
[๐ง Memory Context]
็ธๅ
ณ่ฎฐๅฟๅ
ๅฎน
[/Memory Context]
[โ ๏ธ ๆ่ฎญๆ้]
็ณป็ป็บงๅซๆ่ฎญ
[/ๆ่ฎญๆ้]
โ๏ธ ้
็ฝฎ | Configuration
็ณป็ป่ฆๆฑ | Requirements
| ็ปไปถ | ็ๆฌ |
|---|
| Node.js | >= 18.0 |
| PostgreSQL | >= 14.0 (้่ฆ pgvector) |
| Redis | >= 6.0 (ๅฏ้) |
| Python | >= 3.8 (็จไบๆฌๅฐ Embedding) |
config.json
{
"storage": {
"primary": {
"type": "postgresql",
"host": "localhost",
"port": 5432,
"database": "cognitive_brain",
"user": "postgres",
"password": "cognitive123"
},
"cache": {
"type": "redis",
"host": "localhost",
"port": 6379
}
},
"embedding": {
"provider": "local",
"dimension":
๐ API ๅ่ | API Reference
SharedMemory ็ฑป
| ๆนๆณ | ่ฏดๆ |
|---|
getSystemMemory(key) | ่ทๅ็ณป็ป่ฎฐๅฟ |
setSystemMemory(key, content, category) | ่ฎพ็ฝฎ็ณป็ป่ฎฐๅฟ |
getUserProfile() | ่ทๅ็จๆทๆกฃๆก |
getLessons() | ่ทๅๆๆๆ่ฎญ |
setSharedContext(sessionId, type, content) | ่ฎพ็ฝฎๅ
ฑไบซไธไธๆ |
onChange(callback) | ็ๅฌๅๆด |
๐ง ๆ
้ๆ้ค | Troubleshooting
ๅธธ่ง้ฎ้ข | Common Issues
| ้ฎ้ข | ่งฃๅณๆนๆก |
|---|
| ๆฐๆฎๅบ่ฟๆฅๅคฑ่ดฅ | ๆฃๆฅ PostgreSQL ๆๅก็ถๆ |
| Embedding ๅ ่ฝฝๆ
ข | ่ฟ่ก warmup_embedding.cjs serve |
| Hook ไธ็ๆ | ๅคๅถ handler.js ๅฐ OpenClaw hooks ็ฎๅฝ |
| ่ทจไผ่ฏไธๅๆญฅ | ็กฎไฟๆๆไผ่ฏไฝฟ็จ็ธๅๆฐๆฎๅบ้
็ฝฎ |
๐ ๆดๆฐๆฅๅฟ | Changelog
v2.7.1 (2026-03-13)
- ไผๅ SKILL.md ๆๆกฃ็ปๆ
- ไธญ่ฑๆๅ่ฏญๆฏๆ
v2.7.0 (2026-03-13)
- ๅ
ฑไบซๅทฅไฝๅบ๏ผPostgreSQL NOTIFY ๅฎๆถๅๆญฅ
- system_memory ่กจๆฟไปฃ MEMORY.md
v2.6.0 (2026-03-13)
- ็ฅ่ฏๅพ่ฐฑๅฏ่งๅ
- ้ขๆตไธ้ขๅ ่ฝฝ
v2.5.0 (2026-03-13)
- ่ช็ฑๆ่ๆจกๅ
- ๅ็ฆปๆถ้ไธๆ่ๆถๆ
๐ ่ฎธๅฏ่ฏ | License
MIT License
๐ค ไฝ่
| Author
AI Self-Design
๐ ้พๆฅ | Links