核心檔案
| 檔案 | 用途 | 加載時機 |
|---|---|---|
| AGENTS.md | 身份定義、行為邊界、回覆風格（system prompt 的文件版） | 每次 Session 啟動 |
| SOUL.md | 不可變人格內核 | 每次 Session 啟動 |
| USER.md | 用戶結構化資訊：稱呼、偏好、關係 | Main session 啟動 |
| MEMORY.md | 長期記憶，Agent 主動寫入的持久化事實 | 僅 main session |
| HEARTBEAT.md | 定時任務與主動行為（例如每 30 分鐘檢查任務） | Gateway 啟動 |
| memory/ | Daily Logs 目錄，append-only | 讀取今日 + 昨日 |
| skills/ | 工作區級技能，優先級最高 | Session 啟動掃描 |
| sessions.json | 會話元數據 | 按需讀取 |
★所有配置都是純 Markdown 或 JSON。你可以直接用文本編輯器修改，不需要任何專用工具。這是 OpenClaw 哲學的體現：一切皆文本。
用戶識別三層機制
DM Pairing：預設認證
- ▸陌生人首次私聊 → Agent 回覆 6 位一次性配對碼
- ▸訊息掛起，所有後續訊息也會等待
- ▸主人在已配對渠道輸入配對碼批准或拒絕
⚠關閉 DM Pairing 意味著任何知道你 WhatsApp / Telegram 號碼的人都可無限制使用你的 Agent 和 API 額度。
白名單：allowFrom
# AGENTS.md
allowFrom:
- telegram:123456789
- whatsapp:+8613800138000
- discord:user#1234群組規則：requireMention
- ▸預設只回應 @Agent 名稱的訊息
- ▸可切換 always 模式（會大量消耗 token）
- ▸命令：/activation mention|always
Session 隔離
| 場景 | Session 行為 | MEMORY.md |
|---|---|---|
| 私聊 (DM) | 所有已配對用戶折疊到共享 main session | 加載 |
| 群組 | 每個群組獨立隔離 session | 不加載 |
| 跨渠道 | 同一用戶的 Telegram 和 WhatsApp 共享 main session | 加載 |