跳到主要内容

安装与快速上手

安装​

使用方式操作
桌面版从项目的官方发布页下载与操作系统及芯片架构匹配的桌面安装包(以该版本附件为准),安装后打开 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。旧版运行环境迁移见配置指南。

首次打开时可查看新手引导,也可以在设置中重放。

首次打开时可查看新手引导,也可以在设置中重放。

接入能用的模型​

  1. 打开 设置 → 模型服务。
  2. 如果使用 OpenCSG,按提示授权登录。如果使用第三方模型,在 接入模型服务 中选择厂商、服务类型及区域,填写对应 Key 并点 连接。
  3. 看到可用模型后,在默认模型配置中为新建智能体选择对话模型。若 Manager 已存在,打开它的设置核对其当前模型。
  4. 到 设置 → 运行环境 查看本机运行时。Codex 由安装包提供。使用 DSH 时,根据页面提示完成安装或重新检测。
  5. 如果你希望本次练习仅分析内容,在支持会话设置的任务中选只读模式。工作目录使用一个单独的练习目录。

模型连接与权限配置见模型与资源。当前构建中,本地 Codex 与 DSH 默认可访问宿主机文件系统。执行模式会影响可用的工具和写入权限。

教程一 完成第一个任务​

  1. 点击 新建任务,选择 Manager 或已配置模型的本地智能体。

  2. 输入以下示例,再点发送。

    帮我做一份发布检查清单。场景是一个小团队发布产品首页。请按发布前、发布时、发布后三个阶段列出事项,每项写明负责人和验收方式。先只在聊天中输出,不修改文件。

  3. 观察会话中的执行状态。若出现提问或确认,先读清请求,再选择答案或批准范围。

  4. 收到结果后,追问「把发布前检查项改成表格,再补一列回滚条件」。确认同一会话能够继续前一个任务。

  5. 验收结果应包含三个阶段、负责人和验收方式,且第二次回复基于原内容继续完善。

想让智能体和你一起处理文件,可继续做文件交付教程。需要多角色分工时,进入协作教程。

退出和重开​

前台 CLI 服务用 Ctrl+C 停止。后台服务通过 csgclaw serve --daemon 启动、csgclaw stop 停止。关闭浏览器标签页不会停止独立运行的本地服务。定时任务与已发布到社区的本地智能体需要服务保持运行。