夜雨聆风
WorkBuddy 高频 FAQ 科普文档
> **什么是 WorkBuddy？** 桌面级职场 AI 智能体，能听懂 → 规划 → 执行 → 交付，可操作本地文件、跨步骤完成复杂任务，不只是聊天。
>
> 本文档从 12 大类别、37 个高频问题出发，帮助你快速了解 WorkBuddy 的核心能力、使用技巧和常见问题。
—
## 📋 目录
1. [入门基础](#1-入门基础)
2. [任务对话](#2-任务对话)
3. [技能与专家](#3-技能与专家)
4. [连接器](#4-连接器)
5. [自动化与记忆](#5-自动化与记忆)
6. [安全合规](#6-安全合规)
7. [性能排错](#7-性能排错)
8. [协作分享](#8-协作分享)
9. [帮助反馈](#9-帮助反馈)
10. [账号问题](#10-账号问题)
11. [企业智能体](#11-企业智能体)
12. [操作指导](#12-操作指导)
—
## 1. 入门基础
**Q1：WorkBuddy 和普通 AI 对话有何区别？**
普通 AI 主要是”你问我答”，WorkBuddy 是桌面级职场 AI 智能体——它不只是聊天，而是能听懂你的需求、自动规划步骤、执行操作并交付成果。它可以操作本地文件、跨多个步骤完成复杂任务，真正实现”说完就做完”。
**Q2：它和 CodeBuddy、智享 AI / OpenClaw 是什么关系？**
它们同属腾讯云 AI 工作台家族：
– **CodeBuddy** 偏向代码开发和编程辅助
– **WorkBuddy** 偏向通用职场办公
– **OpenClaw** 面向伙伴 / 客户经营场景
**Q3：支持 Mac 和 Windows 吗？怎么安装？**
双端都支持。安装步骤：官网下载客户端 → 登录腾讯云账号 → 首次启动授权本地目录访问权限。
**Q4：免费吗？积分如何消耗、怎么查账单？**
提供免费额度 + 积分计费模式。查询路径：账户 → 用量 / 账单 / 发票，企业用户还可以申请开票。
—
## 2. 任务对话
**Q5：怎么发起第一个任务？提示词有什么技巧？**
写清四个要素即可，无需复杂咒语：
1. **目标** — 你要做什么
2. **输入** — 提供什么材料
3. **期望产出** — 希望交付什么
4. **约束** — 有什么特殊要求
系统会自动拆解步骤并执行。
**Q6：Craft / Plan / Ask 三种模式什么时候用？**
| 模式 | 用途 | 场景 |
|——|——|——|
| **Craft** | 直接动手执行（默认） | 日常任务 |
| **Plan** | 先出方案再执行 | 复杂改动，需要确认方案 |
| **Ask** | 只回答不动手 | 咨询、审阅、不需要执行 |
**Q7：支持哪些文件类型？有大小限制吗？**
支持 doc / xlsx / pptx / pdf / csv / 图片 / 音视频等常见格式。单文件有大小上限，超大文件建议拆分或挂载本地目录处理。
**Q8：任务跑到一半想改需求怎么办？**
直接在对话框追问或补充约束。如果需求分歧较大，可以暂停当前任务或新建分支任务，避免上下文污染。
**Q9：结果不满意如何快速迭代？**
具体指出”哪段不对 + 期望改成什么样”。可以在全部文件或变更里查看 diff（差异对比），然后选择回退或继续优化。
—
## 3. 技能与专家
**Q10：什么是 Skill？和提示词模板有何不同？**
Skill 是封装好的可复用工作流，包含说明 + 脚本 + 资产，可以自动加载执行。它比纯提示词更可靠、可分享、可版本化，相当于把”高手经验”打包成了一个可复用的工具。
**Q11：怎么找到适合我的 Skill？**
两种方式：
1. 去技能市场浏览
2. 直接说”帮我找一个能做 XX 的技能”，系统会调用 `find-skills` 自动检索并安装
**Q12：怎么自己创建 / 修改 / 分享 Skill？**
通过 `skill-creator` 引导生成 SKILL.md 文件：
– 个人使用：存入 `~/.workbuddy/skills`
– 团队共享：放到项目级 `.workbuddy/skills` 目录，跟随代码仓库一起管理
**Q13：专家中心是什么？什么时候用？**
WorkBuddy 内置 100+ 领域专家（财务、法务、营销、研发等），从左侧专家入口进入。面对专项问题时，专家比通用模型更精准、更专业。
**Q14：常用必装 Skill 推荐？**
– Agent Browser（浏览器自动化）
– 办公文档四件套
– Local Whisper（本地语音转文字）
– Web Search（网络搜索）
– Frontend Design（前端设计）
– yt-dlp-downloader（视频下载）
—
## 4. 连接器
**Q15：支持接入哪些办公平台？**
连接器开箱即用，覆盖：微信 ClawBot、企微、QQ、飞书、钉钉、元宝派；以及腾讯文档 / 腾讯会议 / 乐享 / TAPD / Notion / QQ 邮箱等。
**Q16：连接器显示 disconnected 怎么办？**
点击该连接器进入授权页面，重新登录绑定即可。如果是企业账号，需要管理员先在后台开通对应应用。
**Q17：怎么把产物发回到微信小程序 / 手机？**
在小程序连接设置里打开**「产物回传到小程序」**开关，`deliver_attachments` 工具会自动推送结果文件到手机。
**Q18：能接 MCP 服务器吗？**
可以。编辑 `~/.workbuddy/mcp.json`，按文档格式添加 `mcpServers` 条目，重启后即生效。
—
## 5. 自动化与记忆
**Q19：怎么设置定时任务 / 自动化？**
直接说”每天早上 8 点帮我做 XX”即可创建。支持：
– **一次性（once）**：在指定时间执行一次
– **周期（recurring）**：按周期重复执行
– 还可以设置 `validFrom` / `validUntil` 有效期
**Q20：自动化跑失败 / 想改时间怎么办？**
在自动化页面查看运行历史，定位失败原因。通过对话直接说”修改 / 暂停 / 删除某自动化”即可，**不要手动改数据库**。
**Q21：记忆功能是什么？会泄露隐私吗？**
WorkBuddy 会把跨会话有用的信息存到本地 `.workbuddy/memory` 目录，**仅本机可读**。敏感信息不会主动写入，你也可以随时手动清理。
**Q22：Claw 远程控制是什么？**
通过手机或小程序远程下发任务并接收产物，适合在外出时临时遥控电脑：跑批处理、查数据、写文档等。
—
## 6. 安全合规
**Q23：会动我桌面 / Downloads 里的文件吗？数据安全吗？**
默认只读授权目录。删除 / 移动操作需要明确确认，且优先放入回收站。禁止递归删除个人目录（如桌面、下载、文档等）。数据本地优先，不会主动外传。
**Q24：`.workbuddy` 文件夹能删吗？**
**不能。** 它存放任务记忆、技能、配置和产物，删除会导致上下文丢失。如需清理，请按文件类型选择性删除。
**Q25：遇到内容被拒答怎么办？**
涉及政治、隐私、违法、色情等敏感内容会按合规规则拒绝。请调整为合法合规的需求重新表述即可。
—
## 7. 性能排错
**Q26：跑得慢 / 卡住了怎么办？**
优先检查：
1. 网络连接是否正常
2. 积分余额是否充足
任务过长可以要求分阶段交付。模型配置里可以切换更快或更强的版本。
**Q27：怎么切换 / 配置大模型？**
在模型配置中可选择 Claude / Hunyuan / DeepSeek 等。可分别设置：
– 主力模型
– 思考模型
– 轻量模型
Skill 还可以指定专属模型。
**Q28：能离线使用吗？**
本地工具（如读写文件、Local Whisper 等）可以离线使用；调用云端模型、网络搜索、连接器等功能需要联网。
**Q29：下载 WorkBuddy 之后打不开？**
1. 检查操作系统：Windows 10 以下版本可能不兼容
2. 检查杀毒软件是否误拦截了程序
—
## 8. 协作分享
**Q30：多人协作时怎么共享任务和技能？**
– **Skill 共享**：把 Skill 放到项目级 `.workbuddy/skills` 目录，跟随仓库同步
– **任务结果同步**：通过腾讯文档 / 乐享一键同步到团队空间
—
## 9. 帮助反馈
**Q31：哪里反馈 Bug、提需求或获取帮助？**
– 侧边栏「帮助与反馈」提交工单
– 官网
[codebuddy.cn/docs/workbuddy](https://codebuddy.cn/docs/workbuddy) 查看最新指南、案例与 FAQ
—
## 10. 账号问题
**Q32：客户有 A 主体和 B 主体，用 B 主体注册下单 WorkBuddy，能关联到 A 主体的企业微信吗？**
**无法关联。** 单个账号只能单独使用，不能跨主体关联。
—
## 11. 企业智能体
**Q33：管理员在后台发布了一个 Skill，全员可见，但在 WorkBuddy 里搜不到？**
后台发布的 Skill 目前只作用于 Cloud Agent（云端智能体）。如果想作用到 IDE 端，需要等待版本更新。
—
## 12. 操作指导
**Q34：WorkBuddy 积分用完后，配置了智谱的 API Key，还提示积分不足？**
Craft / Plan 模式会消耗 WorkBuddy Credits 积分，即使设置了自定义模型 API，这个模式下的积分判断仍然生效。**可改用 Ask 模式**，该模式下会直接调用你的自定义模型 API，不消耗 WorkBuddy 积分。
**Q35：企业版 WorkBuddy 提示”已达请求限制，一分钟内最多两次”，使用的是自定义模型？**
1. 企业版 WorkBuddy 本身没有请求频率限制
2. 这个限制来自**自定义模型的 API 限流**
3. 目前 WorkBuddy 产品侧不支持调整请求频率限制
**Q36：在管理后台创建了 2 个 Skill，也配置了下发策略全员可见，但同事的 WorkBuddy 上看不到？**
目前 WorkBuddy 还没有适配后台 Skill 下发功能，**预计 6 月底可以实现**。
**Q37：为什么有的移动端可以远程连接到企业版的客户端？**
1. 企业的创建者和个人账号默认是打通的
2. **预计 6 月底前**可以支持微信小程序登录企业版账号
—
## 📌 快速速查表
| 场景 | 操作建议 |
| 新用户上手 | 了解 Craft/Plan/Ask 模式，写清四要素提示词 |
| 想自动化 | 说”每天 XX 点帮我做 XX”即可创建 |
| 结果不满意 | 具体指出哪段不对 + 期望改成什么样 |
| 连接器断开 | 重新登录绑定，企业账号需管理员开通 |
| 积分不足 | 可改用 Ask 模式调用自定义模型 API |
| 搜不到后台 Skill | 目前只作用于 Cloud Agent，IDE 端待更新 |
| 打不开客户端 | 检查 Win10 以下兼容性 / 杀毒软件拦截 |