快速入门
从零基础到与代理对话的最短路径。
安装
选择一个：
Linux / macOS（单行命令）：
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash
Homebrew（macOS、Linux）：
brew install zeroclaw
Windows：
从最新版本中运行 setup.bat，或查看 设置 → Windows。
来源：
cargo install --locked --path . # 在克隆内部
onboard
zeroclaw onboard
zeroclaw onboard walks through configured sections (model providers, risk profiles, channels, agents, …) and prompts for each. Minimum inputs:
- 一个 LLM 提供商（Anthropic、OpenAI、Ollama、OpenRouter 等）及其 API 密钥或端点
- 至少需要一个频道——默认的
cli频道即可；如果您希望从 Discord、Telegram、Slack 等平台进行聊天，可以添加相应的频道。
其他所有内容都使用安全默认值。总耗时：约 2 分钟。
与它交谈
zeroclaw agent -a <alias>
<alias> matches your [agents.<alias>] config entry — required, no default. This drops you into an interactive session using the cli channel. Pass -m "one-shot message" for a single non-interactive turn.
对于始终运行的部署，注册服务：
zeroclaw service install
zeroclaw service start
然后，通过聊天平台频道从 Discord、Telegram 或你配置的任何地方与代理进行通信。
If onboarding’s questions annoy you
Run non-interactively with --quick:
zeroclaw onboard --quick --model-provider ollama --model qwen3.6:35b-a3b
或者直接使用 YOLO 模式——一个禁用审批和安全检查的配置预设。仅适用于开发环境和家庭实验室。
下一个
- Multi-model setup — multi-agent dispatch, hint-based routes
- 设置 → 服务管理 — 作为守护进程运行
- 频道 → 概述 — 连接聊天平台
- 安全 → 自主级别 — 代理被允许执行的操作