OpenClaw 全平台部署指南
OpenClaw(NEUXSBOT)跨平台安装配置完整教程,支持 macOS、Windows、Linux 三平台实操。
📋 目录
- 1. 系统要求
- macOS 部署
- Windows 部署
- Linux 部署
- AI 模型配置
- 消息平台对接
- 故障排除
系统要求
最低配置
| 项目 | 要求 |
|---|
| 操作系统 | 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:下载安装包
CODEBLOCK0
步骤 2:安装应用
- 1. 双击打开 INLINECODE0
- 将 NEUXSBOT 图标拖拽到 Applications 文件夹
- 等待复制完成
步骤 3:首次运行
CODEBLOCK1
绕过安全检查:
- 1. 右键点击 NEUXSBOT.app
- 选择"打开"
- 在弹出的对话框中点击"打开"
方法二:脚本安装
CODEBLOCK2
方法三:Homebrew 安装(如可用)
CODEBLOCK3
macOS 配置文件位置
CODEBLOCK4
Windows 部署
方法一:安装版(推荐)
步骤 1:下载安装包
CODEBLOCK5
或直接访问浏览器下载:
- - 打开 https://github.com/Markovmodcn/openclaw-china/releases/latest
- 下载 INLINECODE1
步骤 2:运行安装程序
- 1. 双击 INLINECODE2
- 如果提示"Windows 已保护你的电脑":
- 点击"更多信息"
- 点击"仍要运行"
- 3. 按照安装向导操作
- 选择安装位置(默认:
C:\Program Files\NEUXSBOT)
步骤 3:完成安装
- - 安装完成后会自动创建桌面快捷方式
- 双击快捷方式启动
方法二:绿色便携版
CODEBLOCK6
方法三:PowerShell 脚本安装
CODEBLOCK7
Windows 配置文件位置
CODEBLOCK8
Windows 防火墙设置
如果 NEUXSBOT 需要接收外部 webhook:
CODEBLOCK9
Linux 部署
Ubuntu/Debian(推荐)
步骤 1:下载 .deb 包
CODEBLOCK10
步骤 2:安装
CODEBLOCK11
步骤 3:启动
CODEBLOCK12
CentOS/RHEL/Fedora
CODEBLOCK13
通用脚本安装(所有发行版)
CODEBLOCK14
Docker 安装(跨平台)
CODEBLOCK15
Docker Compose 部署
创建 docker-compose.yml:
CODEBLOCK16
启动:
CODEBLOCK17
Linux 配置文件位置
CODEBLOCK18
Linux 系统服务设置
创建 systemd 服务文件 /etc/systemd/system/nexusbot.service:
CODEBLOCK19
启用并启动:
CODEBLOCK20
AI 模型配置
选项 A:本地模型(推荐)
安装 Ollama
macOS:
CODEBLOCK21
Windows:
CODEBLOCK22
Linux:
CODEBLOCK23
下载模型
CODEBLOCK24
配置 NEUXSBOT 连接 Ollama
编辑 ~/.nexusbot/config.yaml:
CODEBLOCK25
选项 B:在线模型
DeepSeek(推荐)
CODEBLOCK26
获取 API Key:https://platform.deepseek.com
Kimi(Moonshot)
CODEBLOCK27
获取 API Key:https://platform.moonshot.cn
通义千问
CODEBLOCK28
获取 API Key:https://dashscope.aliyun.com
消息平台对接
钉钉配置
步骤 1:创建钉钉机器人
- 1. 登录钉钉开放平台:https://open.dingtalk.com
- 创建企业内部应用
- 获取
AppKey 和 INLINECODE8 - 配置机器人 webhook
步骤 2:配置 NEUXSBOT
CODEBLOCK29
飞书配置
步骤 1:创建飞书应用
- 1. 登录飞书开放平台:https://open.feishu.cn
- 创建企业自建应用
- 获取
AppID 和 INLINECODE10 - 订阅消息事件
步骤 2:配置 NEUXSBOT
CODEBLOCK30
企业微信配置
步骤 1:创建企业微信应用
- 1. 登录企业微信管理后台
- 应用管理 → 创建应用
- 获取
CorpID、AgentID、 INLINECODE13 - 配置接收消息
步骤 2:配置 NEUXSBOT
CODEBLOCK31
验证安装
检查服务状态
CODEBLOCK32
测试 AI 连接
CODEBLOCK33
测试消息平台
- 1. 在对应平台(钉钉/飞书/企微)找到机器人
- 发送测试消息:"你好"
- 检查机器人是否回复
故障排除
常见问题
macOS "无法验证开发者"
症状: 提示"无法打开,因为无法验证开发者"
解决:
CODEBLOCK34
Windows "Windows 已保护你的电脑"
症状: SmartScreen 阻止运行
解决:
- 1. 点击"更多信息"
- 点击"仍要运行"
- 或以管理员身份运行
Linux 依赖问题
症状: 提示缺少依赖库
解决:
CODEBLOCK35
AI 模型连接失败
症状: 提示"Failed to connect to AI provider"
解决:
CODEBLOCK36
Webhook 接收不到消息
症状: 机器人不回复
解决:
CODEBLOCK37
日志查看
CODEBLOCK38
重置配置
CODEBLOCK39
更新升级
macOS
CODEBLOCK40
Windows
CODEBLOCK41
Linux
CODEBLOCK42
下一步
参考资源
- - 官网: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 开源项目整理
OpenClaw 全平台部署指南
OpenClaw(NEUXSBOT)跨平台安装配置完整教程,支持 macOS、Windows、Linux 三平台实操。
📋 目录
- 1. 系统要求
- macOS 部署
- Windows 部署
- Linux 部署
- AI 模型配置
- 消息平台对接
- 故障排除
系统要求
最低配置
| 项目 | 要求 |
|---|
| 操作系统 | 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
- 将 NEUXSBOT 图标拖拽到 Applications 文件夹
- 等待复制完成
步骤 3:首次运行
bash
方法 1:通过 Applications 打开
open /Applications/NEUXSBOT.app
方法 2:如果提示无法验证开发者
前往 系统设置 > 隐私与安全 > 允许打开
绕过安全检查:
- 1. 右键点击 NEUXSBOT.app
- 选择打开
- 在弹出的对话框中点击打开
方法二:脚本安装
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
- 如果提示Windows 已保护你的电脑:
- 点击更多信息
- 点击仍要运行
- 3. 按照安装向导操作
- 选择安装位置(默认: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