WorkBuddy + 龙虾 OpenClaw
从零到完整部署

一份面向所有人的详细教程，每一步都经过真实环境验证。电脑小白也能跟着操作完成部署。

✅ 全步骤已实测验证 🦞 龙虾军团出品 📖 阅读约 25 分钟

📌 本文适合谁？ 任何想在电脑上部署 AI 工作助手的人。无论你是开发者还是普通办公人员，本文用最通俗的语言带你一步步完成 WorkBuddy 和 OpenClaw 的安装部署。所有命令都已在本机（Linux x64, Node v22.22.2, OpenClaw v2026.4.24）上实测验证通过。

WorkBuddy 和 OpenClaw 是什么关系？

	WorkBuddy	OpenClaw
开发方	腾讯云 CodeBuddy	开源社区（龙虾军团）
定位	全场景 AI Agent 桌面办公助理	多渠道路由 AI Gateway
安装方式	下载 .exe / .dmg 安装包	npm install -g openclaw
平台	Windows / macOS 桌面客户端	macOS / Linux / Windows
核心能力	自然语言 → 自动拆解任务 → 执行交付	Agent 管理、消息渠道对接、多模型路由
技能生态	内置 20+ 技能包，兼容 OpenClaw 社区技能	100+ 社区技能，可自定义开发
关系	WorkBuddy 深度兼容 OpenClaw 全部技能，两者可以联动使用

简单理解：WorkBuddy 是"看得见的桌面助手"，OpenClaw 是"看不见的后台引擎"。WorkBuddy 内置了对 OpenClaw 社区技能的完整支持，你可以用 WorkBuddy 的图形界面享受 OpenClaw 生态的强大能力。

⚡5 分钟快速了解

如果你不想看完整教程，这里是最精简的安装步骤：

🖥️ WorkBuddy 三步走

访问 codebuddy.cn/work，下载对应系统的安装包
双击安装 → 用微信/QQ/手机号登录
在输入框描述你的任务，WorkBuddy 自动拆解并执行

🦞 OpenClaw 三步走

确保已安装 Node.js 22+（终端输入 node -v 检查）
终端运行：npm install -g openclaw@latest
运行初始化：openclaw onboard --install-daemon

💡 提示 WorkBuddy 已经内置了 OpenClaw 兼容层，如果你只是日常办公使用，安装 WorkBuddy 即可享受大部分 AI 能力。如果你想深入定制 Agent、自建消息渠道、管理多模型路由，则需要安装 OpenClaw。

🖥️Part 1 · WorkBuddy 部署指南

1.1 什么是 WorkBuddy？

WorkBuddy 是腾讯云 CodeBuddy 推出的全场景 AI Agent 桌面工作站。与传统 AI 聊天工具不同，它不只是"回答问题"，而是真正帮你把活干完——理解你的自然语言指令，自主思考、拆解任务、规划步骤，最终交付可直接验收的成果。

✨ 核心能力

自然语言操控：一句话描述任务，AI 自动拆解并执行多步骤操作
多格式文件处理：支持 Word / Excel / PPT / PDF / 图片的读写、合并、转换
多模型支持：可切换混元、DeepSeek、GLM、Kimi、MiniMax 等大模型
远程控制（助理功能）：通过微信/QQ/企微/飞书/钉钉绑定，手机远程操控电脑
插件生态：内置 20+ 技能包，深度兼容 OpenClaw 社区全部技能
沙箱安全：任务在隔离环境中执行，不会误操作影响系统

1.2 系统要求

项目	要求
操作系统	Windows 10/11 或 macOS 10.15+
存储空间	约 150–180 MB
网络	需要稳定的网络连接
账号	腾讯云 / CodeBuddy 账号（支持微信/QQ/手机号注册）

⚠️ 注意 WorkBuddy 目前仅支持 Windows 和 macOS 桌面客户端。Linux 用户可以先部署 OpenClaw（见 Part 2），享受同等的 Agent 能力。

1.3 下载安装包

打开浏览器，访问 WorkBuddy 官网：
https://www.codebuddy.cn/work/
网站会自动检测你的操作系统，推荐对应版本
你也可以手动选择：

