【OpenClaw：实战部署】5、全平台部署OpenClaw（Win/Mac/Linux/云服务器）——10分钟跑通第一个本地AI智能体

优质文章学习记录

— 14 min read
【OpenClaw：实战部署】5、全平台部署OpenClaw（Win/Mac/Linux/云服务器）——10分钟跑通第一个本地AI智能体
在这里插入图片描述

【保姆级教程】全平台部署OpenClaw（Win/Mac/Linux/云服务器）——10分钟跑通第一个本地AI智能体

一句话导读：无论你是Windows用户、Mac爱好者，还是Linux开发者，甚至想在云服务器上7×24小时运行AI智能体，本文都能带你用10分钟完成OpenClaw全平台部署，跑通第一个本地AI指令，告别陪聊机器人，真正拥有“动手能力”。

引言：本地部署 vs 云端部署的核心差异

2026年，OpenClaw（原Clawdbot）凭借跨平台适配性、灵活的技能扩展体系，已成为开源AI Agent领域的热门工具，在GitHub下载排行已攀升至第11位。但在开始部署前，我们需要先搞清楚一个问题：到底选择本地部署，还是云端部署？

这两种方案的核心差异体现在三个维度：

云端部署

本地部署

对比维度

隐私安全

成本结构

稳定性

数据完全本地存储
无泄露风险

零服务器费用
仅需硬件投入

依赖本地设备
关机即停止

数据上传至云端
需信任云厂商

按需付费/包年包月
长期运行成本可控

7×24小时不间断
专业运维保障

选型建议

根据实际需求，可以参考以下选择逻辑：

  • 个人轻量使用、数据敏感场景：选本地部署（Win/Mac/Linux），零成本、隐私可控，适合测试和日常办公
  • 7×24小时自动化任务、多设备远程访问：选云服务器部署，依托云厂商的SLA保障，让AI智能体永远在线
  • 新手入门、不想折腾环境：首选阿里云一键部署方案，15分钟内完成，全程可视化操作

一、环境前置准备

无论选择哪种部署方式，OpenClaw都依赖以下核心环境。在开始之前，请先检查你的设备是否达标。

版本要求

组件最低版本作用
Node.js22.x+OpenClaw核心运行环境
Python3.9+部分技能脚本依赖
Docker20.10+（可选）容器化运行技能
Git2.40+技能安装与版本管理

依赖检查

打开终端（Windows用户打开PowerShell），执行以下命令验证现有环境：

# 检查Node.js版本node--version# 预期输出：v22.x.x（如v22.5.1）# 检查npm版本npm--version# 预期输出：10.x.x# 检查Python版本 python --version# Windows python3 --version# Mac/Linux# 预期输出：Python 3.9.x 或更高# 检查Git版本git--version# 预期输出：git version 2.40.x

如果版本不达标或提示“命令未找到”，别担心，下一节会详细讲解各平台的安装方法。

核心凭证准备

OpenClaw本身不具备大模型推理能力，需要对接大模型API。推荐使用阿里云百炼，因为它针对国内网络优化，且有免费额度：

  1. 注册阿里云账号并完成实名认证
  2. 访问阿里云百炼控制台
  3. 在「密钥管理」中点击「创建API-Key」
  4. 复制保存生成的API-Key（注意：离开页面后将无法再次查看）

准备流程

注册阿里云账号

完成实名认证

开通百炼服务

创建API-Key

保存密钥至加密记事本

二、分平台部署步骤

2.1 Windows部署（PowerShell）

Windows用户推荐使用PowerShell（管理员模式）进行安装，所有命令均可直接复制执行。

步骤1：以管理员身份打开PowerShell

右键点击开始菜单，选择「Windows PowerShell（管理员）」或「终端（管理员）」。

步骤2：解锁脚本执行策略
Set-ExecutionPolicy-Scope CurrentUser RemoteSigned -Force

这一步允许运行本地脚本，避免后续命令被拦截。

步骤3：安装Node.js 22.x
# 下载Node.js安装包（国内镜像加速）iwr-useb https://npmmirror.com/mirrors/node/v22.10.0/node-v22.10.0-x64.msi -OutFile node-install.msi # 静默安装（自动添加PATH）Start-Process.\node-install.msi -ArgumentList "/quiet InstallAllUsers=1 PrependPath=1"-Wait # 刷新环境变量 refreshenv
步骤4：验证安装
node --version npm --version

