Skill: huamu668/openclaw-deploy-guide (version 1.0.0)

--- name: openclaw-deploy description: OpenClaw/NEUXSBOT 全平台部署指南 - 支持 Mac、Windows、Linux 三平台一键安装。包含环境准备、安装配置、AI模型设置、消息平台对接、故障排除等完整流程。 metadata: version: "1.0" origin: "OpenClaw China + NEUXSBOT" --- # OpenClaw 全平台部署指南 OpenClaw（NEUXSBOT）跨平台安装配置完整教程，支持 macOS、Windows、Linux 三平台实操。 --- ## 📋 目录 1. [系统要求](#系统要求) 2. [macOS 部署](#macos-部署) 3. [Windows 部署](#windows-部署) 4. [Linux 部署](#linux-部署) 5. [AI 模型配置](#ai-模型配置) 6. [消息平台对接](#消息平台对接) 7. [故障排除](#故障排除) --- ## 系统要求 ### 最低配置 | 项目 | 要求 | |------|------| | **操作系统** | Windows 10/11, macOS 10.15+, Ubuntu 20.04+ | | **内存** | 4GB RAM | | **磁盘空间** | 2GB 可用空间 | | **网络** | 需要访问 AI 模型 API（或使用本地模型） | ### 推荐配置 | 项目 | 要求 | |------|------| | **操作系统** | Windows 11, macOS 12+, Ubuntu 22.04+ | | **内存** | 8GB RAM 或更多 | | **磁盘空间** | 5GB 可用空间 | | **处理器** | 支持本地模型运行（如使用 Ollama） | --- ## macOS 部署 ### 方法一：DMG 安装包（推荐） **步骤 1：下载安装包** ```bash # 访问 GitHub Releases 下载最新版 curl -LO https://github.com/Markovmodcn/openclaw-china/releases/latest/download/NEUXSBOT.dmg ``` **步骤 2：安装应用** 1. 双击打开 `NEUXSBOT.dmg` 2. 将 NEUXSBOT 图标拖拽到 Applications 文件夹 3. 等待复制完成 **步骤 3：首次运行** ```bash # 方法 1：通过 Applications 打开 open /Applications/NEUXSBOT.app # 方法 2：如果提示"无法验证开发者" # 前往 系统设置 > 隐私与安全 > 允许打开 ``` **绕过安全检查：** 1. 右键点击 NEUXSBOT.app 2. 选择"打开" 3. 在弹出的对话框中点击"打开" ### 方法二：脚本安装 ```bash # 一键安装脚本 curl -fsSL https://raw.githubusercontent.com/Markovmodcn/openclaw-china/main/scripts/install.sh | bash ``` ### 方法三：Homebrew 安装（如可用） ```bash # 添加 tap（如果官方提供） brew tap openclaw/china # 安装 brew install --cask nexusbot ``` ### macOS 配置文件位置 ```bash # 配置文件 ~/.nexusbot/config.yaml # 日志文件 ~/.nexusbot/logs/ # 数据文件 ~/.nexusbot/data/ # 技能插件 ~/.nexusbot/skills/ ``` --- ## Windows 部署 ### 方法一：安装版（推荐） **步骤 1：下载安装包** ```powershell # 使用 PowerShell 下载 Invoke-WebRequest -Uri "https://github.com/Markovmodcn/openclaw-china/releases/latest/download/NEUXSBOT-Setup.exe" -OutFile "NEUXSBOT-Setup.exe" ``` 或直接访问浏览器下载： - 打开 https://github.com/Markovmodcn/openclaw-china/releases/latest - 下载 `NEUXSBOT-Setup.exe` **步骤 2：运行安装程序** 1. 双击 `NEUXSBOT-Setup.exe` 2. 如果提示"Windows 已保护你的电脑"： - 点击"更多信息" - 点击"仍要运行" 3. 按照安装向导操作 4. 选择安装位置（默认：`C:\Program Files\NEUXSBOT`） **步骤 3：完成安装** - 安装完成后会自动创建桌面快捷方式 - 双击快捷方式启动 ### 方法二：绿色便携版 ```powershell # 下载便携版 Invoke-WebRequest -Uri "https://github.com/Markovmodcn/openclaw-china/releases/latest/download/NEUXSBOT-Portable.zip" -OutFile "NEUXSBOT-Portable.zip" # 解压 Expand-Archive -Path "NEUXSBOT-Portable.zip" -DestinationPath "C:\Tools\NEUXSBOT" # 运行 & "C:\Tools\NEUXSBOT\NEUXSBOT.exe" ``` ### 方法三：PowerShell 脚本安装 ```powershell # 一键安装 iwr -useb https://raw.githubusercontent.com/Markovmodcn/openclaw-china/main/scripts/install.ps1 | iex ``` ### Windows 配置文件位置 ```powershell # 配置文件 %USERPROFILE%\.nexusbot\config.yaml # 日志文件 %USERPROFILE%\.nexusbot\logs\ # 数据文件 %USERPROFILE%\.nexusbot\data\ ``` ### Windows 防火墙设置 如果 NEUXSBOT 需要接收外部 webhook： ```powershell # 以管理员身份运行 PowerShell New-NetFirewallRule -DisplayName "NEUXSBOT" -Direction Inbound -Protocol TCP -LocalPort 3000 -Action Allow ``` --- ## Linux 部署 ### Ubuntu/Debian（推荐） **步骤 1：下载 .deb 包** ```bash # 下载最新版 wget https://github.com/Markovmodcn/openclaw-china/releases/latest/download/nexusbot_amd64.deb # 或使用 curl curl -LO https://github.com/Markovmodcn/openclaw-china/releases/latest/download/nexusbot_amd64.deb ``` **步骤 2：安装** ```bash # 安装 .deb 包 sudo dpkg -i nexusbot_amd64.deb # 如果提示依赖问题，修复依赖 sudo apt-get install -f ``` **步骤 3：启动** ```bash # 命令行启动 nexusbot # 或使用 systemd 服务 sudo systemctl enable nexusbot sudo systemctl start nexusbot ``` ### CentOS/RHEL/Fedora ```bash # 下载 RPM 包（如提供） wget https://github.com/Markovmodcn/openclaw-china/releases/latest/download/nexusbot_amd64.rpm # 安装 sudo rpm -i nexusbot_amd64.rpm # 或使用 dnf sudo dnf install nexusbot_amd64.rpm ``` ### 通用脚本安装（所有发行版） ```bash # 一键安装脚本 curl -fsSL https://raw.githubusercontent.com/Markovmodcn/openclaw-china/main/scripts/install.sh | bash ``` ### Docker 安装（跨平台） ```bash # 使用 Docker 运行 docker run -d \ --name nexusbot \ -p 3000:3000 \ -v nexusbot-data:/data \ markovmodcn/nexusbot:latest # 查看日志 docker logs -f nexusbot # 停止 docker stop nexusbot # 删除 docker rm nexusbot ``` ### Docker Compose 部署 创建 `docker-compose.yml`： ```yaml version: '3.8' services: nexusbot: image: markovmodcn/nexusbot:latest container_name: nexusbot restart: unless-stopped ports: - "3000:3000" volumes: - nexusbot-data:/data - ./config.yaml:/app/config.yaml:ro environment: - NODE_ENV=production - LOG_LEVEL=info volumes: nexusbot-data: ``` 启动： ```bash docker-compose up -d ``` ### Linux 配置文件位置 ```bash # 配置文件 ~/.nexusbot/config.yaml # 日志文件 ~/.nexusbot/logs/ # 数据文件 ~/.nexusbot/data/ # 全局配置（如使用 systemd） /etc/nexusbot/config.yaml ``` ### Linux 系统服务设置 创建 systemd 服务文件 `/etc/systemd/system/nexusbot.service`： ```ini [Unit] Description=NEUXSBOT AI Agent After=network.target [Service] Type=simple User=your-username WorkingDirectory=/home/your-username ExecCommand=/usr/bin/nexusbot Restart=always RestartSec=10 [Install] WantedBy=multi-user.target ``` 启用并启动： ```bash sudo systemctl daemon-reload sudo systemctl enable nexusbot sudo systemctl start nexusbot # 查看状态 sudo systemctl status nexusbot # 查看日志 sudo journalctl -u nexusbot -f ``` --- ## AI 模型配置 ### 选项 A：本地模型（推荐） #### 安装 Ollama **macOS：** ```bash # 下载安装 brew install ollama # 或从官网下载 # https://ollama.com ``` **Windows：** ```powershell # 下载安装包 # https://ollama.com/download/windows # 或使用 Chocolatey choco install ollama ``` **Linux：** ```bash # 一键安装 curl -fsSL https://ollama.com/install.sh | sh ``` #### 下载模型 ```bash # 拉取模型（推荐 Qwen2.5 中文版） ollama pull qwen2.5:7b # 或其他模型 ollama pull llama3.2:8b ollama pull deepseek-r1:7b ``` #### 配置 NEUXSBOT 连接 Ollama 编辑 `~/.nexusbot/config.yaml`： ```yaml ai: provider: ollama ollama: host: http://localhost:11434 model: qwen2.5:7b temperature: 0.7 ``` ### 选项 B：在线模型 #### DeepSeek（推荐） ```yaml ai: provider: deepseek deepseek: [REDACTED_SECRET] model: deepseek-chat ``` 获取 API Key：https://platform.deepseek.com #### Kimi（Moonshot） ```yaml ai: provider: kimi kimi: [REDACTED_SECRET] model: moonshot-v1-8k ``` 获取 API Key：https://platform.moonshot.cn #### 通义千问 ```yaml ai: provider: qwen qwen: [REDACTED_SECRET] model: qwen-turbo ``` 获取 API Key：https://dashscope.aliyun.com --- ## 消息平台对接 ### 钉钉配置 **步骤 1：创建钉钉机器人** 1. 登录钉钉开放平台：https://open.dingtalk.com 2. 创建企业内部应用 3. 获取 `AppKey` 和 `AppSecret` 4. 配置机器人 webhook **步骤 2：配置 NEUXSBOT** ```yaml platforms: dingtalk: enabled: true app_key: your_app_key app_secret: your_app_secret webhook_port: 3000 ``` ### 飞书配置 **步骤 1：创建飞书应用** 1. 登录飞书开放平台：https://open.feishu.cn 2. 创建企业自建应用 3. 获取 `AppID` 和 `AppSecret` 4. 订阅消息事件 **步骤 2：配置 NEUXSBOT** ```yaml platforms: feishu: enabled: true app_id: your_app_id app_secret: your_app_secret webhook_port: 3000 encrypt_key: your_encrypt_key verification_token: your_verification_token ``` ### 企业微信配置 **步骤 1：创建企业微信应用** 1. 登录企业微信管理后台 2. 应用管理 → 创建应用 3. 获取 `CorpID`、`AgentID`、`Secret` 4. 配置接收消息 **步骤 2：配置 NEUXSBOT** ```yaml platforms: wecom: enabled: true corp_id: your_corp_id agent_id: your_agent_id [REDACTED_SECRET] [REDACTED_SECRET] aes_key: your_aes_key webhook_port: 3000 ``` --- ## 验证安装 ### 检查服务状态 ```bash # 查看进程 # macOS/Linux ps aux | grep nexusbot # Windows Get-Process | Where-Object {$_.Name -like "*nexusbot*"} ``` ### 测试 AI 连接 ```bash # 查看日志 tail -f ~/.nexusbot/logs/app.log # 应该看到 # "AI provider connected successfully" # "Model: qwen2.5:7b" ``` ### 测试消息平台 1. 在对应平台（钉钉/飞书/企微）找到机器人 2. 发送测试消息："你好" 3. 检查机器人是否回复 --- ## 故障排除 ### 常见问题 #### macOS "无法验证开发者" **症状：** 提示"无法打开，因为无法验证开发者" **解决：** ```bash # 方法 1：右键打开 # 右键点击应用 → 打开 → 仍要打开 # 方法 2：命令行 xattr -d com.apple.quarantine /Applications/NEUXSBOT.app # 方法 3：系统设置 # 系统设置 → 隐私与安全 → 允许从以下位置下载的应用 → 允许 ``` #### Windows "Windows 已保护你的电脑" **症状：** SmartScreen 阻止运行 **解决：** 1. 点击"更多信息" 2. 点击"仍要运行" 3. 或以管理员身份运行 #### Linux 依赖问题 **症状：** 提示缺少依赖库 **解决：** ```bash # Ubuntu/Debian sudo apt-get update sudo apt-get install -f # CentOS/RHEL sudo yum install -y libstdc++6 ``` #### AI 模型连接失败 **症状：** 提示"Failed to connect to AI provider" **解决：** ```bash # 检查 Ollama 是否运行 curl http://localhost:11434/api/tags # 如果没有运行 ollama serve # 检查配置 cat ~/.nexusbot/config.yaml | grep -A 5 ollama ``` #### Webhook 接收不到消息 **症状：** 机器人不回复 **解决：** ```bash # 检查端口是否被占用 lsof -i :3000 # 检查防火墙 # macOS sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /Applications/NEUXSBOT.app # Linux sudo ufw allow 3000/tcp # Windows New-NetFirewallRule -DisplayName "NEUXSBOT" -Direction Inbound -LocalPort 3000 -Protocol TCP -Action Allow ``` ### 日志查看 ```bash # macOS/Linux tail -f ~/.nexusbot/logs/app.log # Windows Get-Content "$env:USERPROFILE\.nexusbot\logs\app.log" -Wait # Docker docker logs -f nexusbot ``` ### 重置配置 ```bash # 备份并删除配置 mv ~/.nexusbot/config.yaml ~/.nexusbot/config.yaml.backup # 重启应用，会自动生成默认配置 ``` --- ## 更新升级 ### macOS ```bash # 方法 1：应用内更新 # 点击菜单栏 → 检查更新 # 方法 2：重新下载安装 # 下载最新版 DMG，覆盖安装 ``` ### Windows ```powershell # 方法 1：应用内更新 # 点击设置 → 检查更新 # 方法 2：下载新版安装包 # 运行新安装程序，会自动覆盖旧版 ``` ### Linux ```bash # Ubuntu/Debian sudo dpkg -i nexusbot_amd64.deb # 或使用 apt（如配置了源） sudo apt update sudo apt upgrade nexusbot # Docker docker pull markovmodcn/nexusbot:latest docker-compose up -d ``` --- ## 下一步 - [技能市场使用指南](./skills-guide.md) - [自定义技能开发](./custom-skill.md) - [高级配置说明](./advanced-config.md) - [API 接口文档](./api-reference.md) --- ## 参考资源 - 官网：https://www.neuxsbot.com - 文档：https://www.neuxsbot.com/docs - GitHub：https://github.com/Markovmodcn/openclaw-china - 反馈：https://github.com/Markovmodcn/openclaw-china/issues --- *本指南基于 NEUXSBOT/OpenClaw China 开源项目整理*


Security scan verdicts — ClawScan: suspicious | static analysis:  | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)