OpenClaw搭建完全指南：从零开始部署你的AI智能体网关

小橙子学AI
0 阅读7分钟

作者：小橙子 🍊  
日期：2026年3月10日  
标签：AI, 智能体, OpenClaw, 网关, 部署, 教程

引言

在当今AI技术飞速发展的时代，如何将智能体无缝集成到我们的日常通讯工具中成为了一个重要课题。OpenClaw应运而生，它是一个多渠道AI智能体Gateway网关，支持WhatsApp、Telegram、Discord、iMessage等主流通讯平台，让你能够在任何操作系统上运行自己的AI助手。

本文将带你从零开始，一步步完成OpenClaw的搭建和部署，让你也能拥有自己的智能体网关。

什么是OpenClaw？

OpenClaw是一个开源的AI智能体网关系统，它通过单个Gateway网关进程将聊天应用连接到Pi等编程智能体。简单来说，它就像是一个"翻译官"，让不同的通讯工具都能与AI智能体进行对话。

核心特性：

  • 多渠道支持：WhatsApp、Telegram、Discord、iMessage等
  • 插件体系：可通过扩展包添加更多渠道（如Mattermost）
  • 多智能体路由：按智能体、工作区或发送者隔离会话
  • 媒体支持：发送和接收图片、音频和文档
  • Web控制界面：浏览器仪表板，用于聊天、配置和会话管理
  • 移动节点：支持iOS和Android设备配对

环境准备

在开始安装之前，请确保你的系统满足以下要求：

系统要求

  • 操作系统：macOS、Linux或Windows（通过WSL2）
  • Node.js：版本>=22（必需）
  • 包管理器：npm或pnpm（推荐pnpm）
  • 磁盘空间：至少1GB可用空间

Windows用户注意事项

强烈推荐使用WSL2（Ubuntu），因为原生Windows环境可能存在兼容性问题。如果必须使用Windows，请先安装WSL2，然后在WSL内运行Linux步骤。

可选工具

  • Brave Search API密钥（用于网页搜索功能）
  • Xcode Command Line Tools（macOS用户，如需构建应用）

安装OpenClaw

OpenClaw提供了多种安装方式，我们推荐使用官方安装脚本，这是最简单快捷的方法。

方法一：使用安装脚本（推荐）

对于macOS/Linux用户：

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

对于Windows用户（PowerShell）：

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

安装脚本会自动完成以下操作：

  1. 检查系统环境
  2. 安装Node.js（如需要）
  3. 全局安装OpenClaw CLI
  4. 运行新手引导向导

方法二：全局安装（手动）

如果你已经有Node.js环境，可以使用npm或pnpm进行安装：

# 使用npm  
npm install -g openclaw@latest

# 使用pnpm  
pnpm add -g openclaw@latest

注意：如果使用pnpm，安装后可能需要批准构建脚本：

pnpm approve-builds -g  
pnpm add -g openclaw@latest  # 重新运行以执行postinstall脚本

方法三：从源代码安装（开发者）

如果你想参与开发或使用最新版本：

git clone https://github.com/openclaw/openclaw.git  
cd openclaw  
pnpm install  
pnpm ui:build  # 首次运行时自动安装UI依赖  
pnpm build  
openclaw onboard --install-daemon

配置和初始化

安装完成后，我们需要运行新手引导向导来配置OpenClaw：

openclaw onboard --install-daemon

引导向导选项

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

  1. 本地 vs 远程Gateway网关：选择部署方式
  2. 认证设置：
    - OpenAI Code (Codex) 订阅（OAuth）
    - API密钥（推荐用于Anthropic Claude）
    - 也支持claude setup-token
  3. 渠道配置：
    - WhatsApp QR登录
    - Telegram/Discord机器人令牌
    - Mattermost插件令牌等
  4. 守护进程安装：
    - macOS：launchd
    - Linux：systemd
    - WSL2：systemd
  5. Gateway网关令牌：向导默认生成一个并存储

重要提示

  • 凭证存储位置：
    - OAuth凭证：~/.openclaw/credentials/oauth.json
    - 认证配置文件：~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • 无头服务器部署：建议先在普通机器上完成OAuth，然后将oauth.json复制到Gateway网关主机

启动Gateway网关

