OpenClaw 全平台安装实战

✅ 最推荐：官方安装器

macOS / Linux：

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

Windows（PowerShell）：

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

安装器会自动安装 CLI 并引导你完成新手配置。更多细节：https://docs.openclaw.ai/install

✅ 系统要求

• • Node.js >= 22
• • macOS / Linux / Windows（推荐 WSL2）
• • 从源码构建需要 pnpm

✅ VPS 部署建议

任意 Linux VPS 可用，推荐 1-2 核 + 2GB 内存：

• • VPS 指南：https://docs.openclaw.ai/vps
• • 远程访问：https://docs.openclaw.ai/gateway/remote

02｜三条命令把 Gateway 跑起来

openclaw onboard --install-daemonopenclaw channels loginopenclaw gateway --port 18789

完成后打开控制台：

• • 本地地址：http://127.0.0.1:18789/

快速开始：https://docs.openclaw.ai/start/quickstart

03｜基础排障：先记住 5 个命令

openclaw status           # 一键健康检查openclaw gateway status   # 查看服务是否运行openclaw logs --follow    # 实时日志openclaw dashboard        # 打开带 token 的控制台链接openclaw doctor           # 修复常见问题

04｜常用通道接入

下面给出可直接照做的通道配置步骤。

A. Telegram（最快跑通）

Step 1：创建机器人并拿到 Token

• • 在 Telegram 搜索 @BotFather
• • 发送 /newbot 并按提示创建
• • 记下 Bot Token

Step 2：在 OpenClaw 配置中启用

openclaw channels add telegram --token <BOT_TOKEN>

Step 3：测试

给机器人发送一条消息，能收到回复即完成。

文档：https://docs.openclaw.ai/channels/telegram

B. 微信（ClawBot 快速接入）

你可以用 微信 ClawBot 与 OpenClaw 直接收发消息：

Step 1：在运行 OpenClaw 的设备安装插件并开始连接

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

Step 2：扫码绑定

执行命令后会弹出二维码，使用微信扫码，启用 ClawBot 插件后即可在微信中使用。

C. WhatsApp（二维码登录）

Step 1：登录配对

openclaw channels login

扫描二维码完成配对。

Step 2：允许你自己的号码

在 ~/.openclaw/openclaw.json 中添加允许列表：

{  channels: {    whatsapp: {      allowFrom: ["+86你的手机号"],    },  },}

Step 3：测试

给自己的 WhatsApp 发消息测试即可。

文档：https://docs.openclaw.ai/channels/whatsapp

D. Discord / Slack / Signal（按文档配置）

• • Discord：创建 Bot → 邀请进服务器 → 填 Token
• • Slack：创建 App → Bot Token → 设置事件订阅
• • Signal：使用 signal-cli 注册并配置

总文档入口：https://docs.openclaw.ai/channels

05｜Skills安装

PDF 处理、Excel 数据处理、网页自动化。下面给出安装与使用方式。

安装统一使用 ClawHub：

clawhub install <skill-slug>clawhub update --all

Skills 文档：https://docs.openclaw.ai/tools/skills

1) PDF 处理（pdf）

用途：合并、拆分、提取页面、OCR 等。

安装：

clawhub install pdf

使用示例：

• • “把这个 PDF 里第 5-20 页提取出来”
• • “把三份合同 PDF 合并成一个”

2) Excel 数据处理（xlsx）

用途：合并表格、去重、统计分析。

安装：

clawhub install xlsx

使用示例：

• • “把这 5 个 Excel 表合并，去掉重复数据”
• • “分析这份销售数据，找出增长最快的品类”

3) 网页自动化（webapp-testing）

用途：抓取网页、自动填写表单、定时截图。

安装：

clawhub install webapp-testing

使用示例：

• • “抓取这个页面所有商品名称和价格”
• • “自动填写报名表并提交”

07｜常见问题速查

1）安装后找不到 openclaw

export PATH="$(npm prefix -g)/bin:$PATH"

2）控制台显示 Unauthorized

运行：

openclaw dashboard

它会生成带 token 的链接。

3）Gateway 没回复 / 收不到消息

先检查：

openclaw statusopenclaw channels statusopenclaw logs --follow

4）安装卡住 / 失败

用 verbose 模式重跑：

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

FAQ：https://docs.openclaw.ai/help/faq