前言

OpenClaw 是一款强大的 AI 助手框架,可以帮助你快速搭建自己的 AI 助手服务。它支持多种渠道接入(飞书、Telegram、Discord 等),并且可以连接多种 AI 提供商。

本文将详细介绍如何在本地电脑上部署 OpenClaw。

环境要求

  • 操作系统:macOS、Linux 或 Windows(推荐 WSL2)
  • Node.js:Node 24(推荐)或 Node 22 LTS
  • pnpm:如果你选择源码安装

💡 Windows 用户建议使用 WSL2,可以避免很多兼容性问题

安装方式一:安装脚本(推荐)

这是最简单的方式,脚本会自动检测并安装 Node.js。

macOS / Linux / WSL2

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

Windows (PowerShell)

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

运行完成后,脚本会自动启动引导配置,按照提示完成设置即可。

如果不想自动引导,可以加参数:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

安装方式二:npm 安装

如果你已经安装了 Node.js,可以使用 npm 安装:

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

pnpm 安装

pnpm add -g openclaw@latest
pnpm approve-builds -g   # 批准构建脚本
openclaw onboard --install-daemon

安装方式三:源码安装

适合开发者或需要深度定制的朋友:

# 克隆项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install
pnpm ui:build
pnpm build

# 链接命令
pnpm link --global

# 启动引导
openclaw onboard --install-daemon

安装验证

安装完成后,运行以下命令验证:

openclaw doctor         # 检查配置问题
openclaw status         # 查看网关状态
openclaw dashboard      # 打开浏览器管理界面

快速入门

首次运行 openclawopenclaw dashboard 会自动打开浏览器配置页面。

主要配置步骤:

  1. 选择要接入的 AI 提供商(如 OpenAI、Claude、Minimax 等)
  2. 配置 API Key
  3. 选择要接入的渠道(飞书、Telegram、Discord 等)
  4. 完成配置

常用命令

命令 说明
openclaw status 查看服务状态
openclaw start 启动服务
openclaw stop 停止服务
openclaw restart 重启服务
openclaw logs 查看日志
openclaw configure 重新配置

常见问题

1. openclaw 命令找不到

检查 Node.js 和 npm 是否正确安装:

node -v
npm -v
npm prefix -g

确保 npm 全局 bin 目录在 PATH 中。

2. Windows 下运行报错

建议使用 WSL2,或者在 PowerShell 中以管理员身份运行。

3. 如何更新版本

npm update -g openclaw@latest

总结

OpenClaw 部署非常简单,几分钟就能搭建完成。它提供了丰富的渠道接入能力,是个人或团队搭建 AI 助手的优秀选择。

如果大家在部署过程中遇到问题,欢迎在评论区留言讨论!


参考链接

  • 官方文档:https://docs.openclaw.ai
  • GitHub:https://github.com/openclaw/openclaw
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