配置完成后，Gateway网关应该已经在运行。你可以通过以下命令检查状态：

openclaw gateway status

如果需要手动启动（前台运行）：

openclaw gateway --port 18789 --verbose

访问控制界面

Gateway网关启动后，你可以通过浏览器访问控制界面：

Bun运行时警告

如果使用WhatsApp或Telegram渠道，请使用Node运行时，因为Bun与这些渠道存在已知的兼容性问题。

连接通讯渠道

WhatsApp连接

openclaw channels login

执行命令后，会显示一个QR码。通过WhatsApp → 设置 → 链接设备进行扫描即可。

Telegram连接

  1. 通过@BotFather创建机器人
  2. 获取机器人令牌
  3. 在OpenClaw配置中添加令牌

Discord连接

  1. 在Discord开发者门户创建应用
  2. 获取机器人令牌
  3. 在OpenClaw配置中添加令牌

安全配对与批准

OpenClaw默认采用安全配对机制，未知的私信会收到一个短代码，需要在批准后才能正常通信。

查看待批准的配对请求：

openclaw pairing list whatsapp

批准配对：

openclaw pairing approve whatsapp <code>

验证安装

完成所有配置后，可以通过以下命令验证安装是否成功：

# 检查系统状态  
openclaw status

# 健康检查  
openclaw health

# 安全审计  
openclaw security audit --deep

# 发送测试消息  
openclaw message send --target +15555550123 --message "Hello from OpenClaw"

常见问题与解决方案

1. 找不到openclaw命令

如果安装后无法找到openclaw命令，可能是PATH配置问题：

# 检查Node.js和npm版本  
node -v  
npm -v

# 查看全局安装路径  
npm prefix -g

# 将全局bin目录添加到PATH  
export PATH="$(npm prefix -g)/bin:$PATH"

将上述export命令添加到你的shell配置文件（如~/.bashrc或~/.zshrc）中。

2. sharp模块安装失败

如果遇到sharp模块构建问题：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

3. Gateway网关无法启动

检查端口是否被占用：

# 查看18789端口使用情况  
lsof -i :18789

# 或使用netstat  
netstat -tulpn | grep 18789

4. 渠道连接失败

  • WhatsApp：确保使用Node运行时，而不是Bun
  • Telegram：检查机器人令牌是否正确，确保机器人已启用
  • Discord：确认机器人已添加到服务器，且拥有必要权限

高级功能

远程访问配置

如果你想从外部网络访问OpenClaw，可以配置远程访问：

# 使用Tailscale  
openclaw gateway --tailscale

# 或配置SSH隧道  
ssh -L 18789:localhost:18789 user@your-server

移动设备配对

OpenClaw支持iOS和Android设备配对，实现更多功能：

  1. 在移动设备上安装OpenClaw节点应用
  2. 通过配对码连接设备
  3. 启用Canvas、相机、语音等功能

技能库管理

OpenClaw拥有丰富的技能库，可以通过以下命令管理：

# 搜索技能  
openclaw skills search <关键词>

# 安装技能  
openclaw skills install <技能名>

# 更新技能  
openclaw skills update

总结

OpenClaw作为一个功能强大的AI智能体网关，为开发者和管理员提供了一个完整的解决方案，让AI智能体能够无缝集成到日常通讯工具中。通过本文的步骤，你应该已经成功搭建了自己的OpenClaw环境。

主要优势：

  1. 部署简单：提供一键安装脚本，降低部署门槛
  2. 多渠道支持：覆盖主流通讯工具，满足不同场景需求
  3. 安全可靠：采用配对机制，确保通信安全
  4. 扩展性强：支持插件和技能库，功能可无限扩展
  5. 社区活跃：开源项目，持续更新和维护

下一步建议

  1. 探索技能库：安装更多实用技能，扩展AI助手能力
  2. 配置自动化：设置定时任务和自动化流程
  3. 集成其他服务：连接数据库、API服务等
  4. 性能优化：根据使用场景调整配置参数
  5. 贡献代码：参与开源项目，共同完善OpenClaw

资源链接

希望这篇指南能帮助你顺利搭建OpenClaw环境。如果在使用过程中遇到任何问题，欢迎在评论区留言交流，我会尽力为大家解答。

avatar
文章
阅读
粉丝