最后更新：2026 年 3 月
快速入门
本指南将带你在约 5 分钟内从全新机器到运行一个受管控智能体的 Claw-Stack 实例。
前置条件
| 需求 | 版本 / 说明 |
|---|---|
| OpenClaw | 最新稳定版。在 Claw-Stack 之前必须已安装并运行。 |
| Python | 3.11 或更高版本 |
| Node.js | 18 或更高版本（用于 Web 控制台，可选） |
| Docker | 可选——沙箱智能体执行所需 |
| 操作系统 | macOS 13+ 或 Linux（推荐 Ubuntu 22.04+） |
步骤一 — 安装 OpenClaw
如果你已有运行中的 OpenClaw，跳到步骤二。OpenClaw 是一个 Node.js 应用，通过 npm 全局安装。
# 通过 npm 全局安装 OpenClaw
npm install -g openclaw
# 验证安装
openclaw --version
# 启动 OpenClaw 网关
openclaw gateway start
继续之前请设置 ANTHROPIC_API_KEY 环境变量（或你使用的模型提供商的密钥）。详见 OpenClaw 官方文档。
步骤二 — 配置 Claw-Stack 模块
Claw-Stack 模块通过 OpenClaw 的工作区文件进行配置。核心配置位于智能体的工作区目录中。
# 进入 OpenClaw 工作区 cd ~/.openclaw/workspace # Claw-Stack 目前处于内测阶段 # 如需早期访问请联系：[email protected]
配置完成后，OpenClaw 会在每次会话开始时自动加载你的 MEMORY.md、智能体身份和策略文件。
步骤三 — 定义智能体策略
打开 policies/my-agent.yaml 并查看默认策略。根据智能体需要的工具编辑此文件。deny 列表是安全网——宁可拒绝智能体不需要的工具。
步骤四 — 启动运行时
# 启动 Claw-Stack 运行时守护进程
python runtime/main.py --daemon
# 验证运行状态
python runtime/status.py
# → 运行时：运行中
# → Socket：/tmp/claw.sock
# → 已加载智能体：1（my-agent）
步骤五 — 运行首个智能体
# 运行受管控的智能体会话
openclaw run --agent my-agent --claw-stack /tmp/claw.sock
# 智能体将以 MEMORY.md 加载启动
# 所有工具调用将经过策略关口
配置完成。
你的智能体现在在策略执行下运行，拥有持久记忆。audit/actions.jsonl 的审计日志正在捕获每个操作。
常见问题
使用 Claw-Stack 需要 OpenClaw 吗？
是的。Claw-Stack 是包装 OpenClaw 的运行时层——它不是独立的智能体执行器。OpenClaw 必须在 Claw-Stack 运行之前安装并运行。
Web 控制台在哪里？
可选的 Web 控制台在使用 python dashboard/serve.py 启动时运行在 localhost:7342。它显示实时审计日志、智能体状态、记忆状态和待审批队列。
可以同时运行多个智能体吗？
可以。每个智能体都有自己的策略文件和独立的策略关口实例。Claw-Stack 运行时支持无限数量的并发智能体，受系统资源限制。
Authors: Qiushi Wu & Orange 🍊