OpenClaw 安装与配置指南

TLDR：OpenClaw 是一个私人 AI 助手部署工具，支持多平台、多模型。本指南教你如何安装并接入 BUZZ AI。

什么是 OpenClaw

OpenClaw 是一个开源的私人 AI 助手部署工具，让你可以在自己的服务器上运行 AI 助手，并通过多种渠道（Telegram、Discord、微信等）与之交互。

核心功能

多模型支持：Claude、GPT、Gemini、Ollama 等

多渠道接入：Telegram、Discord、WhatsApp、Slack、微信、iMessage、飞书

持久记忆：跨对话、跨平台的上下文记忆

主动推送：定时提醒、晨报等主动消息

技能系统：通过 Markdown 文件定义自定义技能

远程控制：执行命令、读写文件（需谨慎使用）

为什么选择 OpenClaw

✅ 完全私有化部署，数据安全

✅ 支持自定义 API 地址（完美适配 BUZZ AI）

✅ 一键安装，配置简单

✅ 开源免费

官方仓库：https://github.com/miaoxworld/OpenClawInstaller

环境要求

系统要求

操作系统：

macOS 12+

Ubuntu 20.04+

Debian 11+

CentOS 8+

Node.js：v22 或更高版本

内存：最低 2GB，推荐 4GB+

磁盘：最低 1GB 可用空间

前置准备

BUZZ AI API Key：在 https://buzzai.cc 注册并获取

消息渠道：至少准备一个（如 Telegram Bot Token）

服务器：建议使用专用服务器或虚拟机，不要在主工作电脑部署

快速安装

一键安装脚本

安装脚本会自动完成：

检测系统环境

安装 Node.js（如果需要）

安装 OpenClaw

引导完成基础配置

测试 API 连接

启动服务

安装过程

安装过程中会提示你输入：

AI 模型选择（选择 Anthropic Claude）

API 地址（输入 https://buzzai.cc/v1）

API Key（输入你的 BUZZ AI Token）

消息渠道配置（如 Telegram Bot Token）

配置 BUZZ AI

方式一：安装时配置

在安装过程中：

选择 AI 模型：Anthropic Claude

输入自定义 API 地址：https://buzzai.cc/v1

输入 API Key：sk-your-api-key

选择模型：claude-sonnet-4-6-20250514

方式二：安装后配置

如果需要修改配置：

编辑配置文件 ~/.openclaw/env：

保存后重启服务：

配置消息渠道

Telegram（推荐）

步骤：

与 @BotFather 对话创建机器人

获取 Bot Token

与 @userinfobot 对话获取你的 User ID

运行配置：

添加配置：

重启服务并与机器人对话测试

Discord

步骤：

在 Discord Developer Portal 创建应用

创建 Bot 并获取 Token

启用 Message Content Intent

获取 Channel ID

配置：

步骤：

运行配置菜单选择 WhatsApp

扫描二维码登录

无需 Business API，使用个人账号即可

服务管理

启动服务

停止服务

重启服务

查看日志

健康检查

使用 OpenClaw

基本对话

直接在配置的渠道（如 Telegram）中发送消息，OpenClaw 会自动回复。

技能系统

OpenClaw 支持通过 Markdown 文件定义技能：

创建技能文件：~/.openclaw/skills/my-skill.md

定义技能内容：

重启服务加载技能

主动推送

配置定时任务：

添加：

数据管理

导出对话

清理记忆

备份数据

或手动备份：

常见问题

Node.js 版本过低

macOS：

Ubuntu/Debian：

Telegram 机器人无响应

检查清单：

Bot Token 是否正确

User ID 是否在 allowed_users 列表中

网络连接是否正常（可能需要代理）

服务是否正在运行：openclaw health

API 调用失败

检查：

API Key 是否有效

Base URL 是否正确：https://buzzai.cc/v1

账户余额是否充足

查看日志：openclaw logs --follow

更新到最新版本

安全建议

⚠️ 重要：OpenClaw 具有强大的功能，请注意安全。

部署安全

✅ 使用专用服务器或虚拟机部署

✅ 不要在主工作电脑上运行

✅ 定期备份数据

❌ 不要暴露配置文件

功能安全

✅ 禁用危险功能（shell 命令、文件访问）

✅ 限制允许的用户列表

✅ 定期轮换 API Key

❌ 不要给予过高权限

配置示例

在 ~/.openclaw/openclaw.json 中：

{
  "security": {
    "enableShellCommands": false,
    "enableFileAccess": false,
    "allowedUsers": ["your_user_id"]
  }
}

进阶配置

多模型切换

OpenClaw 支持配置多个模型：

自定义提示词

编辑 ~/.openclaw/prompts/system.md 自定义系统提示词。

故障排查

诊断工具

会检查：

Node.js 版本

配置文件完整性

API 连接状态

服务运行状态

查看详细日志

官方资源：

GitHub：https://github.com/miaoxworld/OpenClawInstaller

BUZZ AI：https://buzzai.cc

QQ 群：574897157

OpenClaw 安装指南

OpenClaw 安装与配置指南#

什么是 OpenClaw#

核心功能#

为什么选择 OpenClaw#

环境要求#

系统要求#

前置准备#

快速安装#

一键安装脚本#

安装过程#

配置 BUZZ AI#

方式一：安装时配置#

方式二：安装后配置#

配置消息渠道#

Telegram（推荐）#

Discord#

WhatsApp#

服务管理#

启动服务#

停止服务#

重启服务#

查看日志#

健康检查#

使用 OpenClaw#

基本对话#

技能系统#

主动推送#

数据管理#

导出对话#

清理记忆#

备份数据#

常见问题#

Node.js 版本过低#

Telegram 机器人无响应#

API 调用失败#

更新到最新版本#

安全建议#

部署安全#

功能安全#

配置示例#

进阶配置#

多模型切换#

自定义提示词#

故障排查#

诊断工具#

查看详细日志#

OpenClaw 安装与配置指南

什么是 OpenClaw

核心功能

为什么选择 OpenClaw

环境要求

系统要求

前置准备

快速安装

一键安装脚本

安装过程

配置 BUZZ AI

方式一：安装时配置

方式二：安装后配置

配置消息渠道

Telegram（推荐）

Discord

WhatsApp

服务管理

启动服务

停止服务

重启服务

查看日志

健康检查

使用 OpenClaw

基本对话

技能系统

主动推送

数据管理

导出对话

清理记忆

备份数据

常见问题

Node.js 版本过低

Telegram 机器人无响应

API 调用失败

更新到最新版本

安全建议

部署安全

功能安全

配置示例

进阶配置

多模型切换

自定义提示词

故障排查

诊断工具

查看详细日志