OpenClawInstaller：用一条命令部署私有 AI 助手

主要功能

核心思路

OpenClawInstaller 的核心不是'多做一个工具'，而是把 OpenClaw 的安装和初次配置变成一个可重复的流程。大致就是四步：检查环境、安装 OpenClaw、引导配置、验证并启动。

1. 检测操作系统和 Node 版本，要求 Node.js v22+
2. 通过 npm install -g openclaw 安装全局 CLI 和 Gateway
3. 交互式选择模型，填写 API Key，按需配置消息渠道
4. 测试连接，询问是否启动服务，再给一个配置菜单入口继续调

适合什么场景

• 个人私有 AI 助手：在 VPS 或本机上跑起来，用 Telegram / Discord 跟 Claude 或 GPT 对话，密钥和数据自己掌握
• 团队内部机器人：接飞书或 Slack，统一模型和记忆，顺手把一些内部能力封进技能里
• 多模型和中转：支持 OneAPI / NewAPI 这类自定义地址，也支持 OpenRouter、Groq、Ollama
• 快速体验 OpenClaw：不想先啃一堆文档时，一条 curl 命令就能把流程跑完
• 配合桌面版管理：装完后用 OpenClaw Manager 做可视化管理，比盯着命令行轻松一些

快速开始

系统要求：macOS 12+ / Ubuntu 20.04+ / Debian 11+ / CentOS 8+；Node.js v22+；内存建议 4GB+；磁盘至少 1GB。

方式一：一键安装（推荐）

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

脚本会检测环境、安装 OpenClaw、引导配置 AI 模型和身份、测试 API，再询问是否启动服务。之后如果还想继续细调，可以再进配置菜单。

方式二：手动安装

git clone https://github.com/miaoxworld/OpenClawInstaller.git
cd OpenClawInstaller
chmod +x install.sh config-menu.sh
./install.sh

如果在 macOS 上碰到权限问题，先手动执行 npm install -g openclaw，再跑 ./install.sh，通常更稳一点。

安装完成后常用命令

# 启动服务（后台）
openclaw gateway start
# 打开配置菜单（渠道、模型、高级设置等）
bash ~/.openclaw/config-menu.sh
# 或通过 curl 运行最新配置菜单
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/config-menu.sh | bash

如果更偏好图形界面，可以用 OpenClaw Manager。它基于 Tauri + React，支持 macOS、Windows、Linux，适合做日常监控和配置，不用每次都回到终端。

主要特性

• 多模型支持：Anthropic Claude、OpenAI GPT、Google Gemini、OpenRouter、Groq、Mistral AI、Ollama 都在支持范围内，其中 Claude 和 OpenAI 还能配置自定义 API 地址
• 多渠道接入：Telegram、Discord、WhatsApp、Slack、微信、iMessage（仅 macOS）、飞书都能配，菜单里会把 Bot Token、Channel ID、飞书 App ID / Secret 这些字段拆开说明
• 交互式配置菜单：模型、渠道、API 测试、诊断、更新集中到一个入口里，不用直接改配置文件
• OpenClaw 核心能力：持久记忆、主动推送、技能系统和可选的远程控制都保留了下来，只是安装和配置更顺手
• 跨平台：Installer 支持 macOS、Ubuntu、Debian、CentOS；桌面版覆盖 macOS、Windows、Linux

项目优势

我更愿意把它理解成'把 OpenClaw 的第一公里铺平了'。真正复杂的部分还在上游，但至少你不用从环境变量、Node 版本和各种 Token 的坑里慢慢爬出来。

项目细节

安装流程

1. 运行 install.sh，脚本先检查操作系统，再看 Node 是否满足 v22+，必要时安装 openclaw
2. 配置会写入 ~/.openclaw/env 和 ~/.openclaw/openclaw.json；前者放 API Key、BASE_URL 之类的环境变量，后者放模型和渠道配置
3. 安装脚本会带着你选模型、填 Key、做 API 测试，然后再问要不要启动 Gateway、要不要打开配置菜单
4. 后续管理可以用 openclaw gateway start/stop/restart、openclaw config、openclaw doctor，也可以直接进 config-menu.sh，或者用 OpenClaw Manager

配置和目录

• ~/.openclaw/env：环境变量文件，例如 ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL
• ~/.openclaw/openclaw.json：OpenClaw 配置文件，由安装和配置流程共同管理
• ~/.openclaw/backups/、~/.openclaw/logs/：备份和日志目录

这部分最省心的做法还是跟着向导走。手改 JSON 不是不行，只是出错了很难一眼看出来。

安全建议

• OpenClaw 能配置执行系统命令、访问文件等能力，默认别轻易开高权限，尤其不要在主工作电脑上长期放着一个'什么都能干'的实例
• API Key、Token 这类敏感信息放环境变量里，别提交到公开仓库
• 渠道权限最好收紧一点，比如 Telegram 可以限制只响应指定 User ID，省得被乱用

常见问题

• Node 版本过低：升级到 v22+。macOS 可以用 brew install node@22，Ubuntu / Debian 可以走 NodeSource 的 setup_22.x
• 启动后连不上：先跑 openclaw doctor，再看 openclaw logs
• Telegram 没反应：核对 Bot Token、User ID、allowed_users（如果启用了）以及网络或代理
• 更新：可以用 npm update -g openclaw，也可以从配置菜单里点'更新 OpenClaw'
• 卸载：openclaw gateway stop → npm uninstall -g openclaw → 视情况删除 ~/.openclaw

项目地址与资源

官方资源

• github.com/miaoxworld/OpenClawInstaller
• github.com/miaoxworld/openclaw-manager
• clawd.bot
• github.com/openclaw/openclaw

相关资料

• 仓库 README：系统要求、快速开始、多模型/多渠道配置、安全建议、常见问题、更新日志
• 飞书配置：README 里提到 docs/feishu-setup.md，如果仓库里有这份文档，可以直接按里面的步骤配机器人和长连接
• Claude-Mem 等插件也能和 OpenClaw 网关配合使用，具体还是看各自文档

适合谁用

• 想尽快把 OpenClaw 跑起来的人
• 需要接 Telegram、Discord、飞书、WhatsApp 等渠道的开发者或团队
• 更习惯图形界面的人，后续可以切到 OpenClaw Manager
• 想自建 AI 网关、又不想从零拼多模型接入的人