OpenClaw 快速安装与使用指南

OpenClaw 是一款强大的 AI 代理网关工具，支持 WhatsApp、Telegram、Discord、iMessage 等主流通讯渠道，让你可以通过手机随时与 AI 代理交互。本文将带你从零开始，快速完成安装配置并开始使用。

系统要求

• Node.js 22+（安装脚本会自动安装）
• 操作系统：macOS、Linux 或 Windows
• ⚠️ Windows 用户强烈建议使用 WSL2（Windows Subsystem for Linux）

一、快速安装

方式一：安装脚本（推荐）

一行命令搞定 Node 检测、安装和初始配置：

macOS / Linux / WSL2：

curl -fsSL https://clawd.org.cn/install.sh | bash

Windows (PowerShell)：

iwr -useb https://clawd.org.cn/install.ps1 | iex

如果只想安装 CLI 而跳过初始配置向导：

# macOS / Linux
curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --no-onboard

# Windows
& ([scriptblock]::Create((iwr -useb https://clawd.org.cn/install.ps1))) -NoOnboard

方式二：npm / pnpm（手动安装）

如果你已有 Node 22+：

使用 npm：

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

遇到 sharp 构建错误？尝试：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw-cn@latest

使用 pnpm：

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

方式三：从源码构建

适合开发者和贡献者：

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

二、引导配置

运行 openclaw-cn onboard 进入交互式引导向导，它会帮你完成：

1. 模型配置 — 设置 AI 模型（支持 Anthropic Claude、OpenAI、Gemini 等）
2. 工作区设置 — 创建代理工作目录（默认 ~/clawd）
3. 网关配置 — 设置端口（默认 18789）、认证 Token 等
4. 频道连接 — 绑定 WhatsApp、Telegram、Discord 等
5. 守护进程安装 — 注册为系统服务实现后台运行
6. 技能安装 — 从 ClawdHub 安装推荐的技能包

配置完成后，运行 openclaw-cn configure 可随时修改设置。

三、启动网关

网关是 OpenClaw 的核心进程，管理所有频道连接和控制平面。

启动网关

openclaw-cn gateway --port 18789

常用选项

• --verbose — 显示完整调试日志
• --force — 端口被占用时强制启动
• openclaw-cn gateway status — 查看网关运行状态

如果安装了系统服务，网关会自动在后台运行。

验证安装

openclaw-cn doctor     # 检查配置问题
openclaw-cn status     # 网关状态概览
openclaw-cn status --all  # 完整诊断信息
openclaw-cn dashboard  # 打开浏览器管理界面

四、连接频道

WhatsApp

openclaw-cn channels login

执行后会显示二维码，用需要绑定的手机扫描即可完成配对。

Telegram

通过 BotFather 创建机器人，获取 Token 后在配置中填入。

其他频道

支持 Discord、iMessage、Signal、Slack、飞书、钉钉等。详细配置见官方文档。

五、配置代理工作区

OpenClaw 的代理工作区默认位于 ~/clawd，核心文件包括：

推荐将工作区设为私有 Git 仓库，方便备份和迁移：

cd ~/clawd
git init
git add .
git commit -m "初始化代理工作区"

六、配置示例

编辑 ~/.openclaw/openclaw.json：

{
  "logging": { "level": "info" },
  "agent": {
    "model": "anthropic/claude-sonnet-4-20250514",
    "workspace": "~/clawd",
    "timeoutSeconds": 1800
  },
  "channels": {
    "whatsapp": {
      "allowFrom": ["+8612345678901"],
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

安全建议

• channels.whatsapp.allowFrom 一定要设置白名单
• 为助手使用专用手机号码而非个人号
• 群聊推荐开启 requireMention 防打扰

七、使用技巧

发送测试消息

openclaw-cn message send --target +8612345678901 --message "你好，OpenClaw！"

技能安装

clawdhub install <skill-name>  # 安装技能
clawdhub update --all          # 更新所有技能

定时任务（Cron）

openclaw-cn cron add \
  --name "每日简报" \
  --cron "0 9 * * *" \
  --session main \
  --system-event "生成今日简报"

会话管理

• /new 或 /reset — 开启新会话
• /compact [指令] — 压缩会话上下文释放预算

控制 UI

浏览器访问 http://127.0.0.1:18789/ 即可打开管理面板。

八、常见问题

找不到 openclaw-cn 命令

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

确保输出路径在 $PATH 中。将以下内容加入 ~/.zshrc 或 ~/.bashrc：

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

更新 OpenClaw

npm update -g openclaw-cn
openclaw-cn gateway restart

卸载

openclaw-cn uninstall

了解更多

• 官方文档：https://clawd.org.cn
• 技能市场（ClawdHub）：https://clawdhub.com
• GitHub 仓库：https://github.com/jiulingyun/openclaw-cn