基于本地 Mac 从 0 到 1 部署 OpenClaw2026年开年最火的个人 AI 智能体工具GitHub 星标 21.5万日增星标 3800一款能通过聊天软件发指令、自动帮你整理文件、处理邮件、运行脚本、同步日程的 AI 助手。目录一、OpenClaw 是什么二、系统要求三、环境准备四、部署方式五、配置大模型 API六、连接聊天软件可选七、故障排查八、总结一、OpenClaw 是什么OpenClaw 是一款开源的个人 AI 智能体工具它能够 通过聊天软件微信、钉钉、飞书等发指令 自动帮你整理文件 处理邮件 运行脚本 同步日程不同于传统只能提供建议的 AI 工具OpenClaw 可以真正执行任务成为你的数字化个人助理。二、系统要求配置项最低要求推荐配置操作系统macOS 12macOS 14内存2GB4GB存储空间5GB10GB网络能访问 GitHub 和 npm稳定的国际网络连接三、环境准备3.1 安装 Homebrew如果还没有打开终端执行/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)3.2 安装 Node.js必须 ≥22 版本⚠️易错点Node.js 版本过低是 90% 安装失败的根源推荐方式使用 nvm 管理 Node 版本# 安装 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bash# 使配置生效source~/.zshrc# 安装 Node.js 22nvminstall22nvm use22# 设置为默认版本nvmaliasdefault22验证安装node-v# 应显示 v22.x.x 或更高版本npm-v# 应显示 10.x.x 或更高版本3.3 安装 pnpm推荐npminstall-gpnpm3.4 安装 Gitbrewinstallgit四、部署方式OpenClaw 提供三种部署方式根据你的需求选择方式一一键脚本安装推荐新手 ⭐⭐⭐⭐⭐最简单、最推荐的安装方式# 执行安装脚本curl-fsSLhttps://openclaw.ai/install.sh|bash验证安装openclaw--version# 如果显示版本号如 openclaw v2.1.0说明安装成功初始化配置# 启动配置向导openclaw init按照提示完成选择模型提供方OpenAI、Gemini、Claude、国内大模型等输入 API Key选择连接渠道微信、钉钉、飞书等可选设置数据存储路径建议使用默认启动服务# 启动服务openclaw start# 或者以后台模式运行openclaw start--daemon方式二Docker 部署推荐进阶用户 ⭐⭐⭐⭐Docker 部署的优势是环境隔离、便于迁移。4.2.1 安装 Docker Desktopbrewinstall--caskdocker安装完成后启动 Docker Desktop 应用。4.2.2 创建项目目录mkdir-p~/openclawcd~/openclaw4.2.3 创建 docker-compose.yml 文件version:3.8services:openclaw:image:openclaw/openclaw:latestcontainer_name:openclawports:-3000:3000volumes:-./data:/app/data-./config:/app/configenvironment:-NODE_ENVproduction-OPENAI_API_KEY${OPENAI_API_KEY}-MODEL_PROVIDERopenai-MODEL_NAMEgpt-4restart:unless-stopped4.2.4 创建环境变量文件# 创建 .env 文件echoOPENAI_API_KEYyour-api-key-here.env4.2.5 启动容器# 拉取镜像并启动docker-composeup-d# 查看日志docker-composelogs-f# 查看运行状态dockerps方式三手动安装适合开发者 ⭐⭐⭐适合需要深度定制或二次开发的用户。4.3.1 克隆仓库# 克隆官方仓库gitclone https://github.com/openclaw/openclaw.gitcdopenclaw如果克隆失败可以使用镜像加速gitclone https://ghproxy.com/https://github.com/openclaw/openclaw.git4.3.2 安装依赖# 安装项目依赖pnpminstall# 构建前端pnpmui:build# 构建项目pnpmbuild⚠️如果安装速度慢可以使用国内镜像npmconfigsetregistry https://registry.npmmirror.com4.3.3 配置环境变量# 复制配置模板cp.env.example .env# 编辑配置文件vim.env最小配置示例# 模型配置 MODEL_PROVIDERopenai OPENAI_API_KEYsk-your-api-key-here MODEL_NAMEgpt-4 # 服务配置 PORT3000 HOST0.0.0.0 # 数据存储 DATA_DIR./data4.3.4 初始化并启动# 执行初始化配置openclaw onboard --install-daemon# 启动服务nodeopenclaw.mjs gateway--port3000--verbose五、配置大模型 API无论哪种部署方式都需要配置大模型 API 才能正常使用。5.1 获取 API KeyOpenAI访问 https://platform.openai.com注册/登录账号进入 API Keys 页面创建新 Key国内大模型以通义千问为例访问 https://dashscope.aliyun.com注册阿里云账号创建 API Key5.2 配置模型通过命令行配置# 设置模型提供方openclaw configsetmodel.provider openai# 设置 API Keyopenclaw configsetmodel.openai.apiKey sk-your-key-here# 设置模型名称openclaw configsetmodel.name gpt-4# 验证配置openclaw config get model通过 Web 界面配置访问 http://localhost:3000点击设置 → “模型配置”填写 API 信息并保存⚠️注意API Key 不要泄露建议保存在环境变量中exportOPENAI_API_KEYyour-api-key-here六、连接聊天软件可选OpenClaw 支持接入多种聊天软件实现通过聊天界面控制 AI。6.1 连接微信# 安装微信适配器openclaw plugininstallwechat# 配置微信openclaw configsetchannels.wechat.enabledtrue# 重启服务openclaw restart6.2 连接钉钉# 安装钉钉适配器openclaw plugininstalldingtalk# 在钉钉开放平台创建机器人获取 Webhook 地址和 Secretopenclaw configsetchannels.dingtalk.enabledtrueopenclaw configsetchannels.dingtalk.webhookUrl https://oapi.dingtalk.com/robot/send?access_tokenxxx openclaw configsetchannels.dingtalk.secret your-secret6.3 连接飞书# 安装飞书适配器openclaw plugininstallfeishu# 配置飞书openclaw configsetchannels.feishu.enabledtrue七、故障排查7.1 检查服务状态# 查看 OpenClaw 状态openclaw status# 查看网关状态openclaw gateway probe# 查看实时日志openclaw logs--follow7.2 常见问题问题 1端口被占用# 错误信息Port 3000 is already in use# 解决更换端口openclaw start--port3001# 或者查找并关闭占用端口的进程lsof-i:3000kill-9进程ID问题 2权限不足# 错误信息EACCES: permission denied# 解决修改目录权限sudochown-R$(whoami)~/.openclaw问题 3模型连接失败# 检查网络连接curlhttps://api.openai.com/v1/models\-HAuthorization: Bearer your-api-key# 如果超时检查网络或代理设置问题 4Docker 容器无法启动# 查看详细错误docker-composelogs# 常见问题镜像拉取失败# 解决配置 Docker 镜像加速编辑 Docker 配置文件{registry-mirrors:[https://docker.mirrors.ustc.edu.cn,https://hub-mirror.c.163.com]}八、总结部署方式对比部署方式难度适用场景推荐度一键脚本⭐个人使用、快速体验⭐⭐⭐⭐⭐Docker⭐⭐服务器部署、团队协作⭐⭐⭐⭐手动安装⭐⭐⭐二次开发、深度定制⭐⭐⭐关键成功要素✅Node.js 版本必须 ≥22✅路径不要有中文✅API Key 要保密且有余额✅遇到问题先看日志常用命令速查# 启动服务openclaw start# 停止服务openclaw stop# 重启服务openclaw restart# 查看状态openclaw status# 查看日志openclaw logs--follow# 升级curl-fsSLhttps://openclaw.ai/install.sh|bash# 卸载openclaw uninstall参考资源OpenClaw 官方网站OpenClaw GitHub 仓库OpenAI API 文档阿里云通义千问恭喜现在你已经拥有了自己的 AI 智能体。开始探索 OpenClaw 的强大功能吧