核心功能与用法
本技能提供在 macOS 上从零开始搭建 Docker 化 OpenClaw 实例的完整方案，实现一键式容器化部署。核心价值在于完全隔离的运行环境——每个实例拥有独立的命名容器、持久化卷和专属端口，支持同一机器上多实例并行（如 openclaw-main/openclaw-demo/openclaw-work）。
典型部署流程：
1. 智能初始化：Python 脚本自动扫描现有实例，推荐空闲端口（默认从 19002 递增）和实例名称
2. 镜像拉取：从 GitHub Container Registry 获取官方镜像（⚠️ 注意：Docker Hub 不存在此镜像）
3. 认证配置：支持两种方式——Claude Max/Pro 订阅用户生成 setup token（claude setup-token），或直接注入 Anthropic API key
4. 容器启动：关键参数包括 -m 2048m 内存限制、--cap-drop=ALL 安全加固、命名卷持久化
5. 网关配置：必须切换 LAN 模式并设置 allowedOrigins，否则 Dashboard 无法访问
6. 设备配对：通过 devices approve 命令授权浏览器访问
7. 渠道集成：详细的 Discord bot 创建、权限配置和用户白名单设置流程
显著优点
- 多实例隔离：数据卷完全分离，适合个人/工作/演示场景切换
- 自动重启与资源限制：
unless-stopped策略配合内存/CPU 硬限制 - 详尽的错误防范：文档中标注 15+ 个常见陷阱（OOM 崩溃、端口冲突、OAuth 回调失败等）
- 安全加固：默认丢弃所有 capabilities，仅保留必要网络绑定权限
潜在局限与风险
- 平台锁定：明确仅支持 macOS (Darwin)，Linux/Windows 需自行适配
- 浏览器依赖：初始配对和 OAuth 认证必须在 Mac 本地或通过 SSH 端口转发完成，无法纯远程部署
- API 成本陷阱：setup token 与 API key 机制不同，后者按 token 计费，配置错误可能导致意外账单
- 配置覆盖风险：Discord
guilds配置需完整替换，增量添加用户时需包含全部现有 ID - 内存刚性要求：512MB/1024MB 内存必导致崩溃循环，2048MB 为硬性下限
适合人群
- 需要在同一设备隔离多个 OpenClaw 环境的进阶用户
- 追求一键部署、规避手动配置踩坑的技术用户
- 希望将 AI 助手集成到 Discord 工作流的团队管理员
- 对容器安全和资源管控有明确需求的运维人员
常规风险提醒
- 未正确设置
allowedOrigins会导致网关启动失败 - 容器内无全局
openclaw命令，必须使用node /app/openclaw.mjs前缀 - API key 在 shell 历史中的残留风险（建议交互式粘贴）
- 数据卷误删除将导致配置和认证信息永久丢失