智桥客户端操作手册（V1）
1. 阅读说明
1.1 建议阅读顺序
- 启动与登录（第3章）
- 初始化配置（第4章）
- 任务页面执行（第5章）
- 客户开发闭环（第7章）
- 知识库维护（第8章）
- 社媒授权（第9章）
- 业务数据处理（第10章）
1.2 如何阅读本手册中的图
- 文中「图 X-Y」与插图一一对应，请按编号在章节内查找。
2. 客户端页面地图
2.1 页面结构
- 左侧导航：新建任务、业务专家、客户开发、知识库、社媒授权、业务数据、能力（含定时任务页面、IM 助手、Skill、MCP 等）、任务记录、设置等。
- 中间区域：当前页面的主操作区域（输入、筛选、授权、结果）。
- 右上角区域：用户手册入口为「圆形问号」图标，点击即可打开本手册。
3. 首次启动与账号进入
用户服务协议位于注册或登录页面，请先阅读并勾选后再继续。下面按常用路径分步说明：注册与密码登录、验证码登录、忘记密码与重设密码。若登录失败，请对照界面提示与下文排查。
3.1 流程：注册与密码登录
在登录页进入「注册账号」，填写资料并勾选用户服务协议后完成注册；返回登录页输入邮箱与密码，勾选协议后点击「继续」完成密码登录。
3.2 流程：验证码登录
在登录页选择「验证码登录」，获取并填写验证码，勾选用户服务协议后完成登录。
3.3 流程：忘记密码与重设密码
在登录页点击「忘记密码」，按页面验证流程设置新密码。
3.4 登录失败界面示例
以下为邮箱或密码错误时的界面示例（具体文案以客户端为准）。
3.5 登录阶段常见问题处理
- 先确认网络可访问公司服务。
- 检查邮箱、密码或验证码是否输入错误。
- 关闭应用后重新打开，再执行一次登录。
- 仍失败时，把错误界面保存下来发给管理员。
3.6 登录失败定位步骤（逐项执行）
- 记录错误文案原文，不关闭页面。
- 核对邮箱、密码或验证码是否填错；核对邮箱、密码或验证码是否含有空格或多余字符。
- 重新输入后再次提交。
3.7 登录成功后首次检查
- 确认 OpenClaw 网关已启动成功（主界面可正常使用，无网关相关报错；若登录后加载较久，请耐心等待至就绪）。
- 检查左侧导航是否完整显示。
- 点击「新建任务」确认可进入任务页。
- 点击「设置」确认可进入设置页。
- 返回主页面确认无报错提示。
登录进入主界面后，左侧栏底部可查看当前登录邮箱、金币数量，并使用登出按钮退出账号。
3.8 OpenClaw 网关（登录后）
登录成功后，客户端会启动 OpenClaw 网关；首次启动或久未使用后再次打开时，网关初始化可能较慢，请等待至主界面完全可用后再操作各功能。若长时间无响应或提示网关失败，请见第 16 章常见问题中的处理说明。
4. 初始化配置
建议顺序：设置 → 模型（必须先完成并测通）→ 按需完成设置 → 邮箱（需要自动收发邮件时必选）与设置 → IM 机器人（需要 IM 聊天时必选）→ 回到任务页选择本次使用的模型与工作目录→ 通过新建任务完成系统完整初始化（数据库、记忆等）。
4.1 设置模型
在设置 → 模型中配置大模型连接。界面语言为中文时，常见入口为「模型 / 提供商 / API Key」等；为英文时，常见为 Model、Provider、API key 等，含义与中文界面一致。
可选模型与厂商：客户端会列出当前提供商下可用模型（界面多为提供商品牌名 + 模型 ID，请以实际列表为准）。内置联网提供商与程序一致，主要包括：OpenAI、Gemini（Google）、Anthropic、DeepSeek、Moonshot、Zhipu、MiniMax、Volcengine（火山引擎）、Qwen、ZhiYun、StepFun、Xiaomi、OpenRouter；本机或内网常用 Ollama、LM Studio；另有 Custom（自定义）用于填写兼容 Anthropic 或 OpenAI 协议的 Base URL、密钥，或对接内置列表以外的兼容服务端点。
示例：火山引擎 Coding Plan（代码规划）模式
- 在火山引擎控制台申请并复制 API Key。
- 在智桥模型设置中选择 Volcengine，粘贴密钥，并启用与 Coding Plan 相关的选项（与控制台开通能力一致，具体文案以客户端为准）。
- 点击连接测试，确认可拉取模型列表且无报错。
- 点击保存后即可在任务页选用该提供商下的模型。
4.2 设置邮箱（需要自动收发邮件时必选）
在设置 → 邮箱中配置用于收发的账号。常见个人邮箱（126、163、Gmail、Outlook、QQ 等）选择对应服务商后，客户端会尽量自动匹配 IMAP/SMTP；仍需在邮箱网页端开启 IMAP/SMTP 并填入授权码或应用专用密码（勿使用网页登录密码）。
选择自定义服务商时，请展开黄色说明区查看自定义邮箱说明（企微 / 腾讯企业邮、钉钉、飞书等固定服务器与授权码指引）。可使用使用登录邮箱一键带入当前登录账号邮箱；对企微、钉钉、飞书企业邮可使用一键填入企微 / 一键填入钉钉 / 一键填入飞书预填主机与端口，再补全授权码与高级项。完成后务必执行测试连通性（或「测试连接」），通过后再点保存。
4.3 配置 IM 机器人（需要 IM 聊天时必选）
在设置 → IM 机器人中按需开启各通道。中文界面下左侧列表中的平台名称与客户端一致，依次为：微信、钉钉、飞书、企业微信、QQ、WhatsApp。英文界面在以上基础上还会列出 Telegram、Discord，侧栏名称依次为 WeChat、DingTalk、Feishu、WeCom、QQ、WhatsApp、Telegram、Discord。飞书配置内可选择域类型「飞书 (feishu.cn)」或「Lark (larksuite.com)」，侧栏仍显示「飞书」或「Feishu」。
配置方式：以客户端各平台页为准：微信、WhatsApp支持扫码登录流程；飞书含扫码相关流程并需配合开放平台应用凭证；企业微信以机器人凭据及页面引导为主；钉钉、QQ及英文下列出的 Telegram、Discord多在对应平台申请机器人或 Bot 凭据后在客户端填写。
示例：WhatsApp — 开启开关后点击扫码连接 WhatsApp，用手机 WhatsApp 扫描完成配对；连接成功后关注状态是否为「已连接」；按需执行连通性相关检查（若有），最后点击保存使配置生效。
4.4 任务页：选择模型
完成设置 → 模型并保存后，在任务页通过模型选择器选定本次对话使用的模型；选择结果会显示在当前任务栏或标题区域（以客户端为准），发送前请确认与预期一致。
4.5 任务页：选择工作目录
在任务页指定本机工作目录，用于保存附件、导出结果与业务文件。选择文件夹后，界面会显示当前路径；请固定使用同一目录，避免生成数据及记忆缺失。
4.6 新建任务：系统完整初始化
在设置 → 模型中测通并保存、且在任务页选定工作目录之后，还需通过新建任务触发一次系统完整初始化（包含数据库、记忆等多项内容，以客户端实际执行为准）。
可在新建任务输入框中直接输入需求（例如「帮我初始化系统」）；也可在业务专家或快速开始相关入口中选择 IT 专家小李，由其协助完成初始化流程。
任务发送后请等待执行完成；初始化过程中请勿频繁重复提交同一初始化任务，直至本轮结束。
4.7 配置完成校验清单
- 设置中模型连接测试成功并已保存。
- 若使用邮件：邮箱测试连通成功并已保存。
- 若使用 IM：对应 IM 通道已连接并已保存。
- 任务页已选择模型与工作目录，路径显示正确。
- 已通过新建任务完成系统完整初始化（数据库、记忆等），执行过程无持续报错。
- 任务页可发送一句简单提问试跑；需要邮件时，邮件页可见同步相关入口。
5. 任务页面
任务页面是日常使用智桥的主工作入口：绝大多数需求都在这里以「对话式任务」完成。建议按下面顺序操作，形成稳定闭环——先新建任务进入空白或续接会话；需要时选择专家（可选）为任务带上行业模板与提示词；再完成输入与附件并发送；发送后关注执行状态与权限确认（界面可能出现「执行中」、工具调用确认等）；首轮回复到达后查看执行结果是否满足格式与事实要求；若不满足，在同一任务里结果迭代追加约束继续追问，一般比重开新任务更高效。
5.1 新建任务
点击左侧「新建任务」进入任务页：此时中间区域为本次对话的主界面，顶部或标题区会显示当前任务名称（新建时多为默认标题，发送后可能随内容变化，以客户端为准）。若您希望完全空白开始，可直接在底部输入框撰写需求；若刚从其他页面跳转过来，输入区可能已带有上文或系统预填内容，发送前请快速扫一眼避免误发。
5.2 选择专家（可选）
若当前任务与某位业务专家的场景高度吻合，可在任务页通过专家/拼图类入口打开专家列表，点选卡片后，系统会把该专家的角色设定与推荐写法预填进输入区或上下文中（以界面为准）。本步骤为可选：熟悉提示词的用户可跳过，直接手写需求。选定专家后，仍建议在发送前根据实际客户、市场与格式要求补写一两句约束，避免泛化回答。
5.3 输入与附件
在底部输入框用自然语言写清目标、约束、期望输出形态（例如表格、邮件草稿、字数上限）。需要引用本地材料时，使用附件（回形针）或界面提供的工作目录/文件夹入口，把文件纳入本轮对话上下文后再发送。建议一次只推进一个核心目标；若同时有多件事，请拆成多次发送或在后文「结果迭代」中分步追加。
5.4 查看执行结果
发送后主区域会陆续出现思考说明、工具调用、中间产物与最终答复。若出现执行中或进度提示，请耐心等待至本轮结束，避免重复点击发送造成队列堆积。若弹出权限或操作确认对话框，请先阅读将访问的资源（文件、链接、命令等），确认与当前任务相关后再允许；不确定时可先拒绝，并在输入区用一句话要求助手说明用途后再试。首轮结果送达后，请对照您在 5.3 中写的目标检查：事实是否对齐、格式是否可交付、是否缺字段。
5.5 结果迭代
对首轮结果不满意时，不要急于新建任务，应在同一对话底部的输入框继续输入。推荐写法：直接指出差异（「请把第二节改成三点清单」「请补充欧盟合规注意事项」「请缩短到 200 字内」）。若上一轮范围过大导致发散，可先要求只输出提纲或目录，确认后再让助手展开正文。涉及新素材时，可继续添加附件再迭代。
5.6 高质量输入模板（可直接套用）
模板：目标 + 约束 + 输出格式 + 语气要求
示例：请基于我上传的产品资料，生成一封英文开发信。要求 120 词以内，语气专业，最后给出一个可回复的问题，并提供两个版本。
5.7 小白执行脚本（从输入到结果）
- 复制 5.6 中模板到任务框并替换变量。
- 点击发送等待首轮输出完成。
- 对照 5.4 检查输出是否包含目标字段。
- 缺失字段时在 5.5 追加「补充缺失字段」或具体修改句。
- 达标后复制结果保存到本地文档。
6. 业务专家页面
业务专家用于把常见外贸与办公场景封装成可直接协作的角色入口。当前版本包含：专家卡片列表、专家详情与自定义任务、单独沟通弹窗、专家群聊。您可在列表查看专家状态与建议，在详情查看能力说明并套用自定义任务，也可进入单独沟通或群聊沟通连续对话。若您已在新建任务里通过专家入口选用专家，逻辑与第 5 章 5.2 一致，可与本章对照理解。
6.1 总览：专家列表与场景入口
从左侧进入「业务专家」后，主区域以卡片网格展示专家。每张卡片包含专家名称、场景定位、状态徽记与建议区（有建议时显示）。建议您先按当前工作类型选专家，再进入单独沟通、群聊沟通或模板任务。
卡片上的状态徽记会随会话进展变化（如思考中、执行中、待确认、已完成等）。当某位专家有未读结果时，卡片右上会出现红点；侧栏「业务专家」入口也会显示汇总角标，便于快速发现需要查看的专家。
6.2 详情页与自定义任务
详情页：点击专家卡片可查看该专家的能力说明、适用边界与推荐用法，适合先判断是否匹配当前工作目标。
自定义任务：详情页中的任务模板可一键带入任务页，您可在发送前补充客户背景、截止时间和附件材料。
6.3 单独沟通与建议展示
本节用于说明专家卡片进入后的轻量对话场景：您可以围绕同一位专家连续追问，不需要跳转主任务页面。该模式更适合快速确认下一步动作、补充上下文材料，并在短链路内拿到可执行建议。
单独沟通：点击卡片底部「单独沟通」可打开该专家的轻量弹窗，不会跳转到主任务页。弹窗内支持继续输入、附件发送与连续追问，适合围绕单一专家快速往返。
建议标记：进入单独沟通时，若该专家当前有建议，会在会话区显示带标记的建议消息：首次初始化建议显示「今日建议」，专家完成后刷新出的新建议显示「当前建议」。
建议触发：建议生成触发原则为应用启动后首次进入专家页、某位专家完成后仅刷新该专家、或手动触发刷新命令。非上述场景不会自动重算。
6.4 群聊沟通（@专家协作）
群聊沟通：在专家群聊卡片点击「群聊沟通」可打开群聊弹窗。该弹窗用于让多位专家围绕同一问题协作，适合跨场景联动分析。
@指定专家：输入框支持通过 @ 选择专家（下拉选择），可指定某位专家优先回答；不 @ 时由系统按上下文安排协作专家。
群聊展示：群聊消息会按实际输出专家显示头像与名称，便于区分不同专家观点；卡片状态可反映当前执行中的专家状态（如某位专家思考中或执行中）。
6.5 专家页异常处理
- 点击「单独沟通」无反应：先确认当前卡片可交互，再切换页面返回重试；仍无效可重启客户端。
- 卡片建议为空：先确认该专家是否已有有效建议触发来源（首次初始化、专家完成、手动刷新）；若模型返回无效建议，卡片会按设计不显示建议区。
- 未读红点未清理：进入对应专家单独沟通查看结果，或在任务记录中打开对应专家会话；查看后红点应自动清理。
6.6 怎样判断专家页给出的结果是否够用
- 建议用语应是可直接执行的自然语言句子，而非短标签或占位词。
- 建议与当前专家职责一致（例如找客户、管线索、邮件触达、文档补全等）。
- 查看「当前建议」后，能直接据此发起下一步操作或对话，不需再补大量解释。
7. 客户开发页面
左侧导航点客户开发，进入客户开发闭环工作台。该页把「定位 → 找客户 → 审核 → 触达草稿 → 回复交接」串成一条线，读取与更新的是同一套业务库（与第 10 章业务数据、第 4 章工作目录共用）。使用前请已在任务页选定工作目录并完成初始化；涉及邮件触达时需完成第 4 章邮箱配置。
7.1 入口与页面结构
页面自上而下大致分为：
- 标题栏：显示「客户开发」及整体状态徽标（如就绪、需处理、有卡点）。
- 闭环顶栏：标题为「客户开发闭环」，展示当前停在哪个节点；若有待办或卡点，会出现黄色提示条。右侧有刷新、主操作按钮（无卡点时多为「找一批客户」，有卡点时多为「从这里继续」），以及业务数据、定时任务、WhatsApp 配置等快捷入口。
- 三栏主体：左侧为客户开发流程（五个节点列表）；中间为对话工作区（当前节点说明、系统建议、快捷操作、输入框与对话记录）；右侧为上下文面板（见下）。
上下文面板固定在右侧，顶部有四个页签，随当前节点切换内容：
- 人工待办：卡点列表、高质量客户、待办任务；节点处于待处理 / 有卡点 / 错误时，切换节点后默认打开此页签。
- 节点结果：当前节点状态摘要、六项关键指标（待审核候选、待审批草稿、等待回复、需人工处理、高质量客户、待办任务）及可复制的人工报告。
- 业务数据：定位基准完整度与置信度、邮件/WhatsApp 草稿等渠道状态快照。
- 运行日志：流程快照（发现批次、已停止线程、生成时间）及已停止触达线程明细。
侧栏折叠时，标题栏左侧可出现「展开侧栏」「新建任务」等图标，与其它主页面一致。
7.2 客户开发闭环与五个节点
左侧流程按顺序列出五个核心节点，点击可切换当前节点；每个节点卡片上可见序号、名称、状态图标与简要指标（如待审核数、待审批草稿数等）。切换节点后，中间工作区与右侧上下文面板会同步更新。
顶栏从这里继续 / 找一批客户会按当前卡点从对应节点起顺序推进；遇到缺资料或需人工确认时会停住，不会跳过卡点自动外发。各节点下方的快捷操作会预填对话任务并跳转到任务页执行；部分按钮会直接打开第 10 章业务数据的对应页签。
7.2.1 定位基准
补齐公司、产品、目标市场与买家画像等基准信息，供后续找客户与写触达信复用。卡点常见于定位不完整或置信度不足。中间区常见快捷操作如「补齐资料」；右侧人工待办可查看卡点与高质量客户（整体布局见图 7-01）。
7.2.2 找客户
按定位运行客户雷达，把有采购信号与来源证据的候选写入审核队列。中间区可点「找一批客户」「发现历史」；右侧节点结果页签展示本节点摘要与关键指标（如已发现批次数、高质量客户数）。
7.2.3 审核入库
处理待审核候选，区分可跟进、需补资料、不值得跟等，通过后进入触达环节。中间区常见「审核候选」「线索列表」；右侧业务数据页签可对照定位完整度与渠道草稿数量，无需离开本页即可判断资料是否齐备。
7.2.4 触达草稿
生成开发信等触达草稿；默认不自动外发，需人工审阅后再保存草稿或确认发送（邮件/WhatsApp 等受渠道配置约束）。中间区常见「审核草稿」「草稿箱」；右侧运行日志页签可查看流程快照与已停止线程。
7.2.5 回复交接
汇总等待回复、需人工判断的线程与高质量客户，便于业务员接手跟进。中间区常见「处理回复」「草稿跟进」「收件箱」；右侧人工待办集中展示卡点与高质量客户列表，每条可点「在对话中跟进」生成针对性指令。
7.3 用对话推进
中间工作区是「用对话推进」的核心（各节点界面见图 7-01～7-05中间栏）：
- 选中节点后，上方展示该节点的操作说明与建议下一步；下方输入框会预填与该节点匹配的提示骨架，您可改写后再发送。
- 发送后任务会进入任务页由 Agent 执行（与第 5 章任务流程一致）；执行过程中可在此查看简要对话记录。
- 顶栏预设任务（如「看当前状态」「找一批新客户」「初始化节奏」「审核队列」「检查回复」）可从对话区一键带入常用指令。
- 右侧列表中的候选、草稿、高质量客户条目也可点选，为当前对象生成更具体的跟进或审阅指令。
刷新：仅重新读取工作台快照；若存在「已发送待回复」或「回复需人工」类数据，刷新时可能同时触发检查回复逻辑。
外发约束：邮件/WhatsApp 等触达须您明确确认；Agent 侧提示亦要求先审草稿再外发。WhatsApp Business 模板类消息还需联系人已 opt-in 等条件（见渠道就绪提示）。
7.4 与业务数据的对应关系
客户开发页是闭环指挥台，明细数据仍在业务数据各模块中查看与编辑；右侧上下文面板的业务数据页签提供轻量快照（见图 7-03），完整编辑请进入第 10 章：
- 业务资产：公司介绍、产品资料、定位诊断 → 对应「定位基准」节点（详见第 10 章 10.3）。
- 线索：客户雷达与公开搜索来源的待审候选、阶段与评分 → 「找客户 / 审核入库」。
- 邮件：草稿箱中的待审批触达、已发送与收件箱回复 → 「触达草稿 / 回复交接」。
- 商机等业务结果：高质量客户沉淀后的推进 → 「回复交接」及后续人工跟进。
顶栏或节点快捷操作中的「业务数据」会按场景打开相应页签；定时任务页可查看或初始化客户雷达、回复检查、周报等节奏任务（与第 11 章定时任务配合）。
8. 知识库页面
左侧导航点知识库，管理当前工作目录下的结构化资料与检索索引，供任务与专家在对话中按需引用。使用前须已在任务页（Cowork 设置）选定工作目录；未选工作目录时，页面会提示无法导入。
8.1 入口与知识范围
除侧栏知识库主入口外，在业务专家详情中也可能出现「管理知识库」入口，会打开同一页面并预选该专家对应的知识范围。
进入页面后，顶栏从左到右通常包括：刷新、知识范围下拉（切换 shared / 专家专属 scope）、蓝色导入资料、重新索引、清理零片段来源与清理无用副本等（以界面为准）。
- 知识范围：顶栏下拉框切换当前管理的 scope。通常包含共享知识库（
shared）及各专家专属范围（名称旁括号内为已索引来源数量）。 - 索引状态卡片：展示当前范围的索引状态（已就绪 / 需关注 / 待导入）、检索片段数、文档数、可发送资料数。
- 状态为「待导入」或「需关注」时，页顶会出现黄色提示条，说明须先导入并完成索引再向 Agent 提问。
8.2 导入资料与索引
顶栏常用操作：
- 刷新：重新加载当前范围的快照。
- 导入资料：打开导入对话框（见图 8-02）。Windows 可将文件或文件夹拖入对话框区域，也可点「添加资料…」在系统选择器中选多个文件或文件夹；Mac 支持在对话框中添加资料…或拖拽，可多次添加后点「导入 (N)」确认。支持文档、图片、视频等（以客户端筛选为准）。
- 重新索引：对当前范围内已导入文档重建检索索引（无文档时不可用）。
- 清理零片段来源 / 清理无用副本：分别用于删除无检索片段的无效来源、清理知识库目录中不再引用的副本文件（后者操作前会有确认）。
导入完成后，文档进入下方列表；部分图片类资料需点行内识别（或批量识别）调用视觉能力补全正文，识别依赖模型/视觉 API 配置。
8.3 文档列表与筛选
知识库文档列表展示当前范围内全部条目，支持：
- 搜索：按来源名或资料关键词过滤（占位「搜索来源或资料…」）。
- 格式筛选：全部 / 文本 / PDF / Word / Excel / PPT / 图片 / 视频等。
- 状态筛选：全部 / 已索引 / 零片段 / 待识别。
- 每行展示格式与解析状态（如 PPTX · parsed）、检索片段数、正文字数、含图数量、是否待识别图片、文件路径等；行尾提供识别、允许/不允许、打开、删除等操作（见图 8-03）。
8.4 批量操作与可发送策略
勾选一行或多行后，列表上方会出现批量操作栏（未勾选时为灰色不可用）：
- 全选 / 批量删除
- 批量识别（适用于待识别图片等）
- 批量允许 / 批量不允许 / 设为自动：控制资料在对话中作为附件或对外发送时的策略（允许、不允许、自动）。
单行上的识别与允许/不允许与批量操作作用相同，仅作用范围不同。「可发送」不等于自动外发邮件或消息；仅表示 Agent 在任务中引用该资料时的策略边界，实际触达仍须遵循客户开发等模块的人工确认规则。
8.5 与专家和任务的关系
- 任务页或专家对话中，Agent 会通过内置知识库路由判断是否需要检索；命中后把相关片段注入上下文。
- 共享知识库对所有任务可见；专家专属范围仅在关联该专家（或对应 scope）时优先匹配。
- 若提问后 Agent 表示「没有资料」或回答泛化，请回到本章检查：工作目录是否正确、当前 scope 是否已导入并显示已就绪（见图 8-01 状态卡片）、相关文档是否已索引或完成图片识别（见图 8-03）。
- 业务专家卡片上的「管理知识库」用于维护该专家场景下的专用资料，与第 6 章专家配合使用。
9. 社媒授权页面
社媒授权页把两件事绑在一起：本机浏览器桥接（后台 Daemon + 专用 Chrome 里的 Browser Bridge 扩展）与各社交平台账号登录态。只有桥接就绪，客户端才能在受控窗口里完成登录并由 opencli 做会话校验；只有某平台显示已连接，后续任务里才能稳定调用该平台数据能力。本章配一张总览截图（图上已标注主要功能区），细步骤以正文为准。
9.1 页面结构：先桥接，后平台
进入左侧「社媒授权」后，请先看页面上方的授权桥接状态：Daemon表示本机桥接服务是否在跑；扩展表示专用 Chrome 中的 Browser Bridge 是否已与客户端握手成功。两路都「已连接」时，再处理下方平台卡片，可显著减少「点了连接却没反应」的误判。
下方每一张平台卡片通常包含：平台名称、当前连接/验证状态、连接（拉起专用 Chrome 并进入该平台登录流程）、验证（回到客户端后触发 opencli 检查登录态）、以及在已连接且支持时出现的问答入口。个别平台可能还有额外说明或开关（以界面为准）。
9.2 首次使用：Browser Bridge 扩展启用（与客户端指引一致）
当您看到客户端展开「Browser Bridge 扩展启用指引（首次建议按序操作）」类说明，或桥接区显示扩展未连接而 Daemon 已运行时，请不要在任务栏里随便打开日常使用的 Chrome 去装扩展——必须使用本应用管理的专用 Chrome（独立用户数据目录，与日常浏览器不是同一套会话）。下列步骤与客户端内嵌指引逐步对应：
- 打开扩展管理页并开启开发者模式：在专用 Chrome 中打开
chrome://extensions/（可通过「打开专用 Chrome」「打开扩展页」等按钮进入；若地址栏空白请手动完整输入该地址并回车）。在扩展页右上角开启「开发者模式」。 - 定位扩展根目录：在本页点击「打开扩展目录」，系统会在资源管理器中打开内置扩展所在文件夹。请复制该文件夹的完整路径（须为包含
manifest等文件的扩展根目录这一层）。 - 加载已解压扩展：回到专用 Chrome 的扩展页 → 点击「加载已解压的扩展程序」 → 在系统选择框中粘贴上一步路径并选中该文件夹 → 确认列表中出现 Browser Bridge 且开关为打开。
- 回到本页核对桥接：在授权桥接状态中查看 Daemon 与扩展是否均为已连接。安装或重载扩展后，建议点「刷新状态」取最新读数；若仍异常，可先点「一键检查/修复」，再保持应用打开并重新打开专用 Chrome 试一次。
- 再去做平台连接与验证：在目标平台卡片点「连接」，仅在专用 Chrome 窗口内完成站点登录；回到本页后点该平台的「验证」直至显示已连接。通过后若出现「问答」，即可发起带该平台上下文的对话任务。
9.3 日常使用：扩展已就绪时的普通流程
当您已经完成过第 9.2 节，且桥接区长期保持 Daemon = 已连接、扩展 = 已连接 时，日常不需要再次执行「加载已解压扩展」或重新安装扩展。此时授权新平台或重登某平台，可按下面最短路径操作：
- 打开社媒授权页，若刚重启过电脑或浏览器，可先点「刷新状态」确认桥接仍为已连接（扩展未连接有时是专用 Chrome 尚未打开，未必是故障）。
- 若专用 Chrome 未弹出且连接需要浏览器，点「打开专用 Chrome」，确保后续登录仍发生在受控窗口内。
- 在目标平台卡片点「连接」，在同一专用窗口完成登录或二次验证；不要改到任务栏日常 Chrome 登录，否则本页「验证」常无法命中会话。
- 登录完成后保留窗口或按提示回到本页，点击该平台的「验证」；通过后卡片应显示已连接。若客户端检测到您已在窗口内登录，也可能出现自动验证成功的提示（以实际文案为准）。
- 若仅想确认旧连接仍有效：可直接点「验证」做健康检查，无需重复「连接」。
- 需要就社媒数据对话时，在已连接且支持的平台卡片上使用「问答」入口。
9.4 多平台与重复授权建议
- 建议一次只连一个平台：从连接到验证成功后再处理下一个，避免多个登录窗口互相覆盖。
- 每完成一个平台，可将成功状态界面保存备查；全部完成后可各点一次「验证」确认仍为已连接。
- 若某平台提供「暂不使用」类选项，勾选后该入口会关闭；需使用请先取消勾选再点「连接」（以界面为准）。
9.5 失败排查顺序（固定执行）
- 确认登录发生在本应用「连接」所打开的专用 Chrome，而不是任务栏里的日常浏览器。
- 查看授权桥接状态：Daemon/扩展是否断开；必要时依次尝试刷新状态 → 一键检查/修复 → 重新打开专用 Chrome。
- 保持用于登录的浏览器窗口未提前关闭，回到本页再点「验证」；超时可再点一次验证。
- 若仍失败：完整抄下错误文案，截取本页与桥接区状态，并按 9.6 记录信息后再联系管理人员。
9.6 授权异常记录格式
- 平台名称
- 操作时间
- 错误文案原文
- 桥接状态值（Daemon / 扩展）
- 是否在专用 Chrome 中完成登录
10. 业务数据页面
业务数据页集中管理业务资产、客户、线索、商机、订单、邮件、数据看板等对象。本章按模块分块：每个模块内先用文字写清该模块会用到的筛选、刷新、问专家及与导出相关的能力。业务资产为总览与对话补齐页（见图 8-31）；客户、线索、商机、邮件四个列表页签的工具栏「导出 Excel」与筛选示意见图 8-03；数据看板不在工具栏提供「导出 Excel」，但在各模块以表格展示查询结果时，表格区域可提供「导出 CSV」，详见 10.8.1。问专家跳转效果见图 8-12，问专家按钮位置见图 8-01，各列表类页签主界面见图 8-02。下文各图按编号标注。
10.1 总览：整体布局
展示业务数据页整体框架：顶部页签栏（业务资产、客户、线索、商机、订单、邮件、数据看板等）、其下工具栏（筛选、刷新、列表页签上的导出 Excel、问专家、邮件同步与新建等）、中间主内容区（卡片总览、列表或看板）。无数据时请确认第 4 章任务页工作目录已选择且后端有数据。工具栏右侧的问专家按钮与列表页签中位置一致，点击后携带当前页签与筛选进入任务页。
- 页签：在各数据集间切换；业务资产与数据看板为主内容区卡片/模块布局，其余多为列表。
- 工具栏：承载与本页签相关的列表操作与上下文能力。
- 主内容区：展示当前条件下的数据；行内可有查看、编辑等入口。
10.2 总览：各模块页签主界面
本图自上而下共五张子图，对应五个页签的典型主界面；每张图对应界面中可重点对照的区域如下。
- 子图 1（客户列表）：客户列表与工具栏，含筛选、刷新、导出 Excel、问专家。
- 子图 2（线索）：线索列表与工具栏。
- 子图 3（商机）：商机管道列表与工具栏。
- 子图 4（邮件-收件箱）：收件箱列表与工具栏，含同步、新建邮件（单模块界面另见图 8-06、8-08）。
- 子图 5（数据看板）：看板主区多模块排布；预设与自定义模块的说明见图 8-13。
10.3 业务资产模块
页签栏点业务资产，查看当前工作目录业务库中已沉淀的自家公司、产品定位与客户开发摘要。该页不是列表页：不提供筛选与导出 Excel，主要用于总览、对话补齐、跳转客户开发闭环。缺项可通过对话写入业务库，保存后会在本页与第 7 章客户开发闭环中同步显示。
10.3.1 业务资产总览与顶栏操作
主区顶部为业务资产总览卡片，说明数据来源与用途；右侧常见操作：
- 完善公司介绍：携带当前公司资料上下文打开任务页，通过对话补齐公司名称、行业、规模、公司介绍、核心优势等。
- 完善产品分析：携带产品资料与最新产品诊断上下文，补齐定位完整度、价格判断、核心价值、目标客户画像等。
- 打开客户开发闭环：跳转到第 7 章客户开发工作台，从定位基准或当前卡点继续推进。
总览下方四张指标卡通常包括：产品数、定位完整度、高分线索、待处理（待办任务数）。工具栏仍提供刷新与问专家（携带业务资产 Tab 上下文，由对应业务专家协助分析或补全）。
10.3.2 自家公司介绍
左栏卡片展示来自公司资料的公司名称、行业、规模、更新时间，以及公司介绍与核心优势正文。字段为空时显示「待补充」；卡片右上角对话完善与顶栏「完善公司介绍」作用相同。
10.3.3 产品资料与分析
右栏卡片汇总产品资料与最新产品诊断，是后续找客户、写邮件的定位基准。上方常显示定位完整度、价格判断、置信度；下方列出核心价值、市场定位、目标客户画像、价格依据，以及最多四条产品卡片（含卖点、应用场景等）。无产品时提示通过「完善产品分析」写入业务库。
10.3.4 客户开发信息
页面底部客户开发信息区展示闭环相关摘要（非明细列表）：高分线索、近期候选、最近调研各至多三条。明细请在线索、邮件等 Tab 或第 7 章工作台查看；可点完善客户开发信息通过对话更新。
10.4 客户列表模块
10.4.1 本模块内的列表通用能力
筛选：在「客户」页签点击工具栏展开筛选，在筛选区填写或选择时间、负责人、关键词、阶段等字段，再点应用/查询；表格只保留符合条件的行。需要扩大范围时，清空筛选条件后再次应用。
刷新：点击工具栏刷新，客户端按当前筛选条件重新请求并刷新客户列表。
导出 Excel：确认筛选结果无误后，点击工具栏导出 Excel。当前无符合条件数据时，导出按钮为禁用态，需先调整筛选。导出结束后按界面提示路径取回 Excel 文件，打开核对表头与行数。
问专家：点击问专家，客户端将当前页签（客户）与当前筛选条件写入任务上下文并打开任务页，由系统为该页签配置的业务专家继续对话；效果见图 8-12。
10.4.2 客户单条资料编辑
在列表中打开某客户的编辑面板或侧栏，维护基础资料、标签、负责人等字段，保存后返回列表应看到更新后的值。
10.5 线索模块
10.5.1 本模块内的列表通用能力
切换到线索页签后，下列能力与客户列表在交互上同一套范式，仅筛选字段与列含义随「线索」变化。
筛选：展开筛选区，按阶段、状态、负责人、时间、关键词等缩小线索集合，点应用/查询。
刷新：点刷新，按当前筛选重新加载线索列表。
导出 Excel：在筛选结果确认后导出。
问专家：携带线索页签与当前筛选打开任务页专家对话。
线索列表主界面见图 8-02 子图 2；筛选、导出与问专家按钮位置见图 8-03、8-01。
10.5.2 线索单条编辑
字段级编辑（金额、下次跟进等）。与下节「流转」区分：本处为表单编辑。
10.5.3 线索阶段流转
将线索在管道阶段间推进或退回；与规则冲突时，界面会提示原因。
10.6 商机模块
10.6.1 本模块内的列表通用能力
在商机页签下：
筛选：展开筛选，按管道阶段、预计成交时间、负责人、金额区间等缩小集合，点应用。
刷新：点刷新，按当前筛选重新加载商机列表。
导出 Excel：在筛选结果确认后导出当前商机集合。
问专家：携带商机页签与当前筛选打开任务页专家对话。
商机列表主界面见图 8-02 子图 3；筛选、导出与问专家按钮位置见图 8-03、8-01。
10.6.2 商机单条编辑
在商机列表中打开单条商机的编辑界面，维护金额、预计成交日、关键联系人等字段，保存后回到列表。
10.6.3 商机阶段流转
在商机管道中调整阶段；保存后列表中的阶段列应更新。
10.7 邮件模块
10.7.1 本模块内的通用能力
使用邮件前完成第 4 章邮箱配置与连通测试。
同步：点击同步，从邮箱服务器拉取更新并刷新当前文件夹列表；同步进行中按钮显示加载动画或「同步中」文案。
刷新：点击工具栏刷新，按当前邮箱文件夹重新加载邮件列表。
子文件夹：在邮件页签内切换收件箱、发件箱、草稿箱、已删除，列表切换为对应文件夹的邮件。
筛选、导出、问专家：与客户、线索、商机列表相同：先应用筛选，再点「导出 Excel」或「问专家」；工具栏位置见图 8-03、8-01。
下面两图依次为收件箱与同步、新建邮件撰写。
10.7.2 收件箱：快捷标记、详情、关联线索
在收件箱列表中可对邮件做快捷标记；点进邮件后阅读正文与附件；在详情中把邮件关联到线索以便与客户资产打通。下面三图依次对应上述三步。
10.7.3 发件箱：列表、标记、详情、关联线索
发件箱列出已发送邮件；同样支持行上快捷标记、打开详情阅读完整发件内容，以及在详情中维护与线索的关联。下面四图依次为列表 → 快捷标记 → 详情 → 关联线索。
10.7.4 草稿箱：列表、详情编辑、关联线索
草稿箱存放未发出的邮件；在列表中打开草稿可继续编辑收件人、主题、正文与附件，发送前也可先绑定线索。下面三图依次为列表 → 详情编辑 → 关联线索。
10.7.5 已删除：列表与详情
已删除文件夹列出已移入回收站的邮件；在列表中打开可复核正文与附件，再使用恢复或彻底删除等操作。下面两图依次为列表 → 详情。
10.8 数据看板模块
10.8.1 本模块内的通用能力
刷新：在数据看板页签点击工具栏刷新，客户端重新拉取看板模块列表，并对当前列表中的每一个模块依次发起查询、刷新各自结果。
模块详情中的「执行」：从主区卡片进入某一模块后，在模块标题栏右侧有「执行」按钮（执行中显示「执行中…」且按钮暂时不可用）。内置模块与自建模块均提供该按钮。点击后，客户端仅针对当前正在查看的这一模块调用后端的只读 SQL 执行，用最新返回的数据更新下方的表格、图表或指标卡展示。与工具栏刷新的区别是：刷新会重载模块列表并对全部模块各执行一遍；「执行」只重跑当前模块，适合单独更新本块结果或在本模块报错后重试。
问专家：数据看板页签工具栏提供问专家，点击后携带当前页签与当前看板视图打开任务页，由系统为该页签配置的业务专家继续对话；入口位置见图 8-01，任务页效果见图 8-12。
导出（与列表页签的区别）：工具栏上的「导出 Excel」仅在客户、线索、商机、邮件四个列表类页签提供，用于按当前筛选导出 .xlsx；列表筛选与该项示意见图 8-03。切换到数据看板后，工具栏不提供可点击的「导出 Excel」。若某一模块以表格展示查询结果（含「图表 / 指标卡」模块下方用于对照的结果表格区块），该表格区域提供「导出 CSV」，将当前表格中的数据导出为 .csv（无列或无可导出数据时按钮为禁用）。
10.8.2 看板主区
主区域以卡片网格展示各数据查询模块：可横向滚动浏览模块标题与摘要，点击进入某一模块的详细结果视图。工具栏提供刷新（重新拉取模块列表并依次执行查询）与新建模块（打开自建 SQL 模块向导）。
10.8.3 系统预设的数据查询模块
下列模块为应用内置的数据查询结果界面，名称与统计口径由产品固定。在模块详情中可通过「执行」重新运行该查询并更新展示（与 10.8.1 所述一致）；也可使用工具栏刷新，与看板内其它模块一并更新。常见内置模块包括：按阶段的线索漏斗、带公司信息的线索详情、高分线索、最近 7 天新增线索、公司分布（国家或行业维度）、客户发现任务运行历史等。
10.8.4 自定义看板与自建模块
除内置模块外，您可自建自定义 SQL 查询模块并加入看板。「执行」及与「刷新」的区别见上文 10.8.1。其余常见操作如下。
- 新建模块：在看板工具栏点「新建模块」，填写名称、描述与只读 SQL（支持以
SELECT或WITH开头的查询），选择展示形态为表格、图表或指标卡，可先做 SQL 预览确认列名，再保存。 - 编辑：自建模块在模块详情标题栏点「编辑」，可修改名称、描述、只读 SQL、展示类型（表格、图表或指标卡）；选择图表或指标卡时，可配置与查询结果列对应的图表字段、指标卡字段等展示参数。主区内各模块卡片的排列与尺寸不可由用户拖拽或自由排版（由产品固定）。
- 删除：自建模块在详情标题栏点「删除」，可将该模块从看板移除。
10.9 跨模块操作建议
- 先补基准再找客：做客户开发或问专家前，先在业务资产（10.3，图 8-31）确认公司介绍、产品定位完整度；缺项用「完善公司介绍 / 完善产品分析」对话补齐，或从该页进入第 7 章闭环。
- 先筛选再动作：在客户、线索、商机列表先应用筛选，再导出 Excel 或问专家（示意见图 8-03、8-01、8-12）。
- 筛选范例：时间最近 7 天、状态活跃、负责人本人、关键词填行业或产品词、排序按最近活跃降序。
- 邮件与列表联动：先完成邮件同步（图 8-06），再回到业务列表对照。
- 自检：筛选结果与条件一致；导出文件可打开；问专家后任务页已带入预期上下文。
11. 定时任务页面
在左侧「能力」等区域进入定时任务页面，用于按计划在后台触发 Agent 执行、管理任务模板并查看运行记录。主界面顶部有三个页签：任务、历史、模板（与客户端文案一致）。当您进入新建任务、编辑任务或某一任务的详情时，页签与「新建任务」按钮会暂时隐藏，请用左上角的返回箭头回到带页签的主视图。
11.1 「任务」页签
作用：查看与管理已创建的计划任务；在此发起新建任务，或从列表进入详情 / 编辑。
- 任务列表：表格列为标题、计划于（调度摘要）、状态、更多。点击标题行进入该任务的详情。行内开关用于启用或禁用该任务。
- 「更多」菜单（⋮）：立即运行——不等下次计划时间，立刻向后端请求执行该任务一次（执行中菜单项会不可用）；编辑——打开表单修改配置；删除——经确认后移除该任务。
- 新建任务：仅在「任务」页签且处于列表主视图时，右上角显示新建任务。打开表单后，可填写任务名称、描述、计划类型（如每隔一段时间、指定日期时间、或 Cron 表达式与时区）、是否启用、会话目标（主会话 / 独立会话）、唤醒模式、负载类型（系统事件或 Agent 轮次及对应执行内容）、超时、投递方式（如播报、Webhook 等）等；保存后回到列表。表单内亦可点引用模板打开模板选择器。
- 任务详情：展示该任务的执行提示词、调度与运行配置、最近运行状态，以及仅属于该任务的运行历史列表。历史行上若存在关联会话，可提供查看会话打开会话内容。详情顶部另有编辑、立即运行、删除图标按钮，与列表菜单中能力一致。
11.2 「历史」页签
作用：跨任务汇总展示所有计划任务的最近运行记录（与「任务」详情里单任务的历史不同）。
- 列表列包括任务标题、开始时间（及耗时）、状态（成功、失败、跳过、运行中等）。
- 若某次运行关联了可打开的会话，点击该行可进入查看会话，在弹窗中浏览该次执行对应的会话内容（若会话尚未同步完成，界面会提示重试）。
- 列表底部在数据量较大时可出现加载更多，用于分页拉取更早的运行记录。
11.3 「模板」页签
作用：按分类浏览预置的任务模板，阅读说明后一键带入「新建任务」表单，减少从零填写的工作量。
- 模板按分类区块排列；点选某一模板卡片可打开预览弹窗，查看标题、说明与模板正文（提示结构）。
- 在预览中点击根据模板创建任务后，会切换到任务页签并打开新建任务表单，且已根据所选模板填入相应字段，您可继续修改计划与投递选项后再保存。
12. IM 助手
本章说明客户端中与即时通讯相关的两类入口：一是设置 → IM 机器人（界面标签文案为「IM 机器人」）中的多平台网关配置页；二是在 WhatsApp 已启用时，侧栏能力下展开的IM 助手 → WhatsApp，用于查看会话历史并向任务页注入总结指令。
12.1 入口与总览
设置路径：打开设置，点选左侧IM 机器人，进入多平台集中配置界面（左侧为平台列表，右侧为当前平台的表单与状态）。
侧栏路径：当 WhatsApp 通道在配置中为启用时，主界面左侧能力区域可出现IM 助手折叠项；展开后点WhatsApp，将打开会话历史面板（见 12.4），并不等同于进入「设置」页。
12.2 页面结构（IM 机器人配置页）
- 左侧平台列表：展示当前区域可见的 IM 平台图标与名称。点击某一平台即切换右侧配置区。列表最右侧为启用开关：用于打开或关闭该通道；开关外圈颜色用于区分已连接（绿）、已启用但未连上（黄）与关闭（灰）。WhatsApp 在未启用时可能以单独条目出现在列表底部，便于先进入配置再打开开关。
- 右侧标题区：显示当前平台图标、「{平台名}设置」文案，以及已连接 / 启动中 / 未连接状态徽标，与网关实时状态对应。
- 右侧内容区：随所选平台切换；下方各节以 WhatsApp 为例说明。
12.3 以 WhatsApp 为例（右侧配置区）
在左侧选中 WhatsApp 后，右侧自上而下通常包括以下能力（与界面一致）：
- 引导步骤：顶部为分步说明卡片，并可点击外链查看更完整的对接文档。
- 扫码连接：主按钮文案为扫码连接 WhatsApp。点击后依次出现加载、二维码展示与等待手机确认等状态；成功后显示已连接提示。若失败，界面展示错误原因与提示文案，并可使用清理会话并重试扫码（需确认）清除旧会话后重新发起扫码流程。
- 使用模式：可在专用号码（推荐）与个人号码（低门槛）两种模式间切换并自动保存；下方说明当前默认策略侧重降低接入门槛，可在高级设置中收紧。
- Agent 自动回复：复选项。开启时，私聊与群内 @ 你的消息会触发模型自动回复，并载入与 OpenClaw 网关一致的工作区引导（含 SOUL.md 等）；关闭时仍接收消息（含会话历史面板中的记录），但不会调用 Agent 或发出回复。
- 策略提示条：当私聊策略为「白名单 + 通配」等低摩擦组合时，界面会显示醒目的安全提示横幅，提醒收紧策略。
- 配对码：当私聊策略为配对模式时，展示配对码输入与批准操作区，用于人工确认新对话。
- 高级设置（折叠）：展开后可编辑由模式决定的详细字段（优先使用动态表单）；在简化回退路径下，可直接调整 DM Policy（私聊策略）与群策略等选项，多数字段在失焦时写入并触发保存。
- 连通性测试：提供测试连通性（或已测后的重新测试）按钮，对当前 WhatsApp 网关做一次检查，结果在弹窗中分项展示。
- 错误信息：若网关返回最近错误，会在表单下方红色区域展示，便于排查。
12.4 侧栏「IM 助手」— WhatsApp 会话历史面板
从侧栏能力 → IM 助手 → WhatsApp打开全屏遮罩面板（标题为 WhatsApp）。
- 左栏：按时间列出最近会话；每条展示标题/ID、预览文案、最后消息时间与消息条数。点击切换当前会话。
- 右栏上区：展示当前会话标识；可填写总结条数（1～100，默认 30）与总结指令（可空，空则使用内置默认指令）。
- 右栏中区：滚动查看该会话解析后的消息时间线（含客户消息、账号侧消息与 Lora 自动回复等，与界面说明一致）。
- 右栏底栏：清空本地历史会清除本机入库的入站历史（带确认）；一键注入 /wa-summary 根据当前会话 ID、条数与指令生成命令，写入任务页输入区并关闭面板，便于您直接发送总结类任务。
说明文案提示：面板内容侧重入站会话的查看与总结，与「设置」中的网关启停、扫码登录互为补充。
13. 任务记录
主界面左侧任务记录列出与智能体协作的历史会话；点击某条可切换到对应上下文。搜索框占位为「搜索任务」，按会话标题与预览筛选。置顶会话排在组内最前，其余大致按最近活动时间排序。每条可显示相对时间与状态（如运行中、已完成、已停止、错误等，以界面为准）。折叠侧栏不会清空列表；若已处于批量操作模式，折叠侧栏会退出批量模式。
13.1 搜索与列表
在「任务记录」标题旁使用搜索框输入关键词即可缩小列表范围；列表项展示标题、预览、相对时间与状态等。
13.2 单条「⋯」操作菜单
每条会话右侧的⋯菜单中通常包含：批量操作、重命名、置顶任务或取消置顶、删除任务（删除类操作带确认）。重命名支持 Enter 确认、Esc 取消。
13.3 批量模式
通过「批量操作」进入多选后，列表左侧出现勾选框，底部为全选、红色删除（常带已选数量）与取消；批量删除前有确认。
14. 设置页面
设置页在左侧以标签切换各配置区块（如通用、模型、IM 机器人、邮箱、诊断、关于等），右侧为对应表单与按钮，用于维护语言与主题、模型与密钥、即时通讯网关、邮箱账户、运行与环境检查，以及版本与手册入口等全局项。各区块的详细配置与连通测试等，多已在初始化与 IM 能力等前文说明；本章以下方截图按标签顺序列出，方便您与客户端设置页逐项对照，并附简短自检要点。
14.1 标准配置检查项
- 语言设置为团队常用语言。
- 模型连接测试通过。
- 任务页工作目录已选择（路径正确）。
- 邮箱连接测试通过（如需邮件能力）。
- IM 机器人已按需连接（如需 IM 能力）。
- 诊断页无关键阻塞项。
以上各项完成后，绝大多数日常任务都可稳定运行。
14.2 设置变更回读校验
- 修改任意设置项并保存。
- 切换到其他标签页后再返回。
- 确认修改值仍存在。
14.3 设置异常处理
- 保存后值丢失：重新保存并再次回读。
- 连接测试失败：返回配置页重填参数。
- 页面卡住：切换标签后返回当前页。
15. Skill 与 MCP 页面
Skill 与 MCP 用于扩展智桥能力。日常使用您只需知道入口在哪、列表是否正常显示、有无明显报错即可。
15.1 这两页打开后请您关注
- 页面能正常打开，无长时间空白。
- 列表或连接项的状态文字能看清。
- 没有整块报错把内容挡住。
16. 常见问题
- 手册入口点击异常：确认是否有浮层遮挡，尝试切换页面后再点一次。
- OpenClaw 网关启动失败或登录后主界面长时间无法操作：请先完全退出并重启应用，再次等待网关加载；仍失败请联系管理人员。
- 社媒授权失败：确认应用拉起浏览器中完成登录，并执行验证。
- 业务数据为空：检查工作目录、筛选条件、邮件同步状态。
- 结果不符合预期：在同一会话追加约束进行迭代。
16.1 用户自助恢复顺序
- 手册入口异常：先切页重试，再关闭当前弹窗后点击「圆形问号」手册入口。
- 社媒授权失败：保持授权窗口开启，回到客户端点击“验证连接”。
- 数据为空：先清空筛选，再检查工作目录和邮件同步状态。
- 结果不稳定：先要求“输出提纲”，确认后再让系统生成正文。
16.2 其他高频故障处理
- 附件上传失败：缩短文件名并改用工作目录文件重试。
- 导出文件找不到：在工作目录按时间排序查找最新文件。
- 邮件同步无结果：先检查邮箱测试，再缩小范围重试。
- 问专家无上下文：重新应用筛选后再次点击问专家。
- 页面卡住：切换页面后返回，仍异常则重开客户端。
16.3 FAQ（高频问题）
- Q：第一次输入任务不知道怎么写？ A：按 5.6「高质量输入模板」填写目标、约束、输出格式与语气后发送。
- Q：结果太长怎么变短？ A：追加“压缩到 120 词以内，保留核心动作”。
- Q：格式不符合要求怎么办？ A：追加目标格式并要求按该格式重写。
- Q：社媒授权一直失败怎么办？ A：先区分桥接/扩展与平台登录：扩展未连接按 9.2 与「Browser Bridge 扩展启用指引」处理；桥接已就绪按 9.3 走连接与验证。仍失败按 9.5 排查并按 9.6 记录信息。
- Q：筛选后数据过多怎么办？ A：追加负责人、时间范围、状态三个字段。
- Q：邮件同步后看不到新数据怎么办？ A：先确认邮箱测试通过再同步。
- Q：问专家结果不稳定怎么办？ A：先提纲后正文，每轮补充限制条件。
- Q：OpenClaw 网关启动失败或登录后主界面长时间无法操作？ A：请先完全退出客户端（见下条「如何完全退出」）后重新打开，再次等待网关加载；仅点窗口关闭按钮通常不够。仍失败请联系管理人员处理。
- Q：点了窗口右上角关闭（✕）算退出吗？ A：不算完全退出。智桥会把主窗口隐藏到后台，进程与网关仍在运行，便于您稍后从托盘再次打开。若需结束任务、释放资源或按上文「完全退出后重启」，请使用托盘菜单中的退出（见下条）。
- Q：Windows 上如何完全退出智桥？ A：在屏幕右下角任务栏通知区域（时钟旁，可能被收起到「^」隐藏图标里）找到智桥托盘图标（悬停提示多为 CogniBridge），右键打开菜单，选择退出。左键单击托盘图标用于重新显示主窗口。菜单中另有「打开 CogniBridge」「新建任务」「设置」等快捷项。
- Q：Mac 上如何完全退出智桥？ A：在屏幕顶部菜单栏右侧找到智桥托盘图标，右键（或 Control+单击）打开菜单后选择退出；也可使用 ⌘Q，或在 Dock 中右键智桥图标选择「退出」。点窗口左上角红色关闭按钮与 Windows 类似，多为隐藏窗口而非结束进程。左键单击菜单栏托盘图标可重新显示主窗口。
- Q：侧栏底部的「退出登录」和托盘「退出」一样吗？ A：不一样。侧栏账号区的退出登录仅结束当前账号会话，客户端仍可保持运行；托盘菜单中的退出才会关闭智桥进程（含后台网关等）。
- Q：Windows 如何安装智桥？安装路径有什么要求？ A：运行团队提供的 CogniBridge 安装程序（
.exe），按向导下一步；若出现 UAC 提示，请选择允许（安装需管理员权限）。在「选择安装位置」时，请把程序装在纯英文路径下（路径中的每一级文件夹名仅使用英文字母、数字及常见符号，不要含中文或其它非 ASCII 字符），否则内置网关、Git Bash、Python 等组件可能出现异常。推荐示例：C:\Program Files\CogniBridge、D:\Apps\CogniBridge、C:\Software\CogniBridge。不推荐示例：C:\用户\智桥、D:\我的软件\CogniBridge、C:\程序\智桥。安装完成后可按提示立即启动。 - Q：Windows 如何卸载智桥？ A：卸载前须先在任务栏右下角托盘菜单中退出智桥；若未退出，卸载可能因程序仍在运行而失败或中断。然后在设置 → 应用 → 已安装的应用（或「程序和功能」）中找到 CogniBridge 并卸载，或在开始菜单使用对应卸载项。卸载程序会尝试结束仍在运行的进程，但无法保证在所有情况下都能成功。卸载时通常会删除本机应用数据目录（如
%APPDATA%\CogniBridge下的配置与缓存）；若需保留，请在卸载前自行备份。您在任务页自行选择的工作目录不会随卸载自动删除。 - Q：Mac 如何安装与卸载智桥？ A：安装：打开团队提供的
.dmg，将 CogniBridge 拖入「应用程序」文件夹；首次打开若系统提示来自未识别开发者，请在系统设置 → 隐私与安全性中允许打开。路径一般位于/Applications/CogniBridge.app，系统默认即为英文路径，通常无需额外调整。卸载：先在菜单栏托盘或 Dock 中完全退出应用，再将「应用程序」中的 CogniBridge 移到废纸篓并清空。若需清除本机配置与缓存，可手动删除用户目录下的应用数据（常见为~/Library/Application Support/CogniBridge，以本机实际为准）；任务工作目录若在您自选位置，需自行决定是否保留。