git clone https://github.com/fshaan/claw-ea.git
cd claw-ea && uv sync

帮我安装 claw-ea 插件：

1. 拉代码装依赖：
   cd ~/Workspace/devs && git clone https://github.com/fshaan/claw-ea.git claw_EA
   cd claw_EA && uv sync

2. 装 OpenClaw 插件（仓库里带着的）：
   cp -r openclaw-plugin ~/.openclaw/extensions/claw-ea
   cd ~/.openclaw/extensions/claw-ea && npm install

3. 注册到 ~/.openclaw/openclaw.json：
   - "plugins.allow" 加 "claw-ea"
   - "plugins.entries" 加：
   "claw-ea": {
     "enabled": true,
     "config": {
       "pythonPath": "<HOME>/Workspace/devs/claw_EA/.venv/bin/python",
       "projectDir": "<HOME>/Workspace/devs/claw_EA"
     }
   }
   - "plugins.installs" 加：
   "claw-ea": {
     "source": "path",
     "installPath": "<HOME>/.openclaw/extensions/claw-ea",
     "version": "<VERSION>"
   }
   <HOME> 换成实际路径。<VERSION> 读取项目根目录的 VERSION 文件内容（如 `cat VERSION`）。

4. 建配置目录 mkdir -p ~/.claw-ea，
   然后创建 ~/.claw-ea/config.yaml，填用户名、vault 路径、日历名、提醒列表。
   用 detect_obsidian_vault 和 list_apple_calendars 工具查可用选项。

5. ⛔ 配 agent 行为（必做，不可跳过，更新时也要重新执行）：
   读取项目目录下的 openclaw-plugin/PROMPT_TEMPLATE.md，
   将其中的 AGENTS.md 片段完整写入 ~/.openclaw/workspace/AGENTS.md，
   将 TOOLS.md 片段完整写入 ~/.openclaw/workspace/TOOLS.md。
   如果已有 claw-ea 段落则替换，没有则追加。
   这一步定义了消息分类规则和工具调用顺序，跳过会导致工作流错误。

6. 重启 OpenClaw: openclaw restart

1. cd <项目目录> && git pull
2. 复制插件文件：
   cp openclaw-plugin/index.ts ~/.openclaw/extensions/claw-ea/index.ts
   cp openclaw-plugin/src/tools.ts ~/.openclaw/extensions/claw-ea/src/tools.ts
3. 更新 ~/.openclaw/openclaw.json 中 plugins.installs.claw-ea.version 为 VERSION 文件的内容
4. 重新执行上面的步骤 5（读 PROMPT_TEMPLATE.md，更新 AGENTS.md 和 TOOLS.md）
5. 重启 OpenClaw: openclaw restart

# ~/.mcporter/mcporter.json 里加：
# "claw-ea": { "command": ".../.venv/bin/python", "args": ["-m", "claw_ea.server"], "cwd": "..." }

mcporter call claw-ea.detect_obsidian_vault

{
  "mcpServers": {
    "claw-ea": {
      "command": "/path/to/claw_EA/.venv/bin/python",
      "args": ["-m", "claw_ea.server"],
      "cwd": "/path/to/claw_EA"
    }
  }
}

user:
  name: 张医生              # 排班表和议程里匹配你名字用的
  aliases: [张三, Dr. Zhang] # 英文名、简称

obsidian:
  vault_path: ~/Obsidian/my-vault
  notes_folder: Inbox/OpenClaw    # vault 下的相对路径

attachments:
  base_path: ~/Obsidian/my-vault/attachments/OpenClaw
  organize_by_date: true

apple:
  calendar_name: 工作              # 日历 App 里必须已有这个日历
  reminder_list: OpenClaw          # 提醒事项 App 里必须已有这个列表

categories:
  surgery:
    schedule_time_slots:
      1: "09:00"    # 第 1 台
      2: "13:00"    # 第 2 台
      3: "17:00"    # 第 3 台
      4: "20:00"    # 第 4 台（急诊/加台）
    user_roles: [主刀, 带组, 一助]

uv sync --dev
uv run pytest                    # 跑全部测试
uv run pytest -m "not macos"     # 不跑 macOS API 的测试