应显示v22.x.x和对应npm版本。

步骤5：配置npm国内镜像（加速技能安装）
npm config set registry https://registry.npmmirror.com
步骤6：全局安装OpenClaw
npm install -g openclaw@latest
步骤7：初始化配置
# 创建工作目录 mkdir ~/OpenClaw-Workspace -Force cd ~/OpenClaw-Workspace # 初始化配置，按提示输入阿里云百炼API-Key openclaw init

初始化过程中，系统会提示输入API-Key，粘贴之前保存的密钥即可。

步骤8：启动网关服务
# 前台启动（测试用） openclaw gateway start# 或后台启动（关闭终端后继续运行）Start-Job-ScriptBlock {openclaw gateway start}

2.2 macOS/Linux部署（Bash）

macOS（12+）和Linux（Ubuntu 20.04+）命令基本通用，以下以Bash为例。

步骤1：打开终端

macOS用户可在启动台搜索「终端」，Linux用户使用Ctrl+Alt+T快捷键。

步骤2：安装Homebrew（macOS必备，Linux可跳过）
/bin/bash -c"$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
步骤3：安装Node.js 22.x

macOS用户：

brew install node@22 echo'export PATH="/usr/local/opt/node@22/bin:$PATH"'>> ~/.zshrc source ~/.zshrc

Linux用户（Ubuntu/Debian）：

curl-fsSL https://deb.nodesource.com/setup_22.x |sudobashsudoaptinstall-y nodejs
步骤4：安装Git和Python（如未安装）
# Ubuntu/Debiansudoaptinstall-ygit python3 python3-pip # macOS（已通过Homebrew安装） brew installgit [email protected]
步骤5：配置国内镜像（可选，加速安装）
npm config set registry https://registry.npmmirror.com pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
步骤6：验证安装
node--versionnpm--version python3 --versiongit--version
步骤7：全局安装OpenClaw
npminstall-g openclaw@latest
步骤8：初始化配置
mkdir-p ~/OpenClaw-Workspace cd ~/OpenClaw-Workspace openclaw init

按提示输入阿里云百炼API-Key。

步骤9：启动网关服务
# 前台启动 openclaw gateway start # 或后台启动（关闭终端后继续运行）nohup openclaw gateway start &# 查看运行状态ps aux |grep openclaw
步骤10：配置开机自启（Linux systemd）
# 安装systemd服务sudo openclaw daemon install# 启动服务sudo systemctl start openclaw # 设置开机自启sudo systemctl enable openclaw # 查看状态sudo systemctl status openclaw

这样配置后，OpenClaw会作为系统服务在后台运行，服务器重启后自动启动。

2.3 云服务器部署（阿里云/腾讯云）

云服务器部署是最省心的方案，尤其适合需要7×24小时运行的场景。以阿里云为例，有两种主流方式。

方式一：轻量应用服务器一键部署（新手首选）

这是官方主推的入门方式，通过预置镜像实现可视化一键部署，无需手动敲命令。

访问OpenClaw
一键部署专题页

点击一键购买并部署

配置服务器参数

选择OpenClaw镜像

支付完成等待创建

前往百炼控制台
创建API-Key

在实例详情页
一键配置API-Key

生成访问Token

点击打开网站页面

部署完成！

详细步骤：

  1. 访问部署专题：打开阿里云OpenClaw一键部署专题页面，点击「一键购买并部署」
  2. 配置服务器参数：
    • 镜像：选择「OpenClaw(Moltbot)镜像」（应用镜像分类下）
    • 实例规格：2核2GB内存及以上（个人使用足够）
    • 地域：推荐选择中国香港或新加坡（免备案，联网搜索功能正常）
    • 时长：按需选择（测试可选1个月，长期建议包年）
  3. 支付并等待：支付完成后等待1-3分钟，实例状态变为「运行中」
  4. 配置API-Key：
    • 进入实例详情页的「应用详情」
    • 点击「一键配置」，粘贴之前获取的阿里云百炼API-Key
    • 点击「执行命令」，系统自动写入配置
  5. 生成访问Token：
    • 在应用详情页继续操作
    • 点击「执行命令」生成访问Token
    • 复制保存Token（登录Web控制台必需）
  6. 访问控制台：点击「打开网站页面」，输入Token即可进入OpenClaw对话界面
