一、环境准备：Windows 通过 WSL 安装

1.1 安装 WSL

WSL（Windows Subsystem for Linux）在 Windows 上运行 Linux 环境。

# 安装默认 Ubuntu 发行版
wsl --install

# 安装指定发行版（推荐）
wsl --install -d Ubuntu-24.04

⚠️ 首次运行 wsl --install 会自动启用 WSL 功能并下载 Ubuntu，安装完成后需要重启电脑并设置账号密码。

1.2 启用 systemd

systemd 是 Linux 系统的服务管理器，OpenClaw 需要它来运行后台服务。

# 在 Ubuntu 终端中执行以下命令
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

# 验证是否启用成功
systemctl --user status

1.3 重启 WSL

在管理员 PowerShell 中执行：

wsl --shutdown

然后重新打开 Ubuntu 终端。

1.4 安装系统基础依赖

sudo apt update && sudo apt upgrade -y

1.5 安装 Node.js

OpenClaw 基于 Node.js 构建，需要 v22 及以上版本：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node --version

1.6 安装 OpenClaw

# 官方一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

1.7 初始化配置

# 运行新用户引导向导（推荐）
openclaw onboard --install-daemon

# 或者快速安装守护进程
openclaw install-daemon

二、网关管理

2.1 基础命令

2.2 打开控制面板

openclaw dashboard

这会在浏览器中打开 OpenClaw 的 Web 控制界面。

三、问题排查与自动修复

3.1 快速体检

openclaw status

3.2 检查网关

openclaw gateway status

3.3 查看日志

openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json

3.4 健康诊断

openclaw doctor
openclaw doctor --fix

3.5 权限问题

openclaw config set tools.profile full

四、Agent 管理

4.1 基础操作

openclaw agents list
openclaw agents add
openclaw agents add my-assistant
openclaw agents delete <agent-id>

4.2 频道绑定

openclaw agents bindings
openclaw agents bind --agent <id> --bind telegram:mybot

五、定时任务（Cron）

5.1 基础命令

openclaw cron list
openclaw cron add
openclaw cron run <job-id> --force
openclaw cron runs --id <job-id> --limit 10
openclaw cron disable <job-id>
openclaw cron enable <job-id>
openclaw cron rm <job-id>

5.2 示例：每天早上 9 点发邮件总结

openclaw cron add   --name "晨间日报"   --cron "0 9 * * *"   --message "总结未读邮件并发送到 Telegram"

六、浏览器控制

6.1 基础命令

openclaw browser status
openclaw browser start
openclaw browser open https://example.com
openclaw browser screenshot --out report.png
openclaw browser screenshot --full-page --out report.png
openclaw browser snapshot --format ai
openclaw browser tabs
openclaw browser close <targetId>

七、飞书集成

7.1 创建飞书应用

访问飞书开发者平台
创建企业自建应用
在应用中添加机器人

7.2 安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

7.3 配置飞书

openclaw channels add

按提示输入：

• App ID
• App Secret

7.4 重启网关

openclaw gateway restart

7.5 设置事件回调

添加事件：

• im.message.receive_v1
• im.message.message_sent_v1

配置回调 URL

7.6 权限配置

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "contact:user.base:readonly",
      "im:message.group_msg",
      "im:message:readonly",
      "im:message:update",
      "im:message:recall",
      "im:message.reactions:read",
      "docx:document:readonly",
      "drive:drive:readonly",
      "wiki:wiki:readonly",
      "bitable:app:readonly",
      "task:task:read",
      "contact:contact.base:readonly",
      "docx:document",
      "docx:document.block:convert",
      "drive:drive",
      "wiki:wiki",
      "bitable:app",
      "task:task:write"
    ],
    "user": []
  }
}

7.7 发布并开始使用

发布应用后，在飞书中搜索机器人并开始对话。
首次对话时机器人会发送 Pairing 请求，复制命令行到 OpenClaw 控制台执行完成配对。