openclaw本地部署必须使用原生linux（ubuntu 22.04/24.04）或macos，依赖docker 24.0.0+且需root权限常驻；内存≥4gb、磁盘≥12gb；用户须加入docker组并重启终端；需确保github、docker镜像源及llm api域名可达，并提前配置有效api key。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地部署需要提前准备好基础运行环境，否则容器启动会直接失败或Web界面无法加载。它依赖Docker作为核心运行时，不支持纯Python直启，也不兼容Windows Subsystem for Linux（WSL）默认配置——必须使用原生Linux系统或macOS，且Docker守护进程需以root权限常驻运行。
操作系统与硬件要求
确认当前系统为 Ubuntu 22.04 或 24.04（官方唯一验证通过的发行版），CentOS/RHEL 系统暂未提供适配镜像，强行运行会导致 sandbox 初始化失败。内存不得低于 【4GB】，低于该值时容器会因 OOM 被系统 kill，且无任何错误提示，仅表现为 localhost:3000 页面空白。
磁盘空间需预留至少 12GB：其中 5GB 用于 OpenClaw 主镜像，4GB 为 runtime 容器缓存，剩余 3GB 是 .openhands-state 挂载卷的安全余量。
Docker 环境检查
执行 docker --version，输出必须为 24.0.0 或更高版本。旧版本（如 20.10.x）在挂载 /var/run/docker.sock 时会出现 permission denied，且无法绕过。
运行 docker ps 验证守护进程活跃状态。若提示 Cannot connect to the Docker daemon，说明服务未启动，需立即执行 sudo systemctl start docker。
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
确保当前用户已加入 docker 组：groups 命令输出中必须含 docker。未加入则执行 sudo usermod -aG docker $USER，【必须重新登录终端或重启系统才生效】，否则后续所有 docker 命令均需加 sudo，导致挂载路径失效。
网络与凭证准备
部署前必须能稳定访问以下地址：github.com（拉取 config 模板）、docker.all-hands.dev（拉取 runtime 和 openhands 镜像）、以及你选定的 LLM 提供商 API 域名（如 api.openai.com 或 dashscope.aliyuncs.com）。
准备好至少一个可用的 LLM API Key。OpenClaw 启动后首次访问 Web 界面时，会强制弹出配置窗口，无 Key 无法跳过，也无法进入主工作区。
注意：国内用户若选用阿里云百炼或火山引擎，需提前在控制台开通对应模型服务并获取 AccessKey ID/Secret，部分服务商（如百度千帆）要求绑定手机号后才开放 API 权限，该步骤不可跳过。
