325 lines
9.5 KiB
Markdown
325 lines
9.5 KiB
Markdown
# 总助 Claw 快速安装配置
|
||
|
||
这份文档只解决一件事：把 assistant-claw 仓库配置成一个可运行的总助 Claw / Atlas 实例。
|
||
|
||
总助 Claw 是老板视角的项目执行雷达。它读取老板授权范围内的邮件和业务信号，维护项目、人员、客户状态，并输出日 Brief、周 Rollup、客户健康报告和 Andon 告警。
|
||
|
||
这不是"三万同款 7 Agent / 38 技能"安装包。三万架构只作为参考，不要把写作、交易、社区、多 Bot 等通用团队能力塞进总助 Claw 的快速安装流程。
|
||
|
||
## 可复制的安装配置引导词
|
||
|
||
把下面这段发给负责部署的 Agent，让它按步骤引导你完成总助 Claw 配置：
|
||
|
||
```text
|
||
请帮我配置「总助 Claw」。
|
||
|
||
这是 Moments 公司出品的老板视角项目执行雷达：1 个 Atlas Agent + 6 个专项技能 + 邮件抽取流水线。
|
||
1. 请先学习 assistant-claw QuickStart：https://git.moments.top/Moments.top/assistant-claw/src/branch/main/QUICKSTART.zh-CN.md
|
||
2. 问清：客户/老板信息、邮件接入方式、首次盘点范围、Brief 时间、告警渠道、数据边界。
|
||
3. 请按步骤引导我完成：安装 Atlas 身份文件和 skills → 初始化 state/memory/boss_skill.md → 配置 OpenClaw agents.list 和 workspace → 配置飞书 bindings → 验证。
|
||
|
||
不要拉邮件，除非我明确确认邮件权限和盘点范围。
|
||
|
||
🦞 Atlas 团队能力：
|
||
- 邮件解析
|
||
- 项目追踪
|
||
- 人员行为观察
|
||
- 客户雷达
|
||
- 老板规则蒸馏
|
||
- Brief/报告生成
|
||
|
||
请开始引导我配置吧！
|
||
```
|
||
|
||
## 安装前先确认
|
||
|
||
开始配置前，先向客户或部署负责人确认这些信息：
|
||
|
||
| 项 | 要确认什么 |
|
||
|----|------------|
|
||
| 客户公司 | 公司名、行业、规模、主要工作语言 |
|
||
| 老板信息 | 老板姓名、职位、Brief 阅读习惯 |
|
||
| 邮件权限 | IMAP / OAuth / 转发邮箱；是否允许拉取过去 12 个月邮件 |
|
||
| 首次盘点范围 | 默认过去 12 个月；如客户邮箱太大，先从 3 或 6 个月开始 |
|
||
| 输出节奏 | 日 Brief 时间，默认老板本地时间 07:30 |
|
||
| 告警渠道 | 邮件、飞书、微信机器人或仅生成报告 |
|
||
| 数据边界 | 原始邮件是否必须留在客户网络内；谁能看到 Brief |
|
||
|
||
没有这些答案时，不要开始拉邮件，也不要配置自动推送。
|
||
|
||
## 目标目录
|
||
|
||
推荐把客户实例放在 OpenClaw workspace 下：
|
||
|
||
```bash
|
||
export ATLAS_HOME="$HOME/.openclaw/workspace-atlas"
|
||
mkdir -p "$ATLAS_HOME"
|
||
```
|
||
|
||
每个客户一个独立 workspace。不要让多个客户共用同一套 `state/`、`memory/`、`boss_skill.md`。
|
||
|
||
## 第 1 步：安装 Atlas 配置资产
|
||
|
||
在 `assistant-claw` 仓库根目录执行：
|
||
|
||
```bash
|
||
cp IDENTITY.zh-CN.md "$ATLAS_HOME/IDENTITY.md"
|
||
cp SOUL.zh-CN.md "$ATLAS_HOME/SOUL.md"
|
||
cp AGENTS.zh-CN.md "$ATLAS_HOME/AGENTS.md"
|
||
cp USER.md "$ATLAS_HOME/USER.md"
|
||
cp TOOLS.md "$ATLAS_HOME/TOOLS.md"
|
||
cp MEMORY.md "$ATLAS_HOME/MEMORY.md"
|
||
cp BOOTSTRAP.md "$ATLAS_HOME/BOOTSTRAP.md"
|
||
cp HEARTBEAT.md "$ATLAS_HOME/HEARTBEAT.md"
|
||
|
||
cp -R skills "$ATLAS_HOME/skills"
|
||
cp -R mcp-tools "$ATLAS_HOME/mcp-tools"
|
||
cp -R state-schemas "$ATLAS_HOME/state-schemas"
|
||
```
|
||
|
||
说明：
|
||
|
||
- 中文部署默认使用 `*.zh-CN.md` 作为运行文件。
|
||
- `USER.md` 是客户侧配置，必须在部署时填写。
|
||
- `skills/` 是总助 Claw 专项能力，不是通用技能市场合集。
|
||
|
||
## 第 2 步：创建运行态目录
|
||
|
||
```bash
|
||
mkdir -p "$ATLAS_HOME/state/projects"
|
||
mkdir -p "$ATLAS_HOME/state/people"
|
||
mkdir -p "$ATLAS_HOME/state/customers"
|
||
mkdir -p "$ATLAS_HOME/state/runs"
|
||
mkdir -p "$ATLAS_HOME/state/unclustered"
|
||
mkdir -p "$ATLAS_HOME/state/audit"
|
||
mkdir -p "$ATLAS_HOME/state/extracted"
|
||
mkdir -p "$ATLAS_HOME/memory"
|
||
mkdir -p "$ATLAS_HOME/boss_voice"
|
||
```
|
||
|
||
初始化 `state/index.json`：
|
||
|
||
```bash
|
||
cat > "$ATLAS_HOME/state/index.json" <<'JSON'
|
||
{
|
||
"projects": [],
|
||
"people": [],
|
||
"customers": [],
|
||
"updated_at": null
|
||
}
|
||
JSON
|
||
```
|
||
|
||
初始化当天记忆：
|
||
|
||
```bash
|
||
TODAY="$(date +%F)"
|
||
cat > "$ATLAS_HOME/memory/$TODAY.md" <<EOF
|
||
# $TODAY
|
||
|
||
## 本日运行记录
|
||
|
||
- 部署初始化。
|
||
EOF
|
||
```
|
||
|
||
初始化 `boss_skill.md`：
|
||
|
||
```bash
|
||
cat > "$ATLAS_HOME/boss_skill.md" <<'EOF'
|
||
# boss_skill.md
|
||
|
||
状态：待蒸馏
|
||
|
||
首次部署后，由 `claw-boss-distiller` 读取老板过去 6 个月发出邮件，生成第一版 draft rules。
|
||
老板审核后，才能把规则标记为 confirmed。
|
||
EOF
|
||
```
|
||
|
||
## 第 3 步：填写客户配置
|
||
|
||
编辑：
|
||
|
||
```bash
|
||
$ATLAS_HOME/USER.md
|
||
```
|
||
|
||
至少填这些字段：
|
||
|
||
- Principal name
|
||
- Role
|
||
- Industry
|
||
- Company size
|
||
- Email domain
|
||
- Primary work language
|
||
- Daily email volume
|
||
- Average projects in flight
|
||
- Reads Brief on
|
||
- Tolerance for false positives
|
||
|
||
如果这些字段为空，总助 Claw 可以启动，但第一周盘点和 Brief 会缺上下文。
|
||
|
||
## 第 4 步：配置 OpenClaw Agent
|
||
|
||
修改 OpenClaw 配置前先备份：
|
||
|
||
```bash
|
||
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak.$(date +%Y%m%d-%H%M%S)
|
||
```
|
||
|
||
新增 Atlas Agent：
|
||
|
||
```bash
|
||
openclaw agents add atlas --workspace "$ATLAS_HOME"
|
||
openclaw agents list
|
||
```
|
||
|
||
如果当前环境只能有一个默认 Agent，也可以把 agent id 设为 `main`。关键是 `workspace` 必须指向 `$ATLAS_HOME`。
|
||
|
||
确认 `agents.list` 里有类似结构：
|
||
|
||
```json
|
||
{
|
||
"id": "atlas",
|
||
"name": "总助 Claw",
|
||
"workspace": "/Users/<you>/.openclaw/workspace-atlas"
|
||
}
|
||
```
|
||
|
||
总助 Claw 快速安装不需要创建 `writer`、`researcher`、`trader` 等子 Agent，也不需要配置 `subagents.allowAgents`。需要多 Agent 时，等单实例跑通后再做二期扩展。
|
||
|
||
## 第 5 步：配置飞书入口
|
||
|
||
如果使用一个飞书 Bot 接入总助 Claw，只需要把该账号绑定到 `atlas`：
|
||
|
||
```json
|
||
{
|
||
"bindings": [
|
||
{
|
||
"agentId": "atlas",
|
||
"match": {
|
||
"channel": "feishu",
|
||
"accountId": "default"
|
||
}
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
保留现有 `channels.feishu` 下的账号配置和访问策略，不要为了新增 binding 删除 `allowFrom`、`dmPolicy`、`groupPolicy` 等字段。
|
||
|
||
配置后验证：
|
||
|
||
```bash
|
||
openclaw agents list
|
||
openclaw channels status
|
||
```
|
||
|
||
多数配置支持热加载。只有状态没刷新、版本要求重启、或已经确认维护窗口时，才执行：
|
||
|
||
```bash
|
||
openclaw gateway restart
|
||
openclaw gateway status
|
||
```
|
||
|
||
## 第 6 步：配置邮件抽取工具
|
||
|
||
总助 Claw 的核心输入是邮件。V0 推荐先跑本地 email-extractor pipeline，确认能稳定解析样例，再接客户邮箱。
|
||
|
||
```bash
|
||
cd "$ATLAS_HOME/mcp-tools/email-extractor"
|
||
python3 -m venv .venv
|
||
. .venv/bin/activate
|
||
pip install -e .
|
||
pytest
|
||
```
|
||
|
||
如果测试通过，再接入客户邮件源：
|
||
|
||
- IMAP：确认 host、port、用户名、授权码、TLS 要求。
|
||
- OAuth：确认回调地址、client id、client secret、refresh token 存放位置。
|
||
- 转发邮箱：确认原始 MIME 是否保留完整 header。
|
||
|
||
不要把原始邮件复制出客户允许的网络边界。总助 Claw 的输出应引用邮件 ID 和规则，不暴露不相关客户或员工隐私。
|
||
|
||
## 第 7 步：首次启动验收
|
||
|
||
在飞书或命令入口问：
|
||
|
||
```text
|
||
你是谁？请读取你的 IDENTITY、SOUL、USER，并告诉我当前还缺哪些部署字段。
|
||
```
|
||
|
||
合格回复应满足：
|
||
|
||
- 自称总助 Claw / Atlas。
|
||
- 能说清自己是老板视角项目执行雷达。
|
||
- 明确 V0 不替老板写信、不发信、不评价员工。
|
||
- 能列出 `USER.md` 中未填写字段。
|
||
|
||
再问：
|
||
|
||
```text
|
||
请按 BOOTSTRAP.md 给出首次部署 checklist，不要开始拉邮件。
|
||
```
|
||
|
||
合格回复应输出：
|
||
|
||
- 邮件权限确认
|
||
- 历史拉取范围
|
||
- 日 Brief 时间
|
||
- Andon 告警渠道
|
||
- `state/`、`memory/`、`boss_skill.md` 初始化状态
|
||
- W1 一次性盘点计划
|
||
|
||
## 第 8 步：首次盘点流程
|
||
|
||
首次盘点不要自动全量跑。先让客户确认范围：
|
||
|
||
```text
|
||
首次盘点建议拉取过去 12 个月邮件。你的邮箱量级较大时，我建议先从 3 个月试跑，确认抽取质量和误报率后再扩展到 12 个月。请确认范围。
|
||
```
|
||
|
||
确认后按顺序执行：
|
||
|
||
1. `claw-email-parser`：拉取、解码、去引用、抽实体、分类意图。
|
||
2. `claw-project-tracker`：聚类项目，生成 `state/projects/*.json`。
|
||
3. `claw-people-observer`：生成行为观察卡，永不输出员工裁定标签。
|
||
4. `claw-customer-radar`：生成客户健康状态和风险信号。
|
||
5. `claw-report-writer`：生成第一份 Inventory Report。
|
||
6. `claw-boss-distiller`：只读取老板发出邮件，生成 `boss_skill.md` draft rules。
|
||
|
||
第一周交付物：
|
||
|
||
- 过去 3 / 6 / 12 个月项目清单
|
||
- Stalled / Waiting-For / Next Action 风险图
|
||
- 客户健康清单
|
||
- `boss_skill.md` draft，等待老板审核
|
||
|
||
## 不要放进快速安装的内容
|
||
|
||
这些不是总助 Claw 快速安装的一部分：
|
||
|
||
- 三万同款 7 Agent / 38 技能完整团队。
|
||
- 公众号、博客、小红书、交易、社区运营角色。
|
||
- 多飞书 Bot 企业版配置。
|
||
- 任意通用技能市场清单。
|
||
- 未经确认的 `sessions_spawn` 子 Agent 调度规则。
|
||
|
||
总助 Claw 的最小可用版本是一个 Atlas 实例，加上邮件抽取、项目追踪、客户雷达、人员观察、报告渲染和 boss_skill 蒸馏。先把这个闭环跑通，再谈多 Agent 扩展。
|
||
|
||
## 完成话术
|
||
|
||
安装完成后，给客户这样汇报：
|
||
|
||
```text
|
||
总助 Claw 已完成基础配置：
|
||
- Agent workspace：<ATLAS_HOME>
|
||
- 已安装身份文件、专项 skills、mcp-tools、state schemas
|
||
- 已初始化 state、memory、boss_skill.md
|
||
- 已绑定入口：飞书 / 其他
|
||
- 已验证：Agent 能读取身份文件，并能输出首次部署 checklist
|
||
|
||
下一步需要你确认邮件接入方式和首次盘点范围。确认后，我会先试跑小范围邮件抽取，再生成第一份项目盘点报告。
|
||
```
|