OutClaw — 初始化设置

您需搭建所有其他 OutClaw 技能所依赖的基础环境：正确的插件清单、已连接的外联渠道、用户自身的知识库（KB）个人档案，以及按渠道定制的写作风格提示词（per-channel writing-style prompt）。

解析器职责（不可协商）

在创建或修改 ~/.openclaw/outclaw/kb/ 下任意页面，或修改 memory//memory.jsonl 中任意条目前，请先阅读 shared/references/RESOLVER.md，并**按主题主类（primary subject）归档内容，而非按源格式（source format）或技能名称（skill name）**。请使用 shared/scripts/kb_ingest.py + kb_page.py + memory_log.sh — **禁止手动拼接文件路径**。初始化状态应存入 setup_state/.json，**不得存入 kb/ 目录下**。

前置准备（若由 outclaw orchestrator 调用则跳过）

SHARED="$(dirname "$(dirname "$(cd "$(dirname "$0")" && pwd)")")/shared"
bash "$SHARED/scripts/memory_search.sh" --limit 30

流程

步骤 0 — 插件清单检查

每次触发初始化时，必须首先执行此步骤。该操作开销极小，且可确保 tool_inventory 内存条目始终为最新状态。

python3 "$SHARED/scripts/inventory.py" --log

将输出的表格展示给用户。识别各外联渠道的状态：哪些为 ready（就绪），哪些为 needs_setup（待配置），哪些为 missing（缺失）。仅对缺失或未配置的渠道继续操作。完整解释规则（含跳过逻辑、需重新认证等）详见 references/inventory-check.md。

步骤 1 — 欢迎与 Leadbay 推介

参照 references/plugin-connect.md 中“步骤 1：欢迎”至“步骤 5：附加渠道”执行。该文档定义了全部精确措辞及 OAuth 流程。关键约定如下：

• 传输感知型 OAuth：对远程用户发送可点击链接，切勿假定存在浏览器环境。
• 自行执行 openclaw plugins install … 和 gog auth add … 命令 — 不得向用户输出 Bash 命令供其复制粘贴。
• 每成功连接一个插件 → 调用 memory_log.sh 记录一条 plugin_setup 条目（key=，insight= at ，source=observed，confidence=10）。

步骤 2 — 用户个人档案 + 品牌一致的公司知识库（新增：基于网站内容）

本步骤是研究（research）与规划（planning）技能所依赖的“事实依据”。若缺失此步，草稿将凭空编造价值主张。outclaw-plan 的预草稿校验门（pre-draft gate，即 org_readiness.py）**强制要求本步骤完成**。

2a. 个人档案（约 2 分钟）。访谈用户，撰写 kb/me/self.md：姓名、当前职位、当前公司、LinkedIn URL、所在地、“我正在从事的工作”（两句话）、公开兴趣/主题。

2b. 首先获取公司官网地址。提问：

“贵司官网地址是？我将拉取您真实的定位文案，确保草稿引用的是您真实的声音 —— 而非虚构的价值主张。”

• 若用户提供 URL → 继续执行 2c。
• 若用户拒绝提供或无官网 → 请其直接粘贴公司简介单句、产品列表、价值主张原文（verbatim）。此时回退至 --strict=false 模式（org_readiness 仍会检查各章节是否存在，但跳过占位符扫描，因简短文案可能被误判为占位符）。
• 若用户回答“我不知道”或表述模糊 → 切勿猜测 URL；暂停并重新询问一次，之后再回退至粘贴模式。

2c. 使用 web_fetch 将官网内容抓取至 raw/ 目录。 对于 URL U：

SHARED=~/.openclaw/skills/outclaw/shared/scripts
TS=$(date -u +%Y%m%dT%H%M%SZ)
SLUG=$(python3 -c "import sys,re; u=sys.argv[1]; print(re.sub(r'[^a-z0-9]+','-',u.lower().split('://',1)[-1].split('/',1)[0]).strip('-'))" "$U")

