OpenClaw 安装指南

发表于 | 分类于
字数统计: 716 | 阅读时长 ≈ 2

OpenClaw 是一个强大的 AI Agent 框架，可以将 AI 能力接入 WhatsApp、Telegram、Discord、Slack 等多种即时通讯平台。本文记录了从零开始安装和配置 OpenClaw 的完整流程。

环境准备

安装 OpenClaw 之前，需要确保本地已有以下环境：

  • Node.js >= 18.x（推荐使用 LTS 版本）
  • npm >= 9.x
  • 稳定的网络连接（需要访问 npm 源以及 AI 模型 API）

可以通过以下命令检查版本：

1
2
node -v
npm -v

安装 OpenClaw

使用 npm 全局安装最新版本：

1
npm install -g openclaw@latest

安装完成后，验证是否安装成功：

1
openclaw --version

初始化配置

运行交互式引导向导，完成初始设置：

1
openclaw onboard

向导会引导你完成以下配置：

  • 选择 AI 模型（OpenAI、Claude、Gemini 等）
  • 配置 API Key
  • 选择接入的通讯渠道
  • 初始化工作区目录

如果希望以后台守护进程方式运行，可以加上参数：

1
openclaw onboarding --install-daemon

配置 AI 模型

查看当前支持的模型列表：

1
openclaw models list

设置默认模型：

1
openclaw models set <model-name>

配置模型的 API 认证信息：

1
openclaw models auth

启动网关服务

OpenClaw 通过 WebSocket 网关来对接各平台渠道，启动网关：

1
openclaw gateway start

其他常用网关命令：

1
2
3
openclaw gateway stop      # 停止网关
openclaw gateway restart   # 重启网关
openclaw gateway           # 查看网关状态

接入通讯渠道

以 WhatsApp 为例，添加渠道：

1
openclaw channels add --whatsapp

执行后会弹出二维码，用手机 WhatsApp 扫码配对即可。其他平台同理：

1
2
3
openclaw channels add --telegram
openclaw channels add --discord
openclaw channels add --slack

添加后可以检查渠道状态：

1
openclaw channels status --probe

工作区文件说明

OpenClaw 的工作区默认位于 ~/.OPENCLAW/WORKSPACE，包含以下核心配置文件：

文件 作用
AGENTS.md 定义 Agent 的指令与行为
SOUL.md 设定 AI 的人格与语气风格
USER.md 记录用户偏好
IDENTITY.md 设置 Agent 的名称与身份
MEMORY.md 长期记忆存储
BOOT.md 启动时执行的初始化内容

健康检查

如果遇到问题，可以运行诊断命令，OpenClaw 会自动检测常见错误并提供修复建议：

1
2
3
4
openclaw doctor

# 深度诊断
openclaw doctor --deep

常见问题排查

  • 没有收到私信回复 → 执行 PAIRING LIST 并确认 APPROVE
  • 群组中 Bot 没有响应 → 检查 MENTIONPATTERNS CONFIG
  • 网关意外关闭 → 执行 openclaw doctor --deep
  • 记忆功能异常 → 执行 openclaw memory index 重建索引

总结

OpenClaw 的安装流程整体比较顺滑，核心就是三步：全局安装 → 执行 onboard 初始化 → 启动网关接入渠道。配置完成后，AI Agent 就可以在你日常使用的即时通讯平台上运行，极大地扩展了 AI 的使用场景。

更多命令可以参考：OpenClaw 命令速查表

内容由 AI 生成，仅供参考