跳到主要内容

设置、维护与排障

在侧栏底部打开 账号与设置 → 设置。同一菜单可查看 个人资料(本机),也可快速切换浅色、深色或跟随系统,以及简体中文和 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 反馈入口。

复现问题后记下版本、操作系统、发生时间、页面、复现步骤、预期和实际结果。对任务问题记下会话和轮次,界面支持时打开诊断详情查看错误、请求标识和运行时日志。需要提交截图或诊断包时,检查其中的聊天内容、文件名、身份及凭据信息。参见反馈说明和轮次诊断。