assistant-claw/atlas/TOOLS.md
Vega (Atlas scaffolding) ce9f27320a Add Atlas profile under atlas/ — boss-perspective project execution radar
This adds the full Atlas (总助 Claw / 老板视角项目执行雷达) scaffolding as a
sibling profile to the existing Vega general-purpose assistant. All Atlas content
lives under atlas/ to keep the existing top-level skeleton intact.

What's included:

- atlas/IDENTITY.md, SOUL.md, USER.md, AGENTS.md, MEMORY.md, BOOTSTRAP.md,
  HEARTBEAT.md, TOOLS.md (+ zh-CN mirrors) — full OpenClaw 8-piece set
  matching the zero-cca convention
- atlas/skills/ — 6 sub-skills with frontmatter:
  claw-email-parser / claw-project-tracker / claw-people-observer /
  claw-customer-radar / claw-boss-distiller / claw-report-writer
- atlas/skills/claw-boss-distiller/ — adapter notes for nuwa-skill, 5-layer
  boss_skill seed template (23 rules across Expression DNA / Mental Models /
  Decision Heuristics / Anti-Patterns / Honest Boundaries), and a complete
  synthetic distillation demo (10 input emails -> validated 5-layer output)
- atlas/mcp-tools/email-extractor/ — Python implementation of stages 1-3
  (fetch + decode + dequote), 7 pytest tests passing, CLI: atlas-extract
- atlas/state-schemas/ — formal JSON schemas for project / person / customer
  cards with the no-employee-rating hard constraint baked in
- atlas/client-deck/ — 2-page client-facing pitch document
- autopilots/atlas-*.yaml — 5 autopilot configs (daily / weekly / monthly /
  quarterly + andon event-triggered) for a future Multica-side scheduler

Notes:

- nuwa-skill (MIT, https://github.com/alchaincyf/nuwa-skill) NOT vendored;
  fetch at deploy time via instructions in
  atlas/skills/claw-boss-distiller/upstream/README.md
- Vega-side prompts/skills/tools/autopilots/docs scaffold left untouched
- Top-level README.md updated with a brief Atlas pointer; rest preserved
2026-05-09 17:00:29 +08:00

2.8 KiB

TOOLS.md - Atlas Tool Configuration

Each Atlas instance is deployed inside the client's network. Tool credentials and endpoints are configured at install time.

Communication

  • Primary channel to boss: Email (Brief delivered to boss's inbox, signed Atlas / 总助)
  • Andon alerts: Email + (optional) WeChat push via 企业微信 robot webhook
  • Boss override channel: Boss replies to Brief email; Atlas parses reply for OVERRIDE: <rule-id> <new-value> markers

Email Ingestion (Read-Only)

Tool Status Notes
email-fetch (IMAP) V0 default Standard IMAP/SSL; supports incremental UID sync
email-fetch (Gmail API) V0 alternative OAuth2; more reliable than IMAP for Gmail
email-fetch (Exchange / EWS / MS Graph) V0 alternative For corporate Exchange / O365
wechat-fetch V0.5 Read-only; via 企业微信 API or third-party MCP server
feishu-fetch V1 飞书开放平台 OpenAPI

Email Extraction Pipeline

See mcp-tools/email-extractor.md for the full design (7-stage pipeline).

State Storage

  • Backend: Filesystem JSON (V0). SQLite migration at >1000 projects (~30-line script).
  • Location: state/ under workspace root, never outside client network.
  • Backup: git repo (private, client-controlled). State changes commit nightly with daily-snapshot tag.

Report Rendering

Tool Output
report-render (markdown→PDF) For attachable Brief PDF
report-render (markdown→HTML inline-email) For email body
report-render (markdown→WeChat-card) V0.5 — when WeChat output enabled

Mental Model Distillation

  • claw-boss-distiller — vendored from nuwa-skill (MIT). Reads boss outgoing email corpus → 5-layer boss_skill.md.
  • Refresh cadence: quarterly + on-demand.

Audit & Observability

  • rule-audit — append-only log: which rules fired, on which emails, producing which judgments. Boss can grep this.
  • state-diff — between any two daily snapshots, render a state-change diff (which projects flipped state, which alerts fired).

Model Providers

  • Primary LLM: Configurable per client deployment. Default: Claude Sonnet 4.6 for daily runs, Claude Opus 4.7 for quarterly distillation.
  • Embedding (V1 only): for L3 semantic retrieval, not in V0.

Network & Privacy

  • Air-gapped option: All processing inside client VPC; only Brief PDF leaves network (delivered to boss's inbox).
  • DPA required: Data Processing Agreement signed before W1.
  • Data retention: Raw email cache 90 days; extracted state files indefinite (client-owned).
  • Right-to-delete: Single command wipes all Atlas state for a person / customer / project.

Update this file whenever a tool integration is added, configured, or deprecated.