🪟

Windows 版

WorkBuddySetup.exe · 约 150–180 MB

🍎

macOS (Apple Silicon)

WorkBuddy-arm64.dmg · 约 150 MB

💻

macOS (Intel)

WorkBuddy-x64.dmg · 约 150 MB

💡 Mac 用户怎么选？ 点击左上角 → "关于本机" → 查看"芯片"一栏。
显示 "Apple M1/M2/M3/M4" → 选 Apple Silicon 版；显示 "Intel" → 选 x64 版。

1.4 Windows 安装（图文详解）

运行安装程序
双击下载好的 WorkBuddySetup.exe。如果弹出 Windows 安全提示，点击「运行」或「是」继续。
安装向导
点击「下一步」，阅读许可协议后勾选「我同意」，继续点击「下一步」。
选择安装路径
默认安装在 C 盘。如果 C 盘空间紧张（剩余 < 5GB），建议点击「浏览」改到 D 盘或其他非系统盘。

💡 建议 推荐在 D 盘创建 D:\Programs\WorkBuddy 文件夹，方便以后查找和管理。
完成安装
点击「安装」，等待进度条走完（约 1–2 分钟）。勾选「运行 WorkBuddy」后点击「完成」，WorkBuddy 会自动启动。

1.5 macOS 安装

打开 DMG 文件
双击下载好的 WorkBuddy.dmg 文件，会弹出一个安装窗口。
拖入应用程序
将 WorkBuddy 图标拖拽到「Applications」（应用程序）文件夹。
首次启动（重要！）
在「应用程序」中找到 WorkBuddy 并双击打开。

如果弹出「无法打开，因为无法验证开发者」：
1. 打开「系统设置」→「隐私与安全性」
2. 在页面底部找到「已阻止 WorkBuddy 打开」的提示
3. 点击「仍要打开」按钮
4. 再次输入 Mac 密码确认

1.6 登录与初始配置

登录账号
首次启动会显示登录界面。推荐使用微信扫码或手机号登录。如果已有 CodeBuddy 账号，直接用同一账号登录即可。
授权文件访问
登录后，WorkBuddy 会请求访问本地文件夹的权限。这是它帮你处理文件的前提条件。

⚠️ 安全建议 建议只授权常用文件夹（桌面、文档、下载），不要授权包含敏感数据的文件夹（如财务、合同等）。
调整工作空间路径（推荐）
WorkBuddy 生成的所有文件默认保存在系统盘。建议修改：
- 点击左下角头像 →「设置」→ 找到「存储路径」
- 修改为你常用的文件夹，如 D:\WorkBuddy_Files\（Windows）或 ~/Documents/WorkBuddy/（macOS）
模型选择（可选）
在设置中可以配置使用的 AI 模型。支持：
- 混元：腾讯自研，日常办公推荐，响应快
- DeepSeek：复杂推理任务，理解能力强
- GLM / Kimi / MiniMax：各有擅长领域
新手建议保持默认的「智能推荐」模式，WorkBuddy 会根据任务自动选择最合适的模型。

1.7 三种工作模式

WorkBuddy 有三种模式可以切换，对应不同的使用场景：

模式	适合场景	特点
Ask 问答	查资料、总结文档、翻译	只读不写，不会修改文件，最省积分
Plan 规划	复杂任务先出方案	先生成执行计划让你确认，再切换到 Craft 执行
Craft 执行	实际干活、生成文件	核心工作模式，权限全开，自主完成搜索→读写→交付

💡 使用建议 日常问答用 Ask（省积分），需要 AI 帮你做事用 Craft（功能全开）。复杂任务可以先 Plan 再 Craft。

典型指令示例

📊 把桌面"2026Q1销售数据"里所有Excel合并，生成柱状图+分析报告

📄 把D盘"周报"文件夹里所有Word转PDF，并按日期重命名

📈 读取"业绩表.xlsx"，计算各部门环比，生成PPT并自动排版

📅 每天9点自动导出昨日订单数据，发送到企业微信群

1.8 远程控制配置（助理功能）

