Repository navigation
FAQ
按问题类别整理了使用 BossClaw 过程中最常见的疑问与解决办法。
- 源码构建方式需要先安装 Node.js 20+（推荐 22）。
-
npm install会一并安装 Electron 二进制；若下载失败见 Q3。 - 只想直接使用，请下载 Releases 里的安装包，无需任何开发环境。
npm install --registry=https://registry.npmmirror.comElectron 二进制下载失败时：
set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ && node node_modules/electron/install.js更省事的方式是直接双击仓库根目录的
install-deps.cmd，它会自动处理镜像与重试。
- 先确认依赖已装好（
desktop-app/node_modules存在），否则先跑install-deps.cmd。 - 用
start-bossclaw.cmd --visible启动，保留控制台查看报错日志。 - 用
start-bossclaw.cmd --dev走 Vite dev server（HMR），便于观察加载情况。
设置环境变量后重新启动，查看诊断日志：
set BOSSCLAW_DEBUG=1
start-bossclaw.cmd --visible日志位置：userData/debug-render.log（DOM 检查 / 浏览器状态）。
v3 重建后首次启动会清空旧 persist:bossclaw 会话与 Camoufox 缓存（DATA_VERSION='v3-rebuild-20260815'）。重新在「设置」或内置浏览器中扫码登录一次即可，之后登录态会本地持久化。
- 确认已在「设置」页填写并测试通过 AI API Key（预设 OpenAI / DeepSeek / 通义千问 / 智谱 GLM / 硅基流动 / 火山方舟，或自定义 OpenAI 兼容端点）。
- 无密钥时相关功能降级为提示，不阻断其他流程（本地规则兜底仍可用）。
- 定制简历 / 岗位分析的结果可能受「设置 → AI 技能（Skills 层）」启停影响：关闭对应技能后，该作用域的 AI 调用不再注入增强约束。
可以。未配置 API Key 时，应用会把「完整提示词 + 用途 + 是否要 JSON」放进本地待答队列，由在线外部 Agent（如 MCP 客户端里的 Claude / WorkBuddy）用自有模型作答后回填：
- 前置：开启本地 Agent 控制桥（仓库根
start-bossclaw.cmd启动默认开启；打包版默认关闭，可用BOSSCLAW_CONTROL=1/--control-bridge开启），并在 MCP 客户端注册mcp/bossclaw-mcp。 - Agent 侧：用
bossclaw_agent_tasks长轮询领取（这次调用同时是心跳，应用只认最近 90s 内的心跳）、用自有模型生成、bossclaw_agent_submit回填；答不了就bossclaw_agent_cancel，应用立刻回落本地规则。 - 时限：单任务等 30~240s，超时或心跳失效即回落本地规则；JSON 纠偏最多 1 次。
- 边界：只搬运「提示词 ↔ 生成文本」，不能代替你发送 / 投递；回填内容仍要过应用的事实与口吻、校名披露、招呼语长度等校验，不合规会被本地规则替换。
- 隐私提醒：代答会把完整提示词（可能含简历摘要与岗位信息）交给你自己选用的 agent 客户端。
- 确认内置浏览器已打开 BOSS 直聘并登录（登录态持久化在本地，避免重复登录）。
- 在浏览器中打开目标岗位详情页，再点中栏「加入任务」。
- 页面结构若发生变化（BOSS 改版），任务会暂停并提示，请按反馈规范提交 Issue。
发送结果以右侧聊天文字气泡确认为准：未确认自己气泡时，不发送附件、不计成功、不跳下一岗位。请检查：
- 打招呼语非空（AI 生成失败会回退本地规则）
- 沟通对象与岗位一致
- 未出现验证码 / 安全验证（code 35 / 36 / 32 会立即停止交人工）
- 本地 Chrome / Edge 不可复用（BOSS 反爬对 Playwright 驱动的系统浏览器返回空壳页），请勿只安装浏览器
- 需执行
pip install 'camoufox[geoip]' && python -m camoufox fetch下载 Camoufox 原生内核（约 150MB）
首次启用时自动下载约 200MB 隐身 Chromium 到 ~/.cloakbrowser/ 并校验 Ed25519 签名。离线 / 受限环境可手动下载 .zip 后设置环境变量 CLOAKBROWSER_BINARY_PATH 指向本地二进制。
已支持。简历中心可在本地直接解析 PDF / DOCX / DOC（含旧版 Word 97-2003 二进制，以及「实为 RTF / HTML」的 .doc） / MD / TXT，全程不经网络。只有加密文件或纯图片扫描件解析不出文字，此时请用 Word / WPS 另存为 .docx / .pdf 后重新导入，或直接粘贴正文。
- 所有数据（简历、画像、筛选条件、API Key、任务记录）保存在本机 localStorage（
persist:bossclaw系列键）。 - 「设置 → 数据」支持导出 / 导入 / 清空本地数据，可据此备份与迁移。
- 不建议把包含真实简历、API Key 的导出文件提交到公开仓库或 Issue。
不会。这是项目的硬性边界：不绕过验证码与账户验证（code 35 / 36 / 32 立即停止交人工）、不自动换号、不突破平台限制。遇到安全验证会立即暂停，由用户人工处理。
BossClaw 数据本地优先：AI 只调用你自己配置的 Key（OpenAI 兼容端点），不经过第三方平台中转，密钥只存在本机。
先查看本 Wiki 与 desktop-app/README.md，再提交 Issue，请包含：
- BossClaw 版本（桌面版 v2.5.7，最新正式安装包）
- 操作系统与 Electron 版本
- 出错步骤
- 已隐藏隐私信息的截图（请勿上传含真实简历、手机号、邮箱、身份证信息、API Key 的截图）
- 错误页面中的完整错误信息
非 BOSS 平台的搜索采集两条通道都能走（引擎闸门 = 设置页是否启用隐身引擎：启用则 Camoufox、未启用则内置浏览器可视化采集，非 BOSS 为列表级，随后由内置浏览器按平台同源接口自动补齐详情 JD——智联走详情 JSON、猎聘走同源详情页 HTML，这条补齐不需要装 Camoufox；前程无忧暂无同源通道，只有列表字段）：
- 工作台登录（采集 + 工作台「一键投递」都用它）：在内置浏览器打开该平台并用「扫码登录」完成登录，登录态本地持久化
-
自动沟通登录（仅走「自动沟通」批量引擎时需要）：到「自动沟通」页确认对应平台卡片显示引擎就绪且已登录，未登录则点「登录」扫码（Cookie 按平台持久化
~/.bossclaw/camoufox-cookies-{平台}.json） - 到「设置 → 招聘平台」确认平台已勾选启用，且未把某平台从工作台采集多选里取消
- 只投 BOSS 时无需启用其他平台（设置 → 招聘平台 可整体取消勾选，但至少要保留一个启用平台）
自 v2.5.7 起，猎聘投递升级为 webview（preload）与 Camoufox（Python）双通道同源的「真实发送」口径：点「聊一聊」→ 校验草稿 / 会话未变 → 真实输入本岗位招呼语 → 发送 → 读取 IM 状态、确认新增本人文字消息才计成功（仅聊天窗打开 / 按钮变「继续聊」不再计成功）。因此不再依赖猎聘 App 里的预设招呼语文案；输入 / 发送前后命中风控即停止并交人工，草稿异常保留待人工核对。
智联平台侧每日约 100 次投递上限，默认每日投递目标即 100/日，接近上限自动停止交人工；其余平台（BOSS / 猎聘 / 前程无忧）默认 120/日。各平台独立计数、互不挤占，可在「设置 → 招聘平台」逐平台调整（0 = 不限，仍受平台侧上限与安全上限收窄）。
常见原因有三种，日志里都会写明原因：
- JD 已过投递截止日期（默认开启，主要作用于猎聘这类 JD 写明「截止日期：YYYY年MM月DD日」的平台）——只有 JD 显式写了截止日期且早于今天才会跳过，截止日当天仍有效；不想要这个过滤可到「设置 → 求职偏好 → 排除已过截止日期岗位」关闭。
- 外部网申 / 第三方外链岗位：安全不变量要求跳过，不在平台站内投递。
- 该岗位此前已投递 / 已沟通：不重复打扰同一 HR。
可以，但仅 BOSS 支持：到「自动沟通」页的「沟通与附件设置」打开「AI 跟聊监听」开关（需 BOSS 已登录且不在风控冷却期）。开启后引擎用一个常驻浏览器停在 BOSS 会话页，每 2 分钟巡检一轮，HR 发来新消息即带上完整聊天记录生成回复并发送；HR 明确拒绝则收口该会话；回复不占用每日投递配额。
- 回复中涉及的薪资期望 / 面试时间 / 到岗时间来自你手填的「沟通信息（AI 跟聊引用）」，留空则不会承诺任何这类信息。
- 猎聘 / 智联 / 前程无忧的 HR 回复请到各平台 App 内人工跟进。
自 v2.5.6 起，投递新增账号级作息保护，默认开启（可在「自动沟通 → 防封号节奏」调整或关闭，不改变既有速率上限与安全不变量）：
- 活跃时段：默认 8:00 – 23:00（每天约 15 小时，带 ±25 分钟每日抖动），窗口外自动暂停投递，等进入窗口再继续。
- 批次休息：每完成 15 个岗位休息 8–15 分钟（模拟真人停顿）。
因此非活跃时段或正处于批次休息时，投递会主动让路。这两项是账号级配置（工作台与自动沟通两个引擎同口径），且外部 Agent 不得经控制桥改写（CONFIG_DENY），只能由你在设置页手动调整。
v2.5.6 将内核从 Electron 31 升级到 42（Chromium 148），UA / UA-CH 由内核真实产生，并补齐请求头层的 Sec-CH-UA 系列；v2.5.7 进一步升级猎聘投递链路（真实输入招呼语 + 文字气泡确认）与控制桥 / 本地桥安全护栏。若从旧版升级，建议先在「设置」页核对执行模式、招聘平台与节奏设置，并按快速开始完成一次单条验收。