设置、维护与排障
在侧栏底部打开 账号与设置 → 设置。同一菜单可查看 个人资料(本机),也可快速切换浅色、深色或跟随系统,以及简体中文和 English。下面的目录涵盖当前版本的 13 个设置入口。

设置目录和账号页面。左侧列表可滚动。
| 设置 | 用途与操作 |
|---|---|
| 账号与登录 | 查看本地身份和 OpenCSG 状态。按提示登录、退出或切换分站点。切换后回到模型、远端知识库和广场核对可访问资源。 |
| 模型服务 | 管理已连接的服务、可用模型和创建默认值。操作步骤 |
| 连接器 | 管理外部应用、MCP 工具和全局连接。操作步骤 |
| 技能 | 查看已安装技能,搜索来源、安装或更新。操作步骤 |
| 知识库 | 浏览可访问的资料库和接入配置。操作步骤 |
| 外部消息 | 创建通知来源,将外部事件投递到已关联房间。操作步骤 |
| 运行环境 | 检查本机运行时的安装与版本,按提示安装 DSH 或重新检测。修改默认模板等设置后按页面要求保存和重启。 |
| 服务与访问 | 检查监听端口、对外地址和 API 访问令牌。按页面提示保存、重启并用新地址重开。 |
| 外观与语言 | 选择主题与界面语言。切换后直接检查工作区及设置是否按所选方式显示。 |
| 通知 | 设置轮次完成提醒,按平台提示授予系统通知权限。桌面系统禁用通知时,到系统设置开启。 |
| 已归档 | 查看已归档的智能体、任务及协作空间,恢复或永久删除。可控制归档前是否确认。 |
| 版本与更新 | 查看当前版本、检查更新和选择稳定版或测试版通道。按安装来源和平台可用的方式升级。 |
| 反馈与帮助 | 提交反馈、查看帮助、重放新手引导,或前往项目入口跟踪问题。 |
以下入口可对照演示截图。
| 入口 | 截图 |
|---|---|
| 运行环境 | 运行时状态与安装 |
| 服务与访问 | 监听端口与服务网址 |
| 外观与语言 | 主题与语言 |
| 通知 | 轮次完成提醒 |
| 已归档 | 归档与恢复 |
| 版本与更新 | 版本信息 |
| 反馈与帮助 | 写反馈与新手引导 |
服务与数据
默认应用数据目录为 ~/.csgclaw。配置、智能体状态、会话和计划分开保存,智能体工作目录也可能位于该目录之外。备份前停止服务,保留应用目录和你显式指定的工作目录。使用自定义 --config 时备份对应配置。恢复前先核对版本和实际数据位置。备份可能包含凭据、聊天和个人记忆,按私有文件保管。
- 监听地址决定服务在哪个地址和端口接收连接。仅自己使用时可保持回环监听。
- 对外网址供外部客户端和回调使用。反向代理部署需将认证回调路由回 CSGClaw。
- 访问令牌用于受保护 API。令牌通过 Authorization Bearer 请求头传递。部署前按服务配置确认保护范围及网络边界。
- 更新前可用
csgclaw upgrade --check检查 CLI 可用版本。正式安装包可按支持情况升级,源码构建按构建流程更新。桌面更新与 CLI 版本通道见命令行更新。 - 桌面版可使用原生通知和内嵌浏览器。原生功能依赖系统权限及应用发行形态。桌面通知 · 桌面日志
常见问题
| 情况 | 怎么检查 |
|---|---|
| 浏览器打不开 | 确认服务仍运行,复制终端显示的实际地址。端口被占用时按配置指南改端口再启动。 |
| Manager 未配置 | 打开配置入口选择已连接模型。模型服务没有可用模型时先解决认证或权限。 |
| 运行时找不到 | 在运行环境检查 Codex 或 DSH 状态。安装包缺少 Codex 时重新安装。DSH 按安装提示重试。 |
| 连接模型报错 | 分别核对服务、区域、Key、模型 ID、额度和网络。凭据变更后重新检测。 |
| 文件打不开或不能写 | 检查是否为远端智能体、会话目录是否锁定、执行模式和本机权限是否匹配。 |
| 连接器列不出工具 | 测试全局配置、检查凭据和服务,再看该智能体是否已绑定、启用、连接。 |
| 定时任务没有出现结果 | 检查服务是否运行、计划是否启用、下次执行时间、指派人是否存在和本次执行记录。 |
| 云端智能体找不到或离线 | 检查登录分站点和目录。若目录暂不可用,恢复连接后再查。发布端离线需由维护方恢复。 |
| 历史项目不见了 | 清除侧栏搜索及目录筛选,检查当前站点和 已归档。 |
| 通知没弹出 | 检查 设置 → 通知 和系统通知权限。 |
| 更新后功能不同 | 在 版本与更新 确认当前版本、通道与安装来源。 |
反馈与诊断
通过 反馈与帮助 写反馈时需要登录 OpenCSG。填写问题描述,可附最多 6 张 JPG、JPEG 或 PNG 图片,每张不超过 5 MiB。提交失败时按界面提示检查原因,先确认是否已收到再重试。也可以从设置打开 GitHub 反馈入口。
复现问题后记下版本、操作系统、发生时间、页面、复现步骤、预期和实际结果。对任务问题记下会话和轮次,界面支持时打开诊断详情查看错误、请求标识和运行时日志。需要提交截图或诊断包时,检查其中的聊天内容、文件名、身份及凭据信息。参见反馈说明和轮次诊断。