OpenClaw-Mac安装完整指南

#
OpenClaw
安装使用
完整教程 1. 环境准备与
安装方式选择
OpenClaw 支持多种部署方式，用户可根据自身技术背景和需求选择最适合的方案： | 部署方式 | 适用平台 | 技术门槛 | 核心优势 | 推荐场景 | |
–
–
–
–
–
–
–
–
–|
–
–
–
–
–
–
–
–
–|
–
–
–
–
–
–
–
–
–|
–
–
–
–
–
–
–
–
–|
–
–
–
–
–
–
–
–
–| | 腾讯云轻量服务器 | Linux | 中等 | 7×365小时稳定运行 | 企业生产环境 [ref_1] | | WSL2 (Windows) | Windows 10/11 | 中等 | 本地开发测试 | Windows 开发者 [ref_2] | | 原生 Windows | Windows | 低 | 简单快捷 | 个人快速体验 [ref_3] | | Docker (
macOS) |
macOS | 中等 | 环境隔离 |
Mac 用户开发测试 [ref_6] | | 本地模型部署 | 多平台 | 高 | 数据隐私保护 | 对数据安全要求高的场景 [ref_5] | 1.1 基础环境要求 所有
安装方式均需要以下基础环境： “`bash # 检查 Node.js 版本（要求 16+） node
–
–version # 检查 npm 版本 npm
–
–version “` 如果未
安装 Node.js，可从官网下载
安装包或使用包管理器
安装 [ref_4]。 2. Windows 系统
安装教程 2.1 原生 Windows
安装（推荐新手） 步骤 1：以管理员身份运行 PowerShell “`powershell # 打开管理员 PowerShell，执行官方
安装命令 irm https://
openclaw.github.io/install.ps1 | iex “` 步骤 2：选择 AI 服务提供商
安装过程中会提示选择模型提供商：
– Minimax（推荐国内用户）
– Anthropic
– 硅基流动（支持国产模型）[ref_3] 步骤 3：配置 API 密钥 “`json // 配置文件位置：~/.
openclaw/
openclaw.json { “api_keys”: { “minimax”: “您的_API_Key”, “silicon_flow”: “您的_硅基流动_Key” } } “` 步骤 4：启动服务 “`powershell # 启动
OpenClaw 服务
openclaw start # 访问 Web 界面 start http://127.0.0.1:18789 “` 2.2 WSL2 Ubuntu
安装（推荐开发者） 步骤 1：启用 WSL2 和 systemd “`bash # 在 Windows 终端中启用 WSL2 wsl
–
–install
–d Ubuntu # 在 WSL 中启用 systemd sudo nano /etc/wsl.conf # 添加以下内容： [boot] systemd=true “` 步骤 2：
安装
OpenClaw “`bash # 克隆源码并构建 git clone https://github.com/
openclaw/
openclaw.git cd
openclaw npm install npm run build #
安装 Gateway 服务 sudo npm run gateway:install “` 步骤 3：配置局域网访问 “`bash # Windows 主机设置端口转发 netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=127.0.0.1 # 开放防火墙 netsh advfirewall firewall add rule name=”
OpenClaw” dir=in action=allow protocol=TCP localport=18789 “` 3.
macOS Docker 部署 3.1 环境准备 “`bash #
安装 Docker Desktop brew install
–
–cask docker # 启动 Docker 服务 open
–a Docker “` 3.2 Docker 部署
OpenClaw “`bash # 拉取最新镜像 docker pull
openclaw/
openclaw:latest # 运行容器 docker run
–d
–
–name
openclaw
–p 18789:18789
–v
openclaw_data:/app/data
openclaw/
openclaw:latest # 查看运行状态 docker logs
–f
openclaw “` 3.3 初始配置 1. 访问 `http://localhost:18789` 进入 Web 控制台 2. 完成设备配对流程 3. 配置 AI 模型提供商（硅基流动、Minimax 等）[ref_6] 4. 设置默认对话模型 4. 云服务器部署（生产环境） 4.1 腾讯云轻量服务器部署 服务器配置建议：
– 系统：Ubuntu 20.04 LTS
– 配置：2核4G（最低）
– 带宽：5Mbps “`bash # 一键
安装脚本 curl
–fsSL https://
openclaw.github.io/install.sh | bash # 或者分步
安装 git clone https://github.com/
openclaw/
openclaw.git cd
openclaw ./scripts/install.sh “` 4.2
飞书
机器人集成配置 “`yaml #
飞书应用配置 app_id: cli_xxxxxxxx app_secret: xxxxxxxx verification_token: xxxxxxxx encrypt_key: xxxxxxxx # Webhook 配置 webhook_url: https://your
–domain.com/webhook “` 配置步骤： 1. 在
飞书开放平台创建企业自建应用 2. 获取凭据信息并填入配置文件 3. 配置事件回调 URL 4. 发布应用并添加权限 [ref_1] 5openclaw skills 教程. 模型配置详解 5.1 云模型 API 配置 硅基流动 API 配置： “`json { “model_providers”: { “silicon_flow”: { “api_key”: “sk
–xxxxxxxx”, “base_url”: “https://api.siliconflow.cn/v1”, “models”: [“GLM”, “DeepSeek”, “Kimi”] } } } “` Minimax 配置： “`json { “minimax”: { “api_key”: “您的_Minimax_Key”, “group_id”: “您的_群组_ID” } } “` 5.2 本地模型部署（Ollama） “`bash #
安装 Ollama curl
–fsSL https://ollama.ai/install.sh | sh # 下载模型 ollama pull qwen2:7b ollama pull llama3.1:8b # 配置
OpenClaw 使用本地模型 “` “`json { “local_models”: { “provider”: “ollama”, “base_url”: “http://localhost:11434”, “default_model”: “qwen2:7b” } } “` 6. 高级功能配置 6.1 Skill 技能配置 “`yaml skills:
– name: “weather_query” description: “天气查询技能” enabled: true parameters: city: “required”
– name: “code_generator” description: “代码生成器” enabled: true language_support: [“python”, “javascript”, “java”] “` 6.2 网关服务配置 “`javascript // gateway.config.js module.exports = { port: 18789, host: ‘0.0.0.0’, cors: { origin: [‘http://localhost:3000’, ‘https://your
–app.com’], credentials: true }, rate_limit: { windowMs: 15 * 60 * 1000, // 15分钟 max: 100 // 限制每个IP最多100次请求 } }; “` 7. 故障排查与维护 7.1 常见问题解决 服务启动失败： “`bash # 检查端口占用 netstat
–tulpn | grep 18789 # 查看日志 tail
–f /var/log/
openclaw/error.log # 重启服务 systemctl restart
openclaw “` API 连接问题： “`bash # 测试 API 连通性 curl
–X POST https://api.siliconflow.cn/v1/chat/completions
–H “Authorization: Bearer your
–api
–key”
–H “Content
–Type: application/json”
–d ‘{“model”: “GLM”, “messages”: [{“role”: “user”, “content”: “Hello”}]}’ “` 7.2 性能优化建议 1. 资源监控：使用 `htop` 监控系统资源使用情况 2. 日志轮转：配置 logrotate 防止日志文件过大 3. 备份策略：定期备份配置文件和数据 4. 安全更新：及时更新
OpenClaw 版本和依赖包 8. 实际应用场景 8.1 企业客服
机器人 通过
飞书集成实现 24/7 智能客服，支持：
– 常见问题自动回复
– 工单自动创建
– 多轮对话上下文维护 8.2 开发助手 为开发团队提供：
– 代码生成和审查
– 技术文档查询
– API 接口测试 8.3 个人学习伴侣 支持：
– 多学科知识问答
– 学习计划制定
– 内容总结和翻译 通过以上
完整的
安装和使用
指南，用户可以根据自身需求选择合适的部署方案，快速搭建属于自己的 AI 助手平台。每种方案都经过实际验证，确保稳定性和可用性 [ref_1][ref_2][ref_3][ref_4][ref_5][ref_6]。