OpenClaw安装
部署全平台指南
OpenClaw作为开源AI智能体平台,支持多种操作系统环境
部署。以下是各平台的详细安装方案对比及具体操作流程: |
部署平台 | 核心依赖 | 推荐安装方式 | 特色功能 | 适用场景 | |———|———|————|———|———| | Linux/CentOS/Ubuntu | Node.js ≥18 + npm | CLI一键脚本 + Web UI |
钉钉集成、Nginx反向代理 | 企业生产环境 [ref_1] | | Windows 10/11 | Node.js ≥22 + PowerShell | npm全局安装 |
飞书机器人、DeepSeek API | 个人开发环境 [ref_2] | | macOS | Node.js ≥18 + Homebrew | 官方脚本/镜像安装 | 多模型配置、内网穿透 | 移动办公场景 [ref_3] | | WSL2
(Windows
) | Ubuntu + Node.js 22+ | npm安装 + 守护进程 | LM-Studio本地模型 | 混合开发环境 [ref_4] | | 多平台通用 | Docker Engine | Docker Compose | 环境隔离、快速
部署 | 跨平台运维 [ref_
5] | 一、环境准备阶段 所有平台
部署前均需确保Node.js环境就绪: “`bash # 验证Node.js版本(所有平台通用) node –version # 需 ≥18(推荐22+) npm –version # 需 ≥9.x # 如版本不符,使用Node版本管理器升
级 # Linux/macOS curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.openclaw skills 教程0/install.sh | bash nvm install 22 nvm use 22 # Windows
(PowerShell管理员权限
) Set-ExecutionPolicy RemoteSigned -Scope CurrentUser iwr -useb https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash nvm install 22 “` 二、各平台具体
部署流程 1. Linux系统
部署(企业
级推荐) “`bash # 1. 使用官方安装脚本 curl -fsSL https://raw.githubusercontent.com/open-claw/claw/main/install.sh | sh # 2. 或通过npm安装 npm install -g @
openclaw/claw # 3. 初始化配置(交互式向导) claw init # 4. 启动服务(支持后台运行) claw start –daemon #
5. 配置Nginx反向代理(生产环境) sudo vim /etc/nginx/conf.d/
openclaw.conf “` Nginx配置示例: “`nginx server } “` 2. Windows系统原生
部署 “`powershell # 1. 以管理员身份打开PowerShell # 设置执行策略(首次运行) Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # 2. 全局安装
OpenClaw中文版 npm install -g
openclaw-cn # 3. 配置DeepSeek API密钥 $env:CLAW_DEEPSEEK_API_KEY = “your-api-key-here” # 4. 启动网关服务 claw start #
5. 访问Web界面 Start-Process “http://localhost:18789” “` 3. macOS系统
部署 “`bash # 方案一:官方安装脚本 /bin/bash -c “$
(curl -fsSL https://raw.githubusercontent.com/open-claw/claw/main/install.sh
)” # 方案二:Homebrew安装(推荐) brew tap open-claw/claw brew install claw # 自定义模型配置(编辑JSON
5配置文件) vim ~/.claw/config.json
5 “` 模型配置示例: “`json
5 { “llm”: { “provider”: “dashscope”, “apiKey”: “${DASHSCOPE_API_KEY}”, “model”: “qwen-turbo” }, “server”: { “port”: 18789, “host”: “0.0.0.0” } } “` 4. WSL2环境
部署(Windows最佳实践) “`bash # 1. 启用WSL2并安装Ubuntu wsl –install -d Ubuntu # 2. 在Ubuntu子系统中操作 sudo apt update && sudo apt upgrade -y # 3. 安装Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash – sudo apt-get install -y nodejs # 4. 安装
OpenClaw npm install -g @
openclaw/claw #
5. 配置LM-Studio本地模型 vim ~/.claw/moltbot.json “` LM-Studio集成配置: “`json { “endpoint”: “http://127.0.0.1:1234/v1”, “model”: “local-model”, “apiKey”: “lm-studio” } “`
5. Docker跨平台
部署 “`yaml # docker-compose.yml version: ‘3.8’ services:
openclaw: image:
openclaw/claw:latest ports: – “18789:18789” volumes: – ./data:/app/data – ./config:/app/config environment: – CLAW_API_KEY=your-secret-key – CLAW_MODEL_PROVIDER=openai restart: unless-stopped “` 启动命令: “`bash # 一键
部署 docker-compose up -d # 查看日志 docker-compose logs -f
openclaw “` 三、核心配置与验证 服务验证与健康检查: “`bash # 检查服务状态 curl http://localhost:18789/health # 预期响应 {“status”:”healthy”,”version”:”2.1.0″} # 或通过Web界面验证 # 访问 http://localhost:18789 应看到管理界面 “` 安全配置要点: “`bash # 1. Token认证配置 export CLAW_ACCESS_TOKEN=”your-secure-token” # 2. HTTPS启用(生产环境) export CLAW_SSL_CERT=”/path/to/cert.pem” export CLAW_SSL_KEY=”/path/to/key.pem” # 3. CORS配置(前端集成) export CLAW_CORS_ORIGIN=”https://your-app.com” “` 四、企业
级扩展集成
钉钉机器人集成示例: “`bash # 安装
钉钉渠道插件 npm install -g
openclaw-channel-dingtalk # 配置
钉钉应用凭证 export DINGTALK_APP_KEY=”your-app-key” export DINGTALK_APP_SECRET=”your-app-secret” # 重启服务应用配置 claw restart “`
飞书集成配置: “`javascript // ~/.claw/channels/feishu.json “` 五、故障排查与优化 常见问题解决方案: 1. 端口冲突:修改默认端口 `claw start –port 3000` 2. 权限不足:Linux系统使用 `sudo` 或配置用户组权限 3. Node版本不兼容:通过nvm管理多版本Node.js 4. API密钥错误:验证环境变量名称和密钥有效性 性能优化建议: “`bash # 增加Node.js内存限制 export NODE_OPTIONS=”–max-old-space-size=4096″ # 使用PM2进程管理(生产环境) npm install -g pm2 pm2 start claw –name ”
openclaw” — –port 18789 pm2 save && pm2 startup “` 通过以上全平台
部署指南,用户可根据具体环境选择最适合的安装方案。企业用户推荐Linux+Docker方案保证稳定性,个人开发者可选择Windows或macOS原生安装获得最佳开发体验,WSL2方案则兼顾Windows便利性与Linux环境一致性 [ref_6]。所有方案均支持完整的AI智能体功能,包括多模型切换、技能扩展和第三方平台集成。
发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/253767.html原文链接:https://javaforall.net
