Administrator
发布于 2026-05-26 / 0 阅读

OpenClaw 安装指南

OpenClaw 安装指南

OpenClaw 是一款开源的个人 AI 助手,可在任何操作系统上运行,支持多消息平台接入。与 Claude Code 和 Hermes Agent 类似,它是一个功能强大的自主 AI 代理框架,支持工具调用、多代理协作和全面的 CLI 管理。

系统要求

  • Node.js 24(推荐)或 Node.js 22.19+
  • 操作系统:macOS、Linux 或 Windows(WSL2 更稳定)
  • 内存:建议 4GB+

一键安装(推荐)

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

安装脚本会自动检测操作系统、安装 Node.js(如果需要)、安装 OpenClaw 并启动引导配置。

Windows(PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

跳过引导配置

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

验证安装

openclaw --version          # 确认 CLI 可用
openclaw doctor             # 检查配置问题
openclaw gateway status     # 验证网关是否运行

使用包管理器安装(备选)

如果已管理 Node.js 环境,可以使用 npm、pnpm 或 bun:

npm

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun

bun add -g openclaw@latest
openclaw onboard --install-daemon

从源码安装

适合贡献者或希望运行本地开发版本的用户:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

将 Gateway 安装为系统服务

安装后,建议将 OpenClaw 的 Gateway 守护进程设为系统服务以实现开机自启:

  • macOS:LaunchAgent
  • Linux/WSL2:systemd 用户服务
  • Windows:计划任务(被拒绝时回退到启动文件夹)

初始配置

运行 openclaw onboard 进入引导流程,它将帮助配置:

  1. 模型和认证 — 支持 OpenAI、Anthropic Claude、MiniMax、GLM、Moonshot 等
  2. 消息通道 — Telegram、Discord、WhatsApp、Signal、iMessage 等
  3. 系统守护进程 — 安装开机自启服务

核心功能

  • 多平台消息网关 — 同时在多个平台运行
  • 多代理协作 — SubAgent 和 Agent Team 实现任务并行
  • 技能系统 — 可安装和管理扩展技能
  • 持久记忆 — 跨会话的记忆管理
  • 插件生态 — 丰富的插件市场
  • Cron 调度 — 定时任务自动化
  • Webhook — 事件驱动的自动化触发

常用 CLI 命令

openclaw setup                    # 初始配置
openclaw onboard                  # 引导配置
openclaw model                    # 查看/切换模型
openclaw channels list            # 查看已配置的消息通道
openclaw skills list              # 查看已安装技能
openclaw memory status            # 查看记忆状态
openclaw plugins list             # 查看已安装插件
openclaw backup create            # 创建备份
openclaw doctor                   # 系统健康检查
openclaw update                   # 更新到最新版本

详细文档

  • 官方文档:https://docs.openclaw.ai/
  • GitHub:https://github.com/openclaw/openclaw
  • 安装指南:https://docs.openclaw.ai/install

评论