安装与快速上手
安装
| 使用方式 | 操作 |
|---|---|
| 桌面版 | 从项目的官方发布页下载与操作系统及芯片架构匹配的桌面安装包(以该版本附件为准),安装后打开 CSGClaw。 |
| macOS / Linux 命令行 | 使用下方安装脚本。当前脚本目标为 macOS arm64、Linux amd64 和 Linux arm64。macOS amd64 请查看发布页的预构建包。 |
| Windows 命令行 | 在 PowerShell 使用下方安装脚本。当前脚本目标为 Windows amd64。 |
| 从源码构建 | 在仓库根目录运行 make build。查看构建与打包了解工具链和桌面构建。 |
macOS / Linux
curl -fsSL https://csgclaw.opencsg.com/install.sh | bash
Windows PowerShell
curl.exe -fsSL https://csgclaw.opencsg.com/install.ps1 | powershell -ExecutionPolicy Bypass -Command -
终端输入 csgclaw --version 确认安装。若找不到命令,重新打开终端,确认安装目录已加入 PATH。
打开工作区
桌面版直接打开应用。CLI 用户执行以下命令,并在浏览器打开终端打印的地址。默认本地端口为 18080,以实际输出为准。
csgclaw serve
要随启动打开浏览器,使用 csgclaw serve --browser。首次启动会建立缺失的本地配置和初始工作区。当前本地 Codex 与 DeepSeek Harness(DSH)以宿主机进程运行,安装和本地执行无需 Docker。旧版运行环境迁移见配置指南。

首次打开时可查看新手引导,也可以在设置中重放。
接入能用的模型
- 打开 设置 → 模型服务。
- 如果使用 OpenCSG,按提示授权登录。如果使用第三方模型,在 接入模型服务 中选择厂商、服务类型及区域,填写对应 Key 并点 连接。
- 看到可用模型后,在默认模型配置中为新建智能体选择对话模型。若 Manager 已存在,打开它的设置核对其当前模型。
- 到 设置 → 运行环境 查看本机运行时。Codex 由安装包提供。使用 DSH 时,根据页面提示完成安装或重新检测。
- 如果你希望本次练习仅分析内容,在支持会话设置的任务中选只读模式。工作目录使用一个单独的练习目录。
模型连接与权限配置见模型与资源。当前构建中,本地 Codex 与 DSH 默认可访问宿主机文件系统。执行模式会影响可用的工具和写入权限。
教程一 完成第一个任务
-
点击 新建任务,选择 Manager 或已配置模型的本地智能体。
-
输入以 下示例,再点发送。
帮我做一份发布检查清单。场景是一个小团队发布产品首页。请按发布前、发布时、发布后三个阶段列出事项,每项写明负责人和验收方式。先只在聊天中输出,不修改文件。
-
观察会话中的执行状态。若出现提问或确认,先读清请求,再选择答案或批准范围。
-
收到结果后,追问「把发布前检查项改成表格,再补一列回滚条件」。确认同一会话能够继续前一个任务。
-
验收结果应包含三个阶段、负责人和验收方式,且第二次回复基于原内容继续完善。
想让智能体和你一起处理文件,可继续做文件交付教程。需要多角色分工时,进入协作教程。
退出和重开
前台 CLI 服务用 Ctrl+C 停止。后台服务通过 csgclaw serve --daemon 启动、csgclaw stop 停止。关闭浏览器标签页不会停止独立运行的本地服务。定时任务与已发布到社区的本地智能体需要服务保持运行。