OpenClawInstaller - 一键部署私人 AI 助手 OpenClaw

项目数据

• ⭐ GitHub Stars: 1.7k+
• 🍴 Forks: 265+
• 📦 版本: v1.0.0（2026-01-29 首次发布）
• 📄 License: MIT（README 注明）
• 🌐 OpenClaw 官网/文档: clawd.bot、clawd.bot/docs
• 💬 社区: GitHub Issues、Discussions（若开放）

主要功能

核心作用

OpenClawInstaller 的核心作用是让 OpenClaw 的安装与初次配置变得可重复、低心智负担：

1. 环境与依赖：检测操作系统与 Node 版本（要求 Node.js v22+），指导或自动安装依赖
2. 安装 OpenClaw：通过 npm install -g openclaw 安装全局 CLI 与 Gateway
3. 引导配置：交互式选择 AI 模型（含自定义 API 地址）、填写 API Key、可选配置消息渠道
4. 验证与启动：测试 API 连接、可选启动 Gateway、提供配置菜单入口做后续细调

使用场景

1. 个人私有 AI 助手
   • 在 VPS 或本机一键部署，用 Telegram/Discord 与 Claude 或 GPT 对话，数据与密钥自控
2. 团队内部机器人
   • 接入飞书/Slack，统一使用同一套模型与记忆，配合技能系统做内部工具封装
3. 多模型与中转
   • 支持 OneAPI/NewAPI 等自定义 API 地址，方便使用中转或自建 API；同时支持 OpenRouter、Groq、Ollama 等
4. 快速体验 OpenClaw
   • 不熟悉 Node 或 OpenClaw 配置时，用一条 curl 命令完成从零到可用的体验
5. 配合桌面版管理
   • 安装完成后用 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。

核心特性

1. 多模型支持
   • Anthropic Claude（支持自定义 API 地址）、OpenAI GPT（支持自定义 API，需支持 Responses API）、Google Gemini、OpenRouter、Groq、Mistral AI、Ollama（本地无需 Key）
2. 多渠道接入
   • Telegram、Discord、WhatsApp、Slack、微信、iMessage（仅 macOS）、飞书；配置菜单内按渠道分步说明（Bot Token、Channel ID、飞书 App ID/Secret 等）
3. 交互式配置菜单
   • AI 模型配置、消息渠道配置、API 测试、诊断、更新等集中在一个菜单中，无需手改配置文件
4. OpenClaw 核心能力
   • 持久记忆、主动推送（定时提醒、晨报等）、技能系统（Markdown 定义能力）、可选的远程控制（需谨慎开启并阅读安全建议）
5. 跨平台
   • 支持 macOS、Ubuntu、Debian、CentOS；桌面版支持 macOS、Windows、Linux

项目优势

为什么选择 OpenClawInstaller？

• 降低门槛：从「不知道如何装 OpenClaw」到「一条命令 + 按提示填 Key」即可用
• 与主仓库配套：安装的是官方 openclaw，版本与能力与 openclaw/openclaw 一致，Installer 只做安装与配置流程
• 可选桌面版：命令行与 OpenClaw Manager 可并存，按习惯选择

项目详细剖析

安装流程简述

1. 执行安装脚本：install.sh 检测 OS、检查/安装 Node（v22+）、必要时安装 openclaw（npm install -g openclaw）
2. 环境与配置：配置写入 ~/.openclaw/env（API Key、BASE_URL 等）与 ~/.openclaw/openclaw.json（模型、渠道等）；使用自定义 API 地址时会在 openclaw.json 中写入自定义 Provider
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（或 OpenAI 等）
• OpenClaw 配置：~/.openclaw/openclaw.json（由 OpenClaw 与安装/配置流程管理）
• 其他：~/.openclaw/backups/、~/.openclaw/logs/ 等

配置建议通过安装向导或 config-menu.sh 完成，避免直接手改 JSON 出错。

安全建议（README 要点）

• 权限：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 → 可选 rm -rf ~/.openclaw

项目地址与资源

官方资源

• 🌟 本仓库: github.com/miaoxworld/OpenClawInstaller
• 🖥️ OpenClaw Manager 桌面版: github.com/miaoxworld/openclaw-manager
• 📚 OpenClaw 官网: clawd.bot
• 📦 OpenClaw 主仓库: github.com/openclaw/openclaw

相关资源

• 仓库内 README：系统要求、快速开始、多模型/多渠道配置、安全建议、常见问题、更新日志
• 飞书配置：README 指向 docs/feishu-setup.md（若存在）的飞书机器人配置与长连接说明
• Claude-Mem 等插件可与 OpenClaw 网关配合使用（参见 Claude-Mem 文档的 OpenClaw 集成）

适用人群

• 想快速用上 OpenClaw 的用户：一条命令完成安装与基础配置
• 需要 Telegram/Discord/飞书/WhatsApp 等渠道接入的开发者或团队：脚本与文档集中说明各渠道步骤
• 偏好图形界面者：安装后使用 OpenClaw Manager 做日常管理与监控
• 自建 AI 网关与多模型：支持官方 API 与自定义 API 地址，便于与现有代理或自建服务结合