matrix-openclaw-bot/AGENTS.md

PROJECT M - OpenClaw Matrix Bot

AI Agent 專用文檔，描述項目結構和開發指南

項目概述

屬性	內容
代號	PROJECT M
類型	Matrix Bot
核心功能	自動登錄、Token 同步、邀請響應、問候發送

目錄結構

openclaw-matrix-uplife-bot/
├── src/                      # 源代碼
│   ├── main.py              # 主入口
│   ├── config.py            # 配置管理
│   └── services/
│       ├── matrix_service.py  # Matrix 服務
│       └── token_manager.py   # Token 管理器
├── tests/                    # 單元測試
├── references/               # 參考代碼（只讀）
│   └── matrix-bot-chat-reference/
├── docker-compose.yml        # Docker 配置
└── README.md

關鍵配置

• Token JSON Key: channels.matrix.accessToken
• OpenClaw 路徑: ~/.openclaw/openclaw.json

開發命令

# 啟動
docker compose up -d

# 停止
docker compose down

# 測試
pytest tests/ -v

安全協議

1. 更新 Token 前必須備份
2. 使用沙箱測試
3. 密碼僅通過環境變量傳入

參考資料

• references/matrix-bot-chat-reference/ - 舊版 Matrix Bot 代碼
• matrix-nio 文檔