一天一个开源项目（第24篇）：OpenClawInstaller - 一键部署私人 AI 助手 OpenClaw

冬奇Lab
0 阅读9分钟

引言

"把 Claude/GPT 装进 Telegram、Discord、飞书——一条命令完成环境检测、安装、配置与启动。"

这是"一天一个开源项目"系列的第24篇文章。今天带你了解的项目是 OpenClawInstaller（GitHub），由 miaoxworld 维护。

OpenClaw（官网 clawd.bot）是一个可自托管的 AI 助手网关：接入 Claude、GPT、Gemini、Ollama 等模型，通过 Telegram、Discord、WhatsApp、飞书、Slack、微信等渠道与你对话，并具备持久记忆、主动推送、技能系统与可选的远程控制能力。但若从零安装 OpenClaw、配置 Node 环境、选模型、配渠道，步骤较多。OpenClawInstaller 正是为此而生：一键安装脚本 + 交互式配置菜单，自动完成依赖检测、OpenClaw 安装、AI 模型与消息渠道配置、API 测试与服务启动，并可搭配 OpenClaw Manager 桌面端做可视化管理。

你将学到什么

  • OpenClawInstaller 的定位：降低 OpenClaw 部署与配置门槛的一键工具
  • 支持的 AI 模型（Claude/GPT/Gemini/OpenRouter/Groq/Mistral/Ollama）与消息渠道（Telegram/Discord/飞书/WhatsApp 等）
  • 快速开始：一键 curl 安装与手动安装、安装后启动与配置菜单
  • 常用命令（服务管理、配置、备份）与安全建议
  • 与 OpenClaw 主仓库、OpenClaw Manager 桌面版的关系

前置知识

  • 基本命令行操作（bash、环境变量）
  • 若使用云端模型：需自行准备对应 API Key（Anthropic/OpenAI 等）；若使用 Ollama，需本地已安装
  • 若配置 Telegram/Discord/飞书等：需在对应平台创建应用或机器人并获取 Token/ID

项目背景

项目简介

OpenClawInstaller 是 OpenClaw（ClawdBot）的一键部署工具，主要提供：

  1. 安装脚本（install.sh）：检测系统（macOS / Ubuntu / Debian / CentOS）、安装依赖与 Node 环境、通过 npm 安装 OpenClaw（openclaw）、引导配置 AI 模型与身份信息、测试 API、可选自动启动 Gateway 并打开配置菜单
  2. 配置菜单（config-menu.sh）：交互式配置 AI 模型、消息渠道（Telegram、Discord、WhatsApp、飞书等）、高级设置与更新
  3. 文档与最佳实践：README 内含系统要求、快速开始、多模型/多渠道配置说明、安全建议与常见问题

部署完成后，OpenClaw Gateway 以后台服务形式运行，用户在 Telegram、Discord 等渠道与同一套 AI 能力对话，并享受持久记忆、技能系统等能力。

项目解决的核心问题：

  • OpenClaw 功能强但初次部署步骤多，容易在环境、配置上卡住
  • 需要一处汇总「多模型、多渠道」的配置指引与可执行脚本
  • 希望有「装完即用」的体验，并保留后续通过菜单或桌面端做细调

面向的用户群体：

  • 想快速在自有机器上跑起 OpenClaw 的用户（个人或小团队）
  • 需要对接 Telegram、Discord、飞书、WhatsApp 等渠道的开发者或运营
  • 偏好图形界面的用户（可搭配 OpenClaw Manager 桌面版）

作者/团队介绍

  • 维护者：miaoxworld（GitHub），同时维护 OpenClaw Manager 桌面管理工具（Tauri 2.0 + React + TypeScript + Rust）
  • 上游项目：OpenClaw 主仓库 openclaw/openclaw
  • 项目创建时间：2026 年 1 月（README 更新日志 v1.0.0 2026-01-29；GitHub 显示仓库创建于 2026-01-29）

项目数据

  • ⭐ 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从零手动部署 OpenClaw仅用各渠道官方 Bot + API
部署速度一条命令 + 引导配置需自行查文档、配环境无统一网关与记忆
多模型/多渠道一套网关统一配置同左，但配置靠手需每个渠道单独对接
持久记忆与技能OpenClaw 内置同左通常无或需自建
图形管理可选 OpenClaw Manager同左视产品而定

为什么选择 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

项目地址与资源

官方资源

相关资源

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

适用人群

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

欢迎来我中的个人主页找到更多有用的知识和有趣的产品

avatar
文章
阅读
粉丝