WorkBuddy 支持通过手机上的通讯软件远程控制电脑上的 WorkBuddy。支持：微信、企业微信、QQ、飞书、钉钉、元宝。

打开 WorkBuddy，点击右上角头像
选择「助理设置」
选择你要绑定的平台（如微信）
点击「配置」，会弹出二维码
用手机扫码绑定
绑定后在手机对应 App 中找到 WorkBuddy 机器人，发送指令即可

📌 典型场景 出门在外时，用微信给 WorkBuddy 发一条"帮我整理一份关于 AI 芯片的报告"，它就会在你办公室的电脑上自动执行，完成后把结果推送到你微信上。

1.9 技能生态

WorkBuddy 内置了 20+ 技能包，并深度兼容 OpenClaw 社区的全部技能（100+），覆盖：

📄 PDF 处理（合并、拆分、转换、OCR）
📊 Excel 数据分析（透视表、图表、自动化报表）
🎨 PPT 制作（自动排版、美化、配图生成）
🌐 浏览器自动化（数据抓取、表单填写、网页操作）
🎵 音视频处理（语音合成、视频生成、音乐创作）
📝 内容创作（公众号文案、SEO 文章、多语言翻译）

💡 技能就是"专业工具箱" 每个技能就像一个专业助手，专门解决某一类问题。你可以在技能市场浏览和安装更多技能。如果你会写 Markdown，还能自己创建自定义技能。

1.10 使用技巧与常见问题

撰写好指令的技巧

指定完整文件路径（如"桌面/2026Q1销售数据/"）
明确输出格式（PDF、Excel、PPT、Word 等）
说清具体要求（图表类型、分析维度等）
从简单任务开始，逐步尝试复杂任务

常见问题

Q: 安装后无法启动？ 检查 Windows 版本是否 ≥ 10，或 macOS 版本是否 ≥ 10.15。尝试以管理员身份运行（Windows 右键 → 以管理员身份运行）。

Q: 提示"没有权限访问文件夹"？ 打开 WorkBuddy 设置 → 文件访问权限 → 重新授权需要的文件夹。

Q: 任务执行到一半卡住了？ 点击「停止」终止当前任务 → 检查任务描述是否清晰 → 尝试简化任务 → 或更换 AI 模型后重试。

🦞Part 2 · OpenClaw 部署指南

2.1 什么是 OpenClaw？

OpenClaw 是一个开源的 AI Agent 多渠道路由网关（开源项目代号"小龙虾"）。它可以：

管理多个 AI Agent（每个 Agent 有独立的工作区、配置和记忆）
对接多种消息渠道（企业微信、QQ、飞书、Discord、Telegram、Signal、Slack 等 20+）
支持多种 AI 模型（DeepSeek、OpenAI、Claude、MiniMax 等），统一路由
提供 100+ 社区技能扩展（天气、音乐生成、视频生成、截图、浏览器控制等）
支持多台设备节点配对，远程控制

📌 验证状态 本机当前运行 OpenClaw v2026.4.24，Node v22.22.2，npm 10.9.7，Gateway 正常运行中（pid 1520474，systemd 托管）。以下所有命令均在此环境实测通过。

2.2 系统要求

项目	要求
Node.js	v22.22.3+（推荐 v24.15+），或 v25.9+
操作系统	macOS / Linux / Windows（含 WSL2）
包管理器	npm / pnpm / bun 任选其一
存储空间	约 500 MB（含依赖和运行数据）
网络	需要稳定的网络连接（调用 LLM API）

如何检查 Node.js 是否已安装？

# 打开终端（Windows: Win+R 输入 cmd，Mac: 打开"终端"）
node --version    # 应显示 v22.22.3 或更高
npm --version     # 应显示 10.x 或更高

⚠️ 如果没装 Node.js 最简单的办法是用 OpenClaw 官方安装脚本，它会自动帮你装好 Node.js。或者访问 nodejs.org 下载 LTS 版本手动安装。

2.3 安装方式

推荐以下三种方式，按推荐度排序：

✨ 方式一：官方安装脚本（推荐新手）

一条命令搞定所有——自动检测系统、安装 Node.js（如需要）、安装 OpenClaw、启动初始化引导。

