基础配置
解释 OpenCowork 的设置项、持久化文件与常见配置路径。
基础配置 / Configuration
设置面板 / Settings panel
通过右上角的设置按钮打开设置面板。常见的标签页包括：
- General / General
- Memory / Memory
- Analytics / Analytics
- Migration / Migration
- Provider / Provider
- Model management / Model management
- Model / Model
- Plugin / Plugin
- Channel / Channel
- MCP / MCP
- Web search / Web search
- Skills market / Skills market
- About / About
主要配置项 / Main configuration areas
AI 提供商
在 AI 提供商 中添加 provider 和 model。每个模型可配置：
- 名称
- Base URL
- API Key
- category：
chat/image visionthinkingreasoning- 价格信息（可选）
图像模型必须标记为
image，这样图像插件才会把它识别为可用输入源。
工作目录
工作目录决定文件工具和 Shell 工具默认作用的路径。你可以：
- 为全局设置默认目录
- 为某个项目单独指定目录
- 在会话中覆盖当前目录
代理
systemProxyUrl 会直接应用到 Electron 的默认 session 代理设置。
Web 搜索
可配置 Web 搜索提供商、API Key、超时参数等，让 WebSearch / WebFetch 工具可用。
消息平台 / Channels
聊天频道在 设置 → 聊天频道 中配置，配置会保存到 plugins.json。
MCP
MCP 服务器配置保存在 mcp-servers.json，并可按项目绑定。
持久化文件 / Persistence files
| 文件 | 作用 |
|---|---|
~/.open-cowork/data.db | 会话、消息、计划、任务、Cron、SSH、Wiki、Goal、Usage 等主要业务数据 |
~/.open-cowork/settings.json | 设置面板中的通用偏好 |
~/.open-cowork/config.json | 需要安全保存的配置片段 |
~/.open-cowork/mcp-servers.json | MCP 服务器配置 |
~/.open-cowork/plugins.json | 消息平台插件实例 |
~/.open-cowork/teams/ | Team Runtime 状态 |
~/.open-cowork/agents/ | 用户自定义 sub-agent |
~/.open-cowork/commands/ | 用户自定义 slash commands |
~/.open-cowork/prompts/ | 用户自定义 prompt 模板 |
~/.agents/skills/ | Skills 存放目录（内置内容首次运行后同步到这里） |
常见问题 / Common questions
为什么改了 provider 配置后立刻生效？
因为 provider 配置会通过本地持久化存储和 store 同步，不需要重新安装应用。
为什么系统代理会影响整个应用？
因为代理直接配置到了 Electron 的 defaultSession。
为什么我找不到 skills 目录？
Skills 不在 ~/.open-cowork/skills/，而是在 ~/.agents/skills/。