账户与维护
设置、数据与诊断
逐项设置浏览器、聊天、隐私、启动与数据，并完成依赖安装和故障诊断。
#设置页管理本机体验与运行环境
进入 设置，可以调整智能体浏览器、聊天呈现、隐私、启动、数据目录和本机运行环境。这里的部分选项只改变显示方式，另一些会影响智能体如何访问浏览器或从哪里读取本地资料。修改前先看清每项说明。
APP CAPTURE中文浅色界面的设置页，显示智能体、聊天与应用设置。
#智能体设置：浏览器模式
独立模式
智能体启动一套隔离的 Chrome，不使用你日常浏览器中的账号、Cookie 和扩展。适合大多数标准自动化，也适合希望把工作登录状态与个人浏览器分开的团队。
如果目标网站需要登录，请在这套隔离浏览器中完成登录。你在日常 Chrome 中已经登录，并不代表独立模式也已经登录。
CDP 模式（连接你的 Chrome）
智能体连接你自己的 Chrome，可以使用已有账号、Cookie 和扩展。适合必须复用现有登录状态或浏览器扩展的任务，但也意味着智能体访问的是你的真实浏览器环境。
首次切换时，TK匠会先要求确认。当前 Chrome 会被关闭并以远程调试模式重新启动，未保存的页面内容可能丢失；以后启动 TK匠时，Chrome 也会随之打开。Windows 首次切换后可能需要重新登录网站，但扩展、书签和历史记录会保留。
在切换前先保存网页中的草稿、表单和未提交操作。如果任务不需要你的现有登录状态，优先保留独立模式。
#聊天设置
这三个开关只改变聊天页如何显示运行过程，不会改变业务审核规则或授予新的操作权限。
显示代理处理状态
等待回复时显示“处理中、正在使用功能、正在生成”等状态。开启后更容易判断智能体仍在工作，适合耗时分析和多步骤任务；关闭后聊天界面更简洁。
保留工具调用记录
把执行过程中的调用条目保留在聊天记录中，对话结束后仍可查看。需要复盘智能体做过什么时建议开启；只关心最终答案时可以关闭。
折叠过长消息
自动折叠超过约 15 行的智能体消息。它不会删减内容，仍可手动展开单条消息。处理长分析报告时开启，可以减少滚动距离。
#应用设置
主题色
选择蓝、橙、绿、粉、紫、金、红、蒂芙尼或灰色作为界面强调色。它只改变按钮、选中状态等视觉强调，不改变业务数据和智能体行为。
隐私模式
隐私模式会遮盖手机绑定二维码、店铺名称、商品名称和商品图片；你自己设置的店铺别名仍会显示，便于区分业务。适合录屏、直播、投屏或向外部人员共享屏幕时使用。
隐私模式只处理界面显示，不会删除原始数据，也不能替代账号权限和团队的数据管理制度。共享屏幕前仍应检查当前页面是否还有其他敏感内容。
#教程模式
教程开关控制产品内的步骤引导。新成员第一次熟悉功能时建议开启；已经熟悉界面、不希望反复看到引导时可以关闭。它不会影响官网用户手册，也不会关闭任何业务功能。
#启动：登录时自动启动 TK匠
开启后，登录电脑系统时会自动启动 TK匠。需要客服、达人、定时任务等能力持续运行的设备建议开启，同时保证设备不会长期关机或休眠。
这个开关只负责启动应用。业务是否能继续执行，还要看网络、模型、渠道、店铺授权和对应业务配置是否正常。
#数据目录
OpenClaw 状态目录保存智能体记忆、文档和技能。页面会显示当前路径，并标注正在使用 默认 目录还是 自定义 目录。
修改
点击 修改 后选择一个已经存在的文件夹。新路径要位于稳定、长期可用且空间充足的磁盘上。设置完成后必须重启 TK匠才会生效。
修改路径是在告诉 TK匠下次从哪里读取状态，不等于自动把旧目录内容复制到新目录。需要保留旧记忆、文档或技能时，应先备份，并确认迁移后的目录结构和内容完整。
恢复默认
只有当前使用自定义目录时才会显示 恢复默认。点击后，TK匠会在下次重启时重新使用默认目录；这个操作只是切换路径，不会删除原自定义目录中的文件。
#上传日志
登录账户后，数据目录区会显示 上传日志文件。它会把当前应用日志发送给支持团队，用于定位启动、连接或运行问题。日志文件尚未生成、超过 10 MB 或上传过于频繁时，页面会给出对应提示。
日志可能包含排查问题所需的运行细节。建议只在支持人员要求时上传，并遵循团队的数据处理要求。上传成功不代表问题已经自动修复，还需要把复现时间、操作步骤和现象一并提供给支持人员。
#遥测与隐私
发送匿名使用统计数据控制是否分享匿名运行数据。页面明确列出了范围：
会收集：
- 应用启动和停止；
- 功能使用，例如配置渠道或修改设置；
- 不含个人数据的错误报告；
- 运行时间和性能等运行统计。
不会收集：
- 对话内容；
- API 密钥或凭据；
- 自定义提示词；
- 个人信息。
这个开关与店铺数据同步、渠道消息和日志上传是不同事项。关闭遥测不会删除已经保存在本机的业务数据。
#系统依赖
安装依赖会打开独立安装窗口，检查并安装智能体运行所需的 Git、Python、Node.js 和 uv。国内网络环境会使用相应的加速方式。
以下情况适合运行依赖安装：
- 首次安装时依赖检查未完成；
- 诊断明确提示某个依赖缺失或版本不可用；
- 系统升级或清理软件后，原有命令不再可用。
它不会修复模型余额不足、店铺授权过期、渠道配置错误或业务规则问题。安装完成后，如果原问题仍然存在，再运行诊断并阅读具体输出。
#诊断
诊断区会持续显示检查输出，并在结束后标记成功或错误以及退出码。
运行诊断
点击 运行诊断，让 TK匠检查当前本机运行环境。第一次排查问题时先用这个选项，保留输出中第一个明确的错误和退出码。
运行并自动修复
点击 运行并自动修复，允许诊断程序对它支持修复的常见问题执行修复。建议先运行普通诊断、阅读问题，再决定是否自动修复。它不会替你完成模型充值、第三方登录、店铺授权或人工业务决策。
同一时间只能运行一项诊断。如果超过运行时限、程序入口缺失或本机环境无法启动诊断，页面会显示错误状态。
#按问题选择排查顺序
智能体打不开浏览器或网页操作失败
- 确认浏览器模式是否符合任务需要；
- 运行诊断；
- 只有输出提示缺少 Git、Python、Node.js 或 uv 时，再安装依赖；
- 使用 CDP 模式时，确认 Chrome 已由 TK匠重新启动，并重新检查登录状态。
聊天没有回复或业务 Agent 停止运行
- 查看模型、设备与运行配置中的模型和设备状态；
- 在账单与用量确认云模型额度与订阅；
- 检查对应消息渠道和店铺授权；
- 最后运行诊断，确认不是本机运行环境问题。
设置修改后没有生效
- 数据目录修改必须重启 TK匠；
- 浏览器模式切换要完成确认，并让 Chrome 按提示重新启动；
- 其他开关保存失败时，页面会显示错误提示，可重试一次后再运行诊断。
联系支持前准备什么
记录问题发生的准确时间、当前页面、操作步骤、期望结果和实际现象；运行一次诊断并保存首个错误与退出码。支持人员要求时，再上传日志。这样可以把“业务配置问题”“订阅或授权问题”和“本机环境问题”更快地区分开。