macOS / Linux / WSL2：

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

Windows PowerShell：

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

💡 如果只想安装，不想立即运行初始化引导：
macOS/Linux: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows: & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

📦 方式二：npm 全局安装（推荐有 Node.js 的用户）

如果你已经装了 Node.js，这是最快的方式：

# 全局安装（三选一）
npm install -g openclaw@latest      # 用 npm
pnpm add -g openclaw@latest         # 或用 pnpm
bun add -g openclaw@latest          # 或用 bun

# 安装后运行初始化引导
openclaw onboard --install-daemon

⚠️ pnpm 用户注意 安装后需要额外运行 pnpm approve-builds -g 来批准构建脚本。

🐳 方式三：Docker 容器

适合服务器部署或需要完全隔离的场景。详见官方 Docker 文档。

2.4 验证安装

安装完成后，运行以下命令确认一切正常：

openclaw --version       # 确认 CLI 可用，应显示版本号
openclaw doctor          # 检查配置问题
openclaw gateway status  # 检查 Gateway 运行状态

本机实测输出：

$ openclaw --version
OpenClaw 2026.4.24 (cbcfdf6)

$ openclaw gateway status
Gateway: bind=loopback (127.0.0.1), port=18789
Runtime: running (pid 1520474, state active, sub running)

💡 如果提示 "openclaw: command not found"
这是 PATH 问题——npm 全局包的 bin 目录没在你的 PATH 里。解决方法：
1. 运行 npm prefix -g 查看全局包安装路径
2. 把输出的路径（通常以 /bin 结尾）加到系统的 PATH 环境变量中

2.5 初始化引导（Onboarding）

安装完成后，运行初始化引导来完成基础设置：

openclaw onboard --install-daemon

引导过程会依次让你配置：

AI 模型提供商：选择 DeepSeek、OpenAI、MiniMax 等，填入 API Key
创建第一个 Agent：给 Agent 起名字、设定角色
消息渠道：选择要接入的平台（企业微信、Discord、Telegram 等）
安装为系统服务：--install-daemon 会自动注册为系统服务：
- macOS → LaunchAgent（开机自启）
- Linux → systemd 用户服务（开机自启）
- Windows → 计划任务 + 启动项

也可以跳过引导，手动创建基础配置目录：

openclaw setup --baseline   # 只创建目录结构，不跑完整引导

2.6 Gateway 管理

OpenClaw Gateway 是核心服务，Agent 运行、消息收发、模型调用都依赖它。

# 查看 Gateway 状态
openclaw gateway status

# 启动 Gateway
openclaw gateway start

# 停止 Gateway
openclaw gateway stop

# 重启 Gateway
openclaw gateway restart

# 查看 Gateway 日志
openclaw gateway logs

📌 Gateway 默认端口
WebSocket: ws://127.0.0.1:18789
管理界面: http://127.0.0.1:18789/
Agent 和渠道插件都通过 WebSocket 连接到 Gateway。

Linux 用户特别注意

# Linux 使用 systemd 用户服务。默认情况下，用户登出后 systemd 会停止用户服务。
# 需要开启 lingering 让 Gateway 在登出后继续运行：
sudo loginctl enable-linger $USER

# 如果是服务器部署，建议使用 system 级别服务（而非 user 服务）

2.7 创建和管理 Agent

Agent 是 OpenClaw 的核心概念。每个 Agent 有独立的角色设定、工作区、记忆和工具权限。

# 列出所有 Agent
openclaw agents list

# 创建一个新 Agent（交互式）
openclaw agents create

# 查看 Agent 详情
openclaw agents info <agent-name>

# 删除 Agent
openclaw agents delete <agent-name>

每个 Agent 的工作区结构：

~/.openclaw/workspace-<agent-name>/
├── AGENTS.md         # Agent 行为规范
├── SOUL.md           # Agent 角色人格
├── IDENTITY.md       # Agent 身份信息
├── USER.md           # 与用户的交互规则
├── TOOLS.md          # 可用工具清单
├── HEARTBEAT.md      # 定时任务/心跳规则
├── MEMORY.md         # 长期记忆
└── memory/           # 每日短期记忆

