OpenClaw（龙虾）小白友好型部署手册（Windows+Linux）

#
OpenClaw
部署完整指南 一、环境准备与系统要求 系统兼容性对比 | 操作系统 | 最低要求 | 推荐配置 |
部署方式 | |———|———|———-|———| | macOS | Node.js 22.x, Xcode命令行工具 | 16GB内存，M1及以上芯片 | 宿主机全量安装 | |
Windows | Node.js 22.x | 8GB内存，
Windows 10/11 | systemd服务
部署 | |
Linux | Node.js 22.x | 4GB内存，Ubuntu 20.04
+ | 云服务器或本地
部署 | 前置依赖安装 macOS 环境准备： bash # 1. 安装Xcode命令行工具 xcode-select –install # 2. 使用Homebrew安装nvm和Node.js brew install nvm # 3. 配置nvm环境变量 echo ‘export NVM_DIR=”$HOME/.nvm”‘ >> ~/.zshrc echo ‘[ -s “$NVM_DIR/nvm.sh” ] && . “$NVM_DIR/nvm.sh”‘ >> ~/.zshrc source ~/.zshrc # 4. 安装并使用Node.js 22 nvm install 22 && nvm use 22 二、
OpenClaw 核心
部署流程 安装与启动网关服务 bash # 安装
OpenClaw核心包 npm install -g @
openclaw/cli # 初始化项目
openclaw init my-assistant # 启动网关服务（Mac特有选项）
openclaw gateway –install-daemon 重要说明：`–install-daemon` 参数会在 Mac 上安装一个 LaunchAgent，让网关开机自启动。
Windows 系统装的是 systemd 服务，Mac 装的是 LaunchAgent，位于 `~/Library/LaunchAgents/ai.
openclaw.gateway.plist` [ref_1]。 大模
型接入配置
OpenClaw 需要接入大模
型才能工作，这里以阿里云 DashScope（通义千问）为例： json // 编辑配置文件 ~/.
openclaw/
openclaw.json { “apiKey”: “sk-你的API_KEY”, “api”: “openai-completions”, “workspace”: “~/.
openclaw/workspace”, “model”: “qwen-turbo” } 关键提示：`apiKey` 建议直接写在 json 配置文件中，而不是使用环境变量。因为 Mac 的 LaunchAgent 无法读取在 Terminal 中使用 `export` 设置的变量——这是
部署过程中常见的第一个坑 [ref_1]。 三、
部署方案选择 方案对比表格 |
部署方式 | 适用场景 | 优势 | 配置要求 | |———|———|——|———| | 阿里云轻量服务器 | 生产环境、团队协作 | 稳定性高、可远程访问 | 2核4G起步 | | 本地
部署
(macOS
) | 个人开发测试 | 响应速度快、数据本地化 | 8GB内存 | | 本地
部署
(
Windows
) |
Windows用户 | 界面
友好、易管理 | 8GB内存 | 截至2026年3月，
OpenClaw已更新至v2026.1.29版本，优化了多平台适配性与Skills兼容性，支持Node.js 22.x及以上版本，同时完善了阿里云百炼API的对接逻辑，大幅降低了新手
部署门槛，最快可实现5分钟快速启动控制台体验核心功能 [ref_2]。 四、完整
部署验证流程 服务状态检查 bash # 检查网关服务状态
openclaw gateway status # 验证模
型连接
openclaw test-connection # 启动控制台界面
openclaw onboard `
openclaw onboard` 命令会启动后续配置流程，包括飞书/钉钉机器人集成、API-Keyopenclaw 龙虾验证等步骤，这些配置在云
部署和本地
部署中保持一致 [ref_3]。 五、实用场景演示
OpenClaw 使用范例表格 | 场景类
型 | 指令示例 | 预期效果 | |———|———|———-| | 多浏览器自动化 | “新建两个RoxLium窗口，一个搜京东华为Mate80，一个进B站给AI博士hia点赞” | 自动开双窗口执行，生成两份Word报告 | | 智能文档处理 | “分析最近10篇技术文档，提取关键知识点” | 自动生成知识图谱和总结报告 | | 数据采集分析 | “监控竞品价格变化，每天生成价格趋势图” | 定时执行并邮件发送分析结果 | 这些范例展示了
OpenClaw在实际工作场景中的强大应用能力，通过简单的自然语言指令即可触发复杂的自动化流程 [ref_3]。 六、故障排查与优化 常见问题解决 1. API密钥配置失败：确保apiKey直接写在配置文件中，而非环境变量 2. 服务启动失败：检查Node.js版本是否为22.x，端口是否被占用 3. 模
型连接超时：验证网络连接和API端点配置 性能优化建议 – 为生产环境
部署配置至少4GB可用内存 – 定期清理工作空间缓存文件 – 使用SSD存储以提高响应速度 通过遵循本指南，用户可以在不同平台上顺利完成
OpenClaw的
部署，并快速体验到AI助手的强大功能。
部署过程注重实用性和可操作性，确保即使是新手用户也能在较短时间内完成配置并开始使用。