方式二：手动部署（ECS + Ubuntu）

如果你已有云服务器，或需要更高自由度，可以手动部署。

步骤1：选购服务器
  • 系统镜像：Ubuntu 22.04 LTS
  • 配置建议：2核4GB内存（多技能并发建议4核8GB）
  • 地域：中国香港（免备案）或国内地域（需备案）
  • 带宽：3Mbps以上
步骤2：安全组配置

放行以下核心端口：

端口协议用途授权对象
22TCPSSH远程连接你的公网IP
18789TCPOpenClaw控制台0.0.0.0/0
443TCPAPI调用0.0.0.0/0
8080TCPWebSocket通信0.0.0.0/0（如需）
步骤3：SSH登录服务器
ssh root@你的服务器公网IP
步骤4：安装依赖
# 更新系统apt update &&apt upgrade -y# 安装核心工具aptinstall-ycurlgit python3 python3-pip ufw # 安装Node.js 22.xcurl-fsSL https://deb.nodesource.com/setup_22.x |bashaptinstall-y nodejs # 配置国内镜像npm config set registry https://registry.npmmirror.com # 验证安装node--version
步骤5：安装OpenClaw
npminstall-g openclaw@latest
步骤6：初始化配置
mkdir ~/OpenClaw-Workspace &&cd ~/OpenClaw-Workspace openclaw init

按提示输入API-Key，其他选项可保持默认。

步骤7：配置持久化存储（可选但推荐）

为防止服务器重启后配置丢失，建议挂载云盘保存配置文件和技能数据：

# 查看磁盘fdisk-l# 挂载数据盘（假设新盘为/dev/vdb1）mkdir /data mount /dev/vdb1 /data # 迁移OpenClaw配置cp-r ~/.openclaw /data/ ln-s /data/.openclaw ~/.openclaw # 设置开机自动挂载（编辑/etc/fstab）echo'/dev/vdb1 /data ext4 defaults 0 0'>> /etc/fstab
步骤8：设置开机自启
# 安装systemd服务 openclaw daemon install# 启动服务 systemctl start openclaw # 设置开机自启 systemctl enable openclaw # 查看状态 systemctl status openclaw
步骤9：生成访问Token
openclaw token generate

复制输出的Token，访问http://你的公网IP:18789时需输入。

三、首次启动验证

无论哪种部署方式，验证流程都类似。

3.1 访问Web控制台

打开浏览器，输入对应地址：

  • 本地部署：http://127.0.0.1:18789 或 http://localhost:18789
  • 云服务器：http://你的公网IP:18789

首次访问会提示输入Token，粘贴之前生成的Token即可进入控制台。

3.2 输入第一条测试指令

在对话框中输入：

列出桌面文件

如果配置正确，OpenClaw会调用文件管理技能，返回你桌面上的文件列表。这证明：

  1. OpenClaw服务正常运行
  2. 模型API配置正确
  3. 基础技能已生效

3.3 验证流程示意图

文件管理技能模型APIGateway服务浏览器用户文件管理技能模型APIGateway服务浏览器用户输入"列出桌面文件"发送HTTP请求解析意图调用百炼API确认用户意图返回意图识别结果触发文件管理技能返回桌面文件列表格式化输出结果显示文件列表

四、常见问题排查

4.1 端口占用问题

现象：启动Gateway时报错Error: listen EADDRINUSE: address already in use :::18789

解决方法：

# Windows（PowerShell）netstat-ano| findstr 18789# 找到占用端口的PID，然后 taskkill /PID 占用端口的PID /F # Mac/Linuxlsof-i :18789 kill-9 占用端口的PID

4.2 Node版本过低

现象：安装OpenClaw时报错，或启动后功能异常

解决方法（使用nvm管理多版本）：

# 安装nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh |bash# 安装并使用Node.js 22 nvm install22 nvm use 22# 验证版本node--version

4.3 API-Key连接超时

