OpenClaw 一键部署工具

OpenClaw 一键部署工具是一款专为 AI 爱好者和开发者打造的私人 AI 助手一键部署工具，支持多模型、多消息渠道接入，提供图形界面与命令行两种部署方式，无需复杂的手动配置，就能快速搭建属于自己的跨平台 AI 助手，兼具灵活性与实用性。

核心基础信息：系统要求与部署方式

1. 最低系统要求（满足即可快速部署）

2. 两种部署方式（推荐图形界面，新手友好）

方式 1：桌面版 OpenClaw Manager（推荐，全平台支持）

这是图形界面版本，对新手最友好，无需接触命令行，全程可视化操作。

• 核心优势：现代化 UI、实时服务监控、可视化配置模型/渠道、跨平台兼容（macOS/Windows/Linux）
• 构建技术：Tauri 2.0 + React + TypeScript + Rust
• 下载地址：github.com/miaoxworld/openclaw-manager

方式 2：命令行版（快速部署，无图形界面依赖）

提供一键安装和手动安装两种子方式，适合服务器、虚拟机等无桌面环境的场景。

子方式 2.1：一键安装（最快，一行命令搞定）

直接执行以下命令，脚本会自动完成所有操作（检测环境、安装依赖、配置核心参数、测试连接）：

curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash

子方式 2.2：手动安装（适合有权限问题或需要自定义步骤的场景）

# 1. 克隆仓库
git clone https://github.com/miaoxworld/OpenClawInstaller.git
cd OpenClawInstaller

# 2. 添加执行权限
chmod +x install.sh config-menu.sh

# 3. 运行安装脚本
./install.sh

# macOS 若出现权限问题，先手动安装 openclaw 再运行脚本
npm install -g openclaw

核心功能亮点：多模型、多渠道、强能力

1.多模型支持（覆盖云端与本地，支持自定义 API 代理）

OpenClaw 几乎兼容目前主流的 AI 模型服务商，同时支持本地部署模型，满足不同场景的需求（免费/付费、快速/高精度、本地/云端）。

关键提示：Claude 和 OpenAI 支持自定义 API 地址，可通过代理服务降低使用成本，或解决网络访问问题。

2. 多消息渠道接入（跨平台交互，随时随地调用 AI 助手）

支持多种主流社交/办公平台，配置完成后可在任意渠道发送消息触发 AI 回复，实现“一处配置，多端使用”。

3. 核心能力（不止于对话，更像私人助理）

• 持久记忆：跨对话、跨平台的长期记忆，无需重复告知上下文
• 主动推送：支持定时提醒、每日晨报、系统告警通知等
• 技能系统：通过 Markdown 文件自定义 AI 技能，拓展功能边界
• 远程控制：可执行系统命令、读写本地文件、浏览网络（默认禁用，保障安全）

三、安装后操作：服务管理与后续配置

1. 核心服务管理命令（常用，需熟记）

# 后台启动服务（推荐，守护进程运行）
openclaw gateway start

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

# 查看服务状态
openclaw gateway status

# 前台运行（用于调试，查看实时输出）
openclaw gateway

# 查看日志（排查问题）
openclaw logs

# 实时跟踪日志
openclaw logs --follow

2. 后续详细配置（模型/渠道调整）

安装完成后，若需修改 AI 模型、新增消息渠道，可通过以下方式打开配置菜单：

# 方式 1：通过本地脚本运行
bash ~/.openclaw/config-menu.sh

# 方式 2：直接从 GitHub 下载运行（无需本地仓库）
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/config-menu.sh | bash

配置菜单支持可视化选择，按提示操作即可完成：

1. 选择「AI 模型配置」，可切换/新增模型服务商、填写 API Key/自定义地址
2. 选择「消息渠道配置」，可新增/修改 Telegram/飞书等渠道信息
3. 高级设置：更新 OpenClaw、备份配置、诊断问题等

3. 其他常用命令（配置/数据管理）

# 打开配置文件（手动编辑，不推荐新手操作）
openclaw config

# 诊断配置问题（自动排查常见错误）
openclaw doctor

# 导出对话历史（JSON 格式）
openclaw export --format json

# 备份数据（配置+对话记录）
openclaw backup

安全建议：避免潜在风险

OpenClaw 需获取一定的系统权限，尤其支持 shell 命令、文件访问等功能，务必重视安全，遵循以下建议：

1. 环境隔离：不要在主力工作电脑上部署，优先使用专用服务器、虚拟机或云免费实例
2. 禁用危险功能：默认已禁用 shell 命令和文件访问，不要随意开启（配置中 enable_shell_commands: false）
3. 启用沙箱模式：在配置中设置 sandbox_mode: true，限制 AI 助手的操作范围
4. 权限控制：配置消息渠道时，添加允许的用户 ID（如 Telegram 的 allowed_users），避免陌生人调用
5. API Key 安全：定期轮换 API Key，不要将配置文件提交到公开代码仓库，敏感信息通过环境变量存储

常见问题排查（解决部署中的高频问题）

1. 问题：安装时提示 Node.js 版本过低？

   # macOS 解决方案
   brew install node@22
   brew link --overwrite node@22
   
   # Ubuntu/Debian 解决方案
   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
   sudo apt-get install -y nodejs
   

2. 问题：启动后无法连接，AI 无响应？
   • 步骤 1：运行诊断命令排查配置问题 openclaw doctor
   • 步骤 2：查看日志定位错误 openclaw logs
   • 步骤 3：确认 API Key 有效、自定义 API 地址可正常访问
3. 问题：Telegram 机器人没有响应？
   • 确认 Bot Token 填写正确
   • 确认个人 User ID 在 allowed_users 列表中
   • 检查网络连接（需能访问 Telegram 服务器，可能需要配置代理）
4. 问题：如何更新到最新版本？

   # 方式 1：npm 直接更新
   npm update -g openclaw
   
   # 方式 2：通过配置菜单更新
   ./config-menu.sh # 选择「高级设置」→「更新 OpenClaw」
   

5. 问题：如何完全卸载 OpenClaw？

   # 1. 停止运行中的服务
   openclaw gateway stop
   
   # 2. 卸载 npm 包
   npm uninstall -g openclaw
   
   # 3. 删除配置文件和数据（可选，彻底清理）
   rm -rf ~/.openclaw
   

目录结构与配置说明（了解即可，无需手动修改）

OpenClaw 的所有配置、日志、备份都存储在 ~/.openclaw/ 目录下，核心文件作用如下：

~/.openclaw/
├── openclaw.json  # 核心配置文件（自动管理，无需手动编辑）
├── env            # 环境变量文件（存储 API Key、自定义 API 地址等敏感信息）
├── backups/       # 自动/手动备份的配置与数据
└── logs/          # 服务运行日志（排查问题的核心依据）