OpenClaw 的安装和配置指南

什么是 OpenClaw？

OpenClaw 是一个强大的 AI 助手框架，基于 Claude/ChatGPT 等大语言模型构建。它可以帮助用户完成各种任务，如网页搜索、浏览器自动化、文件管理、多平台消息集成等。

简单来说，OpenClaw 就像一个超级助手，你可以用它来：

通过 Telegram、Discord 等聊天软件跟它对话
让它帮你搜索信息、读写文件
自动化浏览器操作
管理服务器、运行代码

准备工作

在开始安装 OpenClaw 之前，你需要准备以下内容：

1. 服务器要求

操作系统：Ubuntu 20.04+ / Debian 11+
配置：1核 1GB 内存以上
硬盘：至少 5GB 可用空间

2. 必备软件

Node.js 18+（LTS 版本）
npm 或 pnpm
Git（可选）

3. 账号准备

Telegram Bot Token（如果要用 Telegram 聊天）
API Keys（如果要用付费模型）

安装步骤

第一步：安装 Node.js

OpenClaw 基于 Node.js 运行，首先需要安装 Node.js 环境。

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

安装完成后验证：

node --version  # 应该显示 v18.x.x
npm --version    # 应该显示 9.x.x 或更高

第二步：安装 OpenClaw

使用 npm 全局安装 OpenClaw：

npm install -g openclaw

或者使用 pnpm：

npm install -g pnpm
pnpm install -g openclaw

第三步：初始化配置

运行初始化命令：

openclaw init

这会创建配置文件目录 ~/.openclaw/，并生成默认配置文件。

第四步：配置渠道

编辑配置文件 ~/.openclaw/openclaw.json，添加 Telegram 渠道：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的BOT_TOKEN"
    }
  }
}

如何获取 Telegram Bot Token：

在 Telegram 搜索 @BotFather
发送 /newbot 创建新机器人
复制 BotFather 给你的 Token

第五步：启动服务

启动 OpenClaw 网关：

openclaw gateway start

查看状态：

openclaw status

配置说明

配置文件结构

OpenClaw 的主要配置文件位于 ~/.openclaw/openclaw.json，包含以下部分：

channels – 消息渠道配置（Telegram、Discord 等）
models – AI 模型配置
tools – 工具配置
skills – 技能配置
agents – 代理配置

常用配置项

{
  "gateway": {
    "host": "0.0.0.0",
    "port": 18789
  },
  "session": {
    "defaultModel": "claude-3-opus"
  }
}

常用命令

命令	说明
openclaw status	查看运行状态
openclaw gateway start	启动网关
openclaw gateway stop	停止网关
openclaw gateway restart	重启网关
openclaw configure	运行配置向导
openclaw doctor	诊断问题

进阶使用

配置 HTTPS

生产环境建议使用 HTTPS，可以使用 Caddy 自动配置：

# 安装 Caddy
apt install -y caddy

# 配置反向代理
# 编辑 /etc/caddy/Caddyfile

安装技能

OpenClaw 支持安装额外技能：

clawhub install skill-name

配置更多渠道

除了 Telegram，还可以配置：

Discord
WhatsApp
Slack
Web

常见问题

Q: 网关启动失败怎么办？

运行 openclaw doctor 检查问题。

Q: 如何升级 OpenClaw？

npm update -g openclaw

Q: 怎么查看日志？

journalctl -u openclaw -f

总结

OpenClaw 是一个功能强大的 AI 助手框架，安装配置相对简单。跟着本教程操作，你也可以快速搭建自己的 AI 助手！

有问题欢迎在评论区留言交流～