OpenClaw云部署实践

#
OpenClaw 本地
部署教程
OpenClaw（原Clawdbot/Moltbot）是一个开源的中文智能体框架，支持通过
飞书等渠道接入大模型，实现自动化任务处理与智能对话。以下是基于不同环境和需求的详细
部署方案推演与实操指南。 1.
部署方案解构 在进行
部署前，需要根据操作系统和模型选择确定具体的
部署路径。
OpenClaw 支持多种操作系统和模型接入方式，主要分为以下几种场景： |
部署场景 | 适用系统/环境 | 核心依赖 | 特点 | | :— | :— | :— | :— | | 标准 Windows
部署 | Windows (PowerShell/CMD) | Node.js, npm | 适合初学者，支持一键脚本安装 [ref_1][ref_5]。 | | WSL2
部署 | Windows + WSL2 | Node.js, CMake, Git | 适合需要 Linux 环境兼容性或对接复杂后端的用户 [ref_2][ref_3]。 | | macOS/Linux
部署 | macOS / Linux | Node.js, Docker (可选) | 原生支持，性能更优，适合开发者环境 [ref_3]。 | | 云模型接入 | 上述任意环境 | 阿里云百炼/MiniMax API Key | 无需本地显卡，响应速度快，按需付费 [ref_1][ref_3][ref_5]。 | | 本地大模型接入 | 上述任意环境 | Ollama 或 vLLM | 数据隐私性好，无需联网，需本地算力支持 [ref_2][ref_4]。 | 2. 基础环境准备 无论选择哪种
部署场景，Node.js 环境是必须的基础组件。建议使用 Node.js 18 或更高版本以确保兼容性 [ref_2][ref_3]。 2.1 安装 Node.js 请访问 Node.js 官网下载并安装 LTS 版本。安装完成后，在终端（Terminal、PowerShell 或 CMD）中验证安装： “`bash # 检查 Node.js 版本 node -v # 检查 npm 版本 npm -v “` 2.2 安装
OpenClaw
OpenClaw 提供了便捷的安装脚本。在 Windows 下，可以使用 PowerShell 进行一键安装 [ref_1][ref_5]： “`powershell # Windows PowerShell 一键安装命令 irm https://
openclaw.cn/install.ps1 | iex “` 对于 macOS、Linux 或 WSL2 用户，通常使用 npm 进行全局安装 [ref_3]： “`bash # 使用 npm 全局安装
OpenClaw npm install -g
openclaw-cn “` 3. 核心配置流程 安装完成后，首次运行需要通过配置向导完成初始化，主要包括模型配置和
飞书机器人接入。 3.1 启动配置向导 在终端中运行以下命令启动首次配置向导（CLI）： “`bash # 启动 onboard 配置向导
openclaw onboard “` 该向导将引导用户完成基础设置，包括选择模型提供商和配置网关端口等 [ref_1][ref_5]。 3.2 配置大模型 API
OpenClaw 支持接入云端模型（如阿里云百炼、MiniMax）和本地模型（如 Ollama、vLLM）。 * 云端模型配置： 在向导中或配置文件中填入对应的 API Key。例如，使用阿里云百炼平台获取的 API Key [ref_1][ref_5]。 * 本地模型配置： 若使用 Ollama，需先安装 Ollama 并拉取模型（如 `qwen3:32b`），然后在 `
openclaw.json` 配置文件中指定模型名称和接口地址 [ref_4]。若对接远程 vLLM 服务，则需在配置中指定远程服务器的 IP 和端口 [ref_2]。 3.3
飞书机器人集成 这是实现智能体交互的关键步骤，涉及
飞书开放平台的配置。 1. 创建应用：在
飞书开放平台创建企业自建应用，获取 `App ID` 和 `App Secret` [ref_1][ref_3]。 2. 权限配置：必须开启 `im:message` 及 `im:message.group_at_msg`（群聊@机器人）等相关权限，并更新权限包 [ref_1][ref_5]。 3. 事件订阅：配置事件订阅，订阅 `im.message.receive_v1` 事件以接收消息。
OpenClaw 通常会启动一个本地网关服务（默认端口 `18789`），需要将
飞书平台的请求地址指向该本地地址（如 `http:/openclaw/127.0.0.1:18789/feishu`）[ref_1][ref_4]。 4. 启动与验证 配置完成后，即可启动
OpenClaw 网关服务。 4.1 启动网关服务 在终端执行启动命令： “`bash # 启动
OpenClaw 网关
openclaw gateway “` 启动成功后，通常会显示 Web 可视化管理后台的地址，一般为 `http://127.0.0.1:18789`。用户可以通过浏览器访问该地址查看运行状态和调试日志 [ref_4][ref_5]。 4.2 功能验证 * 私聊验证：在
飞书中给机器人发送消息，检查是否收到回复。 * 群聊验证：将机器人加入
飞书群聊，在群内 @机器人 提问，测试其响应能力 [ref_3]。 * 工具调用验证：尝试发送“查询磁盘”或“读取文件”等指令，验证
AI
Agent 的自动化任务执行能力 [ref_3]。 5. 常见问题与卸载 5.1 常见问题排查 * 端口冲突：如果 `18789` 端口被占用，需在配置文件中修改端口或关闭占用进程 [ref_1]。 *
飞书消息无响应：检查
飞书开放平台的事件订阅地址是否正确，以及服务器是否成功接收到了
飞书的 POST 请求 [ref_1]。 5.2 卸载
OpenClaw 如果需要移除
OpenClaw，对于通过 pnpm 或 npm 全局安装的版本，可以使用以下命令进行卸载 [ref_6]： “`bash # 使用 npm 卸载 npm uninstall -g
openclaw-cn # 或者使用 pnpm 卸载（如果之前是用 pnpm 安装的） pnpm remove -g
openclaw-cn “` 卸载后，建议手动检查并清理全局安装目录下的残留文件夹及缓存，以确保彻底清理 [ref_6]。