现象：发送指令后长时间无响应，或提示“模型调用失败”

原因分析：

  1. API-Key无效或已过期
  2. 网络无法访问模型服务
  3. 阿里云账号余额不足

解决方法：

# 检查当前配置的API-Key openclaw config get model.aliyun_bailian.api_key # 重新配置API-Key openclaw config set model.aliyun_bailian.api_key "你的新API-Key"# 配置代理（如需要） openclaw config set http.proxy "http://127.0.0.1:7890"# 重启服务 openclaw gateway restart

4.4 Windows PowerShell执行策略问题

现象：运行脚本时报错“无法加载文件，因为在此系统上禁止运行脚本”

解决方法：

# 查看当前执行策略Get-ExecutionPolicy# 修改为RemoteSigned（允许本地脚本）Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

五、部署优化

5.1 开机自启配置

Windows：
创建开机启动任务：

# 创建启动脚本$action = New-ScheduledTaskAction-Execute "cmd.exe"-Argument "/c start /min openclaw gateway start"$trigger = New-ScheduledTaskTrigger-AtStartup $principal = New-ScheduledTaskPrincipal-UserId "SYSTEM"-LogonType ServiceAccount Register-ScheduledTask-TaskName "OpenClawGateway"-Action $action-Trigger $trigger-Principal $principal

Mac/Linux（已在前文介绍systemd方式）：

# 确保daemon已安装并启用sudo systemctl enable openclaw sudo systemctl start openclaw

5.2 日志持久化

默认日志保存在内存中，重启会丢失。配置持久化：

# 创建日志目录mkdir-p /var/log/openclaw # 修改日志配置 openclaw config set log.dir /var/log/openclaw openclaw config set log.level info # 配置日志轮转（可选）cat> /etc/logrotate.d/openclaw <<EOF /var/log/openclaw/*.log { daily rotate 30 compress delaycompress missingok notifempty create 0640 root root } EOF

5.3 资源限制

为防止OpenClaw占用过多系统资源，可以配置cgroup限制：

# 创建cgroupsudomkdir /sys/fs/cgroup/cpu/openclaw sudomkdir /sys/fs/cgroup/memory/openclaw # 限制CPU为0.5核echo50000|sudotee /sys/fs/cgroup/cpu/openclaw/cpu.cfs_quota_us # 限制内存为1GBecho1073741824|sudotee /sys/fs/cgroup/memory/openclaw/memory.limit_in_bytes # 将OpenClaw进程加入cgroupecho$(pgrep -f openclaw)|sudotee /sys/fs/cgroup/cpu/openclaw/cgroup.procs

5.4 安装实用技能

部署完成后，可以安装常用技能增强OpenClaw能力：

# 列出所有可用技能 openclaw skills list # 安装核心技能 openclaw skills install file-manager # 文件管理 openclaw skills install web-automation # 网页自动化 openclaw skills install summary # 内容总结 openclaw skills install scheduler # 定时任务# 查看已安装技能 openclaw skills list --installed# 重启服务使技能生效 openclaw gateway restart

结语

通过本文的保姆级教程，你应该已经成功在Windows、macOS、Linux或云服务器上部署了OpenClaw，并跑通了第一条本地指令。从环境准备到分平台部署，从首次验证到问题排查，再到部署优化，我们覆盖了全流程的每一个细节。

记住，OpenClaw的核心价值不在于“陪聊”，而在于通过Skills实现自然语言驱动的任务自动化。现在你已经拥有了一个7×24小时在线的AI智能体，接下来可以尝试安装更多技能、开发自定义技能，甚至搭建Agent Swarm多智能体团队，让AI真正成为你的“数字员工”。

如果你在部署过程中遇到其他问题，欢迎在评论区留言交流。下一篇文章，我们将深入讲解如何开发自己的第一个OpenClaw技能，敬请期待！

Read more

安装 启动 使用 Neo4j的超详细教程

安装 启动 使用 Neo4j的超详细教程