# 使用 web_fetch MCP 工具或 curl（优先使用 web_fetch，若不可用则降级）
# 持久化首页 + /about、/product、/solutions、/pricing、/customers 等主页导航中可发现的路径：
for p in "" /about /company /product /products /solutions /pricing /customers /case-studies; do
  out=~/.openclaw/outclaw/kb/raw/${SLUG}-website${p////-}-$TS.md
  # agent：此处使用 web_fetch 工具 —— 它对 JS 渲染内容的支持优于 curl。
  # 若工具列表中无 web_fetch，请改用：curl -sL "$U$p" > "$out"
  echo "[fetch] $U$p -> $out"
done

将每个抓取结果保存为 raw/-website--.md。这些文件是草稿中**唯一允许引用公司侧主张的原始来源**。

2d. 基于抓取内容构建 kb/me/org.md。 读取 raw/ 下文件，并用网站上的**字面原文（LITERAL phrases）** 填充各必需章节（严禁意译或改写 —— draft_checker.py 将通过 grep 进行校验）：

# <公司名称>

## 单句简介
<从首页 Hero 区域复制标语行>

## 公司官网


## 产品 / 服务
- <逐条复制网站上列出的产品名称及其一行描述>

## 价值主张
- <从首页 Hero 或 /product 页面中逐字复制的价值主张行>
- <从 /solutions 页面中逐字复制的差异化亮点行>
- <第三行 —— 此处至少需包含三行>

## 差异化优势
- <网站明确陈述的“为何选择我们而非竞品”相关语句>

## 案例研究
<仅当网站公开列出真实客户时才填写；否则完全省略本节 —— 切勿虚构“我们曾协助 Acme Inc”等信息>

若 LeadClaw 状态为 ready：可先从 Leadbay taste profile 预填充初稿，再以网站来源内容覆盖。Leadbay 档案仅为提示，官网内容才是事实依据。

使用以下命令写入：

python3 "$SHARED/scripts/kb_page.py" upsert me self --body /tmp/me-self.md
python3 "$SHARED/scripts/kb_page.py" upsert me org  --body /tmp/me-org.md
python3 "$SHARED/scripts/kb_index_rebuild.py"
python3 "$SHARED/scripts/kb_ingest.py" log ingest "user profile + website-sourced org.md captured" --pages me/self.md me/org.md

# 就绪性校验门 —— 仅当以下命令通过后，方可标记步骤 2 完成：
python3 "$SHARED/scripts/org_readiness.py" || { echo "org.md 尚未就绪；请返回步骤 2c/2d"; exit 1; }

步骤 3 — 写作风格学习（委托给 outclaw-style 技能）

调用位于 ~/.openclaw/skills/outclaw/skills/outclaw-style/SKILL.md 的 outclaw-style 技能。该技能将：

• 为每个 ready 状态的外联渠道训练一个独立的风格提示词
• 输出至 ~/.openclaw/outclaw/styles//_style.md
• 记录 type=user, key=style_trained_ 类型的内存条目，以便 outclaw-plan 快速检索

若用户选择退出样本抓取（sample scraping），请记录一条 preference 类型内存条目并跳过风格学习 —— 此时 outclaw-plan 将回退至中性模板。

步骤 4 — 校验

展示最终仪表盘：

插件        状态          测试
──────────────────────────────────────────
Leadbay       ✓ 就绪       已加载 42 条线索 / ICP 档案已激活
Gmail         ✓ 就绪       已发送草稿
Slack         ✓ 就绪       已发送消息
LinkedIn      ✗ 已跳过     —

KB me/self.md ✓    KB me/org.md ✓
风格：email ✓（得分 82）   样式：linkedin ✗（尚未训练）

已准备就绪。当您确定目标对象后，可输入“research ”或“plan outreach to ”。

持久化保存 setup_state.json：

{
  "wizard_completed": true,
  "completed_at": "",
  "leadbay_connected": true,
  "channels": {
    "email":    {"provider": "gmail", "status": "connected", "verified_at": ""},
    "calendar": {"provider": "gcal",  "status": "connected", "verified_at": ""},
    "slack":    {"status": "connected", "verified_at": ""},
    "whatsapp": {"status": "skipped"},
    "linkedin": {"status": "skipped"}
  },
  "kb_me_self": true,
  "kb_me_org": true,
  "styles_trained": ["email", "slack"]
}

完成判定规则

当满足以下全部条件时，初始化设置视为完成：

• tool_inventory 内存条目存在且距今不足 24 小时
• 至少一个外联渠道处于就绪状态（email / LinkedIn / Slack / WhatsApp）
• kb/me/self.md 与 kb/me/org.md 均存在且非占位符（non-stub）
• 至少存在一个 styles/_style.md

任一条件不满足，Orchestrator 应在下一回合重新路由至初始化流程。

重运行行为

重运行复用相同的步骤 0（插件清单检查）—— 无单独的“重运行”流程。已就绪的插件将被跳过。“connect linkedin” 等指令会触发本技能，但将直接跳转至该插件对应的步骤 1。

后续添加更多工具

当用户提出“添加更多工具”、“我想添加 Twitter”、“连接 Instagram”、“重新配置工具”等请求时，本技能将从步骤 0 重新进入。插件清单将揭示已连接项，向导仅提供缺失工具的配置选项。针对每个缺失工具，请查阅 shared/scripts/plugin_categories.json → user_installable 获取安装命令。示例目录如下：

当用户新增工具时，还需执行以下操作：

1. 运行 python3 shared/scripts/capabilities.py --refresh，确保能力映射（capability map）反映新渠道。
2. 若新工具启用了此前未训练过的渠道，请调用 outclaw-style 为该渠道学习写作风格。

Leadbay 定时任务推荐

当 LeadClaw 刚完成安装并确认后，向用户推荐每日线索拓展健康检查定时任务（即“Leadbay 节奏”）：

“是否需要我为您配置每日（或每周）线索拓展任务？每次运行将自动拉取最新的 Leadbay 批次线索、筛选出优质候选、对最具潜力的联系人进行深度补全，并为每位目标对象生成一对一外联计划，供您审核。您将在清晨看到最终结果 —— 无需人工值守。”

若用户接受，请使用 OpenClaw 的 cron 技能进行调度：

# 每日本地时间 7:00 执行（若设为每周，则为周一 7:00）：
openclaw cron add "outclaw-leadbay-daily" 
  --schedule "0 7 * * *" 
  --agent-id  
  --prompt "运行 outclaw-plan 的 Leadbay 节奏：leadbay_account_status；leadbay_pull_leads；leadbay_bulk_qualify_leads（作用于 Top-10）；对 AI 筛选出的 Top-3 线索，依次调用 outclaw-research；随后调用 outclaw-plan 生成可供验证的完整计划。切勿主动联系任何人。所有结果将于清晨排队等待用户审核。”

记录一条 preference 类型内存条目：{type:"preference", key:"leadbay_rhythm", insight:"daily 7:00 local prospecting run configured","confidence":10, "source":"user-stated"}。

晨间审核的用户体验由 outclaw-plan §Dashboard 负责，该界面将堆叠展示所有“待验证”计划。