~/.openclaw/
├── openclaw.json              # 全局系统配置
├── workspace-main/            # 主 Agent Workspace
│   ├── AGENTS.md              # 工作手册（任务流程、安全边界、输出规范）
│   ├── SOUL.md                # 性格配置（响应风格、专业领域、沟通偏好）
│   ├── USER.md                # 用户档案（偏好、技术栈、历史交互）
│   ├── IDENTITY.md            # 身份标识（名称、头像、功能标签）
│   ├── TOOLS.md               # 工具权限（白名单/黑名单/确认策略）
│   ├── memory/                # 长期记忆
│   │   ├── MEMORY.md          # 记忆入口索引
│   │   ├── projects.md        # 项目状态
│   │   ├── infra.md           # 基础设施配置速查
│   │   ├── lessons.md         # 踩坑教训（按严重程度分级）
│   │   └── YYYY-MM-DD.md      # 日志归档
│   └── sessions/              # Session 历史（可选）
├── workspace-dev/             # 开发专用 Workspace
├── workspace-work/            # 工作任务 Workspace
├── skills/                    # 系统级 Skills（全局生效）
├── cron/                      # Cron 任务配置
└── logs/                      # Gateway 日志

# 查看当前路径
openclaw config get agents.defaults.workspace

# 启动时指定
openclaw gateway start --workspace /path/to/custom/workspace

{
  agents: {
    defaults: { workspace: "~/.openclaw/workspace-main" },
    list: [
      { id: "main", default: true, workspace: "~/.openclaw/workspace-main" },
      { id: "dev", workspace: "~/.openclaw/workspace-dev" },
      { id: "ops", workspace: "~/.openclaw/workspace-ops" }
    ]
  }
}

{
  agents: {
    list: [
      { id: "main", model: { primary: "claude-opus-4-20250514" }, compaction: { reserveTokensFloor: 25000 } },
      { id: "dev",  model: { primary: "claude-sonnet-4-20250514" } },
      { id: "batch", model: { primary: "claude-haiku-4-20250514" }, compaction: { reserveTokensFloor: 10000 } }
    ]
  }
}

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace-main",
      model: { primary: "provider/claude-sonnet-4-20250514", fallbacks: ["provider/claude-haiku-4-20250514"] },
      timeoutSeconds: 600,
      compaction: {
        reserveTokensFloor: 20000,
        memoryFlush: { enabled: true, softThresholdTokens: 4000 }
      },
      heartbeat: { every: "30m", activeHours: { start: "08:00", end: "23:00" } }
    }
  },
  gateway: { port: 18789, bind: "loopback", auth: { mode: "token", token: "your-secret-token" }, reload: { mode: "hybrid" } },
  memorySearch: { enabled: true, provider: "openai", remote: { baseUrl: "https://api.siliconflow.cn/v1", apiKey: "your-api-key" }, model: "BAAI/bge-m3" }
}

ls -la ~/.openclaw/workspace-main/memory/           # 检查最后修改时间
cat ~/.openclaw/workspace-main/memory/projects.md   # 检查内容
# 直接编辑修正污染内容
openclaw gateway reload                             # 验证修正

# 归档旧日志
mkdir -p ~/.openclaw/workspace-main/memory/archive/
mv ~/.openclaw/workspace-main/memory/2025-*.md ~/.openclaw/workspace-main/memory/archive/
tar -czf ~/.openclaw/workspace-main/memory/archive-2025.tar.gz ~/.openclaw/workspace-main/memory/archive/
rm -rf ~/.openclaw/workspace-main/memory/archive/
# 更新 MEMORY.md 索引

ls -la ~/.openclaw/skills/ ~/.openclaw/workspace-main/skills/  # 确认文件存在
cat ~/.openclaw/skills/my-skill.md | head -50                  # 检查语法
openclaw logs --grep "skill\|load" --lines 50                  # 查看加载日志

#!/bin/bash
BACKUP_DIR="/var/backups/openclaw/workspace"
WORKSPACE_DIR="$HOME/.openclaw/workspace-main"
TIMESTAMP=$(date +%Y%m%d-%H%M%S)
mkdir -p "$BACKUP_DIR"

# 备份配置 + 记忆
tar -czf "$BACKUP_DIR/config-$TIMESTAMP.tar.gz" \
  "$WORKSPACE_DIR/AGENTS.md" "$WORKSPACE_DIR/SOUL.md" \
  "$WORKSPACE_DIR/USER.md" "$WORKSPACE_DIR/IDENTITY.md" "$WORKSPACE_DIR/TOOLS.md"
tar -czf "$BACKUP_DIR/memory-$TIMESTAMP.tar.gz" -C "$WORKSPACE_DIR" memory/

# 清理旧备份
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -delete

cd ~/.openclaw/workspace-main
git init
git add AGENTS.md SOUL.md USER.md IDENTITY.md TOOLS.md memory/
git commit -m "Initial workspace commit"

sudo systemctl stop openclaw-gateway
cp -r ~/.openclaw/workspace-main ~/.openclaw/workspace-main-crash-$(date +%Y%m%d-%H%M%S)
tar -xzf /var/backups/openclaw/workspace/config-XXXXXXXX.tar.gz -C ~/.openclaw/
sudo systemctl start openclaw-gateway
openclaw gateway health

#!/bin/bash
# init-workspace.sh <name>
WORKSPACE_DIR="$HOME/.openclaw/workspace-$1"
mkdir -p "$WORKSPACE_DIR/memory" "$WORKSPACE_DIR/sessions"
# 从模板复制配置文件...
chmod -R 700 "$WORKSPACE_DIR"

#!/bin/bash
# validate-workspace.sh [path]
WORKSPACE_DIR="${1:-$HOME/.openclaw/workspace-main}"
# 检查必需文件：AGENTS.md SOUL.md USER.md IDENTITY.md TOOLS.md
# 检查 memory/ 目录和 MEMORY.md
# 检查目录权限是否为 700
# 检查 memory/ 大小是否超过 500MB

{
  "name": "记忆目录清理",
  "schedule": { "kind": "every", "everyMs": 604800000 },  // 每周
  "payload": {
    "kind": "agentTurn",
    "message": "检查 memory/ 目录大小，超过 500MB 则归档 6 个月前的日志并更新索引"
  },
  "sessionTarget": "isolated",
  "delivery": { "mode": "none" }
}