最近在做一个基于知识图谱的智能生成项目。需要用到Neo4j图数据库。写这篇文章记录一下Neo4j的安装及其使用。 一.Neo4j的安装 1.首先安装JDK，配环境变量。（参照网上教程，很多） Neo4j是基于Java的图形数据库，运行Neo4j需要启动JVM进程，因此必须安装JAVA SE的JDK。从Oracle官方网站下载 Java SE JDK。我使用的版本是JDK1.8 2.官网上安装neo4j。 官方网址：https://neo4j.com/deployment-center/  在官网上下载对应版本。Neo4j应用程序有如下主要的目录结构： bin目录：用于存储Neo4j的可执行程序； conf目录：用于控制Neo4j启动的配置文件； data目录：用于存储核心数据库文件； plugins目录：用于存储Neo4j的插件； 3.配置环境变量 创建主目录环境变量NEO4J_HOME，并把主目录设置为变量值。复制具体的neo4j文件地址作为变量值。 配置文档存储在conf目录下，Neo4j通过配置文件neo4j.conf控制服务器的工作。默认情况下，不需

企业微信群机器人Webhook配置全攻略：从创建到发送消息的完整流程

企业微信群机器人Webhook配置全攻略：从创建到发送消息的完整流程 在数字化办公日益普及的今天，企业微信作为国内领先的企业级通讯工具，其群机器人功能为团队协作带来了极大的便利。本文将手把手教你如何从零开始配置企业微信群机器人Webhook，实现自动化消息推送，提升团队沟通效率。 1. 准备工作与环境配置 在开始创建机器人之前，需要确保满足以下基本条件： * 企业微信账号：拥有有效的企业微信管理员或成员账号 * 群聊条件：至少包含3名成员的群聊（这是创建机器人的最低人数要求） * 网络环境：能够正常访问企业微信服务器 提示：如果是企业管理员，建议先在"企业微信管理后台"确认机器人功能是否已对企业开放。某些企业可能出于安全考虑会限制此功能。 2. 创建群机器人 2.1 添加机器人到群聊 1. 打开企业微信客户端，进入目标群聊 2. 点击右上角的群菜单按钮（通常显示为"..."或"⋮"） 3. 选择"添加群机器人"选项 4.

Flowise物联网融合：与智能家居设备联动的应用设想

Flowise物联网融合：与智能家居设备联动的应用设想 1. Flowise：让AI工作流变得像搭积木一样简单 Flowise 是一个真正把“AI平民化”落地的工具。它不像传统开发那样需要写几十行 LangChain 代码、配置向量库、调试提示词模板，而是把所有这些能力打包成一个个可拖拽的节点——就像小时候玩乐高，你不需要懂塑料怎么合成，只要知道哪块该拼在哪，就能搭出一座城堡。 它诞生于2023年，短短一年就收获了45.6k GitHub Stars，MIT协议开源，意味着你可以放心把它用在公司内部系统里，甚至嵌入到客户交付的产品中，完全不用担心授权问题。最打动人的不是它的技术多炫酷，而是它真的“不挑人”：产品经理能搭出知识库问答机器人，运营同学能配出自动抓取竞品文案的Agent，连刚学Python两周的实习生，也能在5分钟内跑通一个本地大模型的RAG流程。 它的核心逻辑很朴素：把LangChain里那些抽象概念——比如LLM调用、文档切分、向量检索、工具调用——变成画布上看得见、摸得着的方块。你拖一个“Ollama LLM”节点，再拖一个“Chroma Vector
OpenClaw配置Bot接入飞书机器人+Kimi2.5

OpenClaw配置Bot接入飞书机器人+Kimi2.5

上一篇文章写了Ubuntu_24.04下安装OpenClaw的过程，这篇文档记录一下接入飞书机器+Kimi2.5。 准备工作 飞书 创建飞书机器人 访问飞书开放平台：https://open.feishu.cn/app，点击创建应用： 填写应用名称和描述后就直接创建： 复制App ID 和 App Secret 创建成功后，在“凭证与基础信息”中找到 App ID 和 App Secret，把这2个信息复制记录下来，后面需要配置到openclaw中 配置权限 点击【权限管理】→【开通权限】 或使用【批量导入/导出权限】，选择导入，输入以下内容，如下图 点击【下一步，确认新增权限】即可开通所需要的权限。 配置事件与回调 说明：这一步的配置需要先讲AppId和AppSecret配置到openclaw成功之后再设置订阅方式，