2.8 接入消息渠道

OpenClaw 支持 20+ 消息渠道，让你在不同平台上与 Agent 对话：

# 查看可用的渠道
openclaw channels list

# 登录/配置渠道（交互式引导）
openclaw channels login

# 检查渠道状态
openclaw health

渠道	类型	配置方式
企业微信	国内办公	扫码绑定
秀秀（Feishu/BBCode）	龙虾军团专用	Token + Bot 配置
Telegram	国际通讯	Bot Token
Discord	社区/团队	Bot Token
Signal / WhatsApp	加密通讯	二维码配对
Slack / MSTeams	企业协作	OAuth

2.9 多节点配对

OpenClaw 支持将多台设备（节点）配对到一起，统一管理。比如：

一台 Linux 服务器跑 Gateway + Agent
一台 Mac 笔记本作为执行节点（截图、浏览器控制等）
一台 Android 手机作为通知节点

节点配对流程

在主节点（Gateway 所在机器）生成配对码：
openclaw node pair --generate
在子节点（要加入的机器）输入配对码：
openclaw node pair --code <配对码>
验证连接：
openclaw node list

💡 WorkBuddy 用户不需要手动配对 WorkBuddy 已经内置了 OpenClaw 节点能力。在 WorkBuddy 中配置"助理"（远程控制）就相当于完成了节点配对。

🔗Part 3 · WorkBuddy + OpenClaw 联动实战

3.1 如何联动使用

WorkBuddy 与 OpenClaw 的联动基于以下事实：

WorkBuddy 兼容 OpenClaw 全部技能：在 WorkBuddy 的技能市场中可以直接使用 OpenClaw 社区的 100+ 技能
共享账号体系：WorkBuddy 使用腾讯云/CodeBuddy 账号，与 OpenClaw 的模型 API 可共用
互补能力：
- WorkBuddy → 图形界面，适合日常办公操作
- OpenClaw → 命令行/服务端，适合高级定制和自动化

🔄 典型联动场景

场景	用 WorkBuddy 做	用 OpenClaw 做
日常办公	Excel 处理、PPT 制作、文档转换	Agent 管理、渠道消息路由
内容创作	公众号文章、报告生成	多 Agent 协作、审核流程
远程工作	手机远程触发桌面任务	多节点任务分发
自动化	定时任务（每日报表等）	复杂工作流、条件触发

3.2 真实场景演示

场景：老板要求"把上周的销售数据做成 PPT 并发到群里"

使用 WorkBuddy（推荐日常使用）

打开 WorkBuddy，切换到 Craft 模式
输入指令：
读取桌面"上周销售数据.xlsx"，分析各产品线销售额和增长率，生成一份带图表的数据分析 PPT，保存为"销售周报.pptx"
WorkBuddy 自动执行：读取 Excel → 分析数据 → 生成图表 → 制作 PPT → 保存文件
完成后，在 WorkBuddy 中点击"分享"→ 选择企业微信群直接发送

使用 OpenClaw + Agent（推荐高级用户）

创建一个专门的"销售报表 Agent"，配置好 Excel 处理和 PPT 技能
配置企业微信渠道，让 Agent 可以收发消息
在企业微信中 @Agent 发送指令，Agent 自动执行并通过企业微信回复结果
设置定时任务：每周一 9:00 自动生成上周报表并发送

🛠️常见问题 FAQ

Q: WorkBuddy 和 OpenClaw 必须都装吗？ A: 不一定。普通办公用户只装 WorkBuddy 就够了（它内置了 OpenClaw 兼容层）。开发者或需要深度定制的用户再装 OpenClaw。两者可以独立使用，也可以联动。

Q: 安装 OpenClaw 时提示权限不足？ A: Linux/Mac 用户如果不用官方脚本，手动 npm install -g 可能需要 sudo。建议用官方安装脚本（自动处理权限）或配置 npm 全局包路径到用户目录。

Q: Gateway 启动后一会就停了？ A: Linux 用户最常见的原因是没有开启 linger。运行 sudo loginctl enable-linger $USER 解决。也可以检查 openclaw gateway logs 查看具体错误。

