跳到主要内容

CSGClaw：快速入门

← 返回 CSGClaw 概览

快速开始​

csgclaw onboard
csgclaw serve

执行后 CLI 会打印访问地址（例如 http://127.0.0.1:18080/），在浏览器中打开即可进入 IM 工作区。

首次启动时，CSGClaw 会从 CSGHub Lite、Codex 或 Claude Code 自动检测 Manager 的 agent profile。若检测失败，Web UI 仍然可用，并会打开 Manager profile 设置面板，供你选择 provider 和模型。

启动成功后，终端一般会提示 CSGClaw IM 的地址并在浏览器中打开（具体文案以你本机输出为准）：

执行 csgclaw serve 后，终端中的 IM 访问地址提示（示例）

可选：配合 CSGHub Lite 本地模型​

若你习惯先拉起本地兼容 OpenAI 的推理服务，再让 csgclaw onboard 对接，可按下面顺序操作。

  1. 启动 CSGHub Lite（示例）：
csghub-lite run Qwen/Qwen3-0.6B-GGUF
  1. 初始化配置（交互式；可对接 http://127.0.0.1:11435/v1，并从 /v1/models 导入模型）：
csgclaw onboard
  1. 启动本地 HTTP 服务：
csgclaw serve
  1. 在终端输出的地址用浏览器打开，进入内置 IM 工作区。

运行服务（前台 / 后台）​

前台运行（占用当前终端）：

csgclaw serve

后台运行：

csgclaw serve --daemon
  • 日志默认：~/.csgclaw/server.log
  • PID 默认：~/.csgclaw/server.pid
  • 停止：csgclaw stop

非交互式或脚本化初始化可用 csgclaw onboard 的相关参数，见 CLI。

配置写入说明​

csgclaw onboard 会写入本地配置（默认 ~/.csgclaw/config.toml），包含 server、bootstrap、sandbox 和 channel 等。Agent 的模型与 provider profile 保存在 agent 状态中，通过 Web UI 管理。Sandbox provider、Worker 覆盖与 profile 说明见仓库 docs/config.zh.md；字段说明与示例见本站 API 与配置。

继续了解 界面操作 或 CLI。