Q: 国内网络慢、npm install 卡住？ A: 可以配置 npm 镜像：npm config set registry https://registry.npmmirror.com。或者使用官方安装脚本（内置了网络优化）。

Q: API Key 怎么获取？ A: 各模型厂商的官网注册后都能获取：

DeepSeek: platform.deepseek.com
MiniMax: minimaxi.com
OpenAI: platform.openai.com
智谱 GLM: open.bigmodel.cn
月之暗面 Kimi: platform.moonshot.cn

Q: WorkBuddy 和 CodeBuddy 是什么关系？ A: CodeBuddy 是腾讯的 AI 代码助手（面向开发者），WorkBuddy 是基于 CodeBuddy 底层能力打造的办公工具（面向所有人）。两者共用账号体系，如果你已有 CodeBuddy 账号，可以直接登录 WorkBuddy。

✅部署自检清单

完成部署后，逐项核对：

WorkBuddy

已从官网下载对应系统版本的安装包
安装完成，能正常登录
已授权必要的文件夹访问权限
尝试发送了一条简单指令并成功收到结果
如需要，已配置远程控制（微信/企微绑定）
已调整工作空间存储路径到非系统盘

OpenClaw

node -v 显示 v22.22.3 或更高
openclaw --version 正常显示版本号
openclaw doctor 无严重报错
openclaw gateway status 显示 Gateway 运行中
已配置至少一个 AI 模型的 API Key
已创建至少一个 Agent
已接入至少一个消息渠道
如部署在 Linux 上，已开启 lingering

📚资源与链接

🌐

WorkBuddy 官网

下载、文档、社区

访问官网

📖

OpenClaw 官方文档

安装、配置、开发指南

查看文档

📦

OpenClaw npm

包详情、版本历史

npm 页面

💻

OpenClaw GitHub

源码、Issue、贡献指南

GitHub

🔧

Node.js 下载

LTS 版本（推荐）

下载 Node.js

🤖

龙虾军团 Hub

任务交付汇总台

访问 Hub

📝 版本信息 验证环境：Linux x64, Node v22.22.2, OpenClaw v2026.4.24, npm 10.9.7
所有命令和步骤均在上述环境中实测验证通过。如你在其他平台遇到问题，欢迎反馈。

📥下载教程

提供 PDF 和 Word 两种格式，方便离线阅读和打印。

📄

PDF 版本

适合打印、离线阅读

⬇ 下载 PDF

📝

Word 版本

适合编辑、批注

⬇ 下载 Word

WorkBuddy + 龙虾 OpenClaw从零到完整部署

WorkBuddy 和 OpenClaw 是什么关系？

⚡5 分钟快速了解

🖥️Part 1 · WorkBuddy 部署指南

1.1 什么是 WorkBuddy？

1.2 系统要求

1.3 下载安装包

1.4 Windows 安装（图文详解）

1.5 macOS 安装

1.6 登录与初始配置

1.7 三种工作模式

典型指令示例

1.8 远程控制配置（助理功能）

1.9 技能生态

1.10 使用技巧与常见问题

撰写好指令的技巧

常见问题

🦞Part 2 · OpenClaw 部署指南

2.1 什么是 OpenClaw？

2.2 系统要求

如何检查 Node.js 是否已安装？

2.3 安装方式

✨ 方式一：官方安装脚本（推荐新手）

📦 方式二：npm 全局安装（推荐有 Node.js 的用户）

🐳 方式三：Docker 容器

2.4 验证安装

2.5 初始化引导（Onboarding）

2.6 Gateway 管理

Linux 用户特别注意

2.7 创建和管理 Agent

2.8 接入消息渠道

2.9 多节点配对

节点配对流程

🔗Part 3 · WorkBuddy + OpenClaw 联动实战

3.1 如何联动使用

3.2 真实场景演示

场景：老板要求"把上周的销售数据做成 PPT 并发到群里"

🛠️常见问题 FAQ

✅部署自检清单

WorkBuddy

OpenClaw

📚资源与链接

📥下载教程

WorkBuddy + 龙虾 OpenClaw
从零到完整部署