基于 AI 辅助部署的完整解决方案
本教案旨在指导用户通过 AI 辅助编程工具(Work Buddy / Code Buddy) 完成 OpenClaw 的本地化自动化部署。该方案极大降低了环境配置(如 WSL2、Ubuntu)的技术门槛,并提供了 API 接入与飞书客户端集成的标准流程。
在执行部署前,请确保本地设备满足以下基础硬件与系统要求:
硬件/系统
🔄 处理器 (CPU)
64 位多核处理器(基础双核及以上,推荐 Intel Core i5 / AMD Ryzen 3 及以上)
💾 运行内存 (RAM)
最低 4GB(推荐 8GB 及以上,以保障多任务运行流畅度)
🖥️ 操作系统
Windows 10 / Windows 11(需支持并开启 WSL2 功能)或 macOS
💿 磁盘空间
至少 20GB 系统盘空闲空间
🌐 网络环境
需保持网络连接稳定(常规国内网络环境即可)
为提升部署效率,请提前下载并解压以下依赖文件至本地磁盘(如 C:\001):
📎 夸克网盘链接
https://pan.quark.cn/s/6959f1e185ac
📦 包含内容
虚拟机、镜像(win10、win11)
Ubuntu 本地安装包、OpenClaw 3.13 版本源代码、相关离线依赖、技能包
用于 Work Buddy 加载的 openclaw-win-install-ai-assist:
🔗 技能包下载地址 (ClawHub)
https://clawhub.ai/aslancootl/openclaw-win-install-ai-assist
💡 提示:若网络环境较好,可跳过本地准备,直接交由 AI 脚本自动拉取网络资源。
访问腾讯 Work Buddy (Code Buddy) 官方网站(https://www.codebuddy.cn/work/),下载并完成客户端安装。
右键点击快捷方式,选择 「以管理员身份运行」(获取系统环境变量修改与子系统安装权限)(可选择)。
完成账号注册与登录,获取初始运行所需的使用额度。
在软件界面中点击 技能 -> 导入技能,选择已下载的 openclaw-win-install-ai-assist 文件夹进行导入。
导入完成后,新建对话窗口,并在当前对话中选中该技能。
在 Work Buddy 对话框中,发送以下执行指令(请根据实际存放路径修改指令内容):
「请读取本地 C 盘 001 文件夹下的文件,开始部署安装 OpenClaw,并在安装完成后于桌面生成快捷启动方式。」
允许工具自动执行环境检测、WSL2 开启及 Ubuntu 子系统安装。期间若系统弹出权限确认窗口(UAC),请选择「允许」。
⚠️ 注意事项(CPU 虚拟化异常)
若自动化脚本报错并提示「未检测到虚拟化技术」,说明主板 BIOS 限制了该功能。
🖥️ 物理机用户
需重启设备进入 BIOS 设置,开启 Virtualization Technology (VT-x 或 AMD-V) 功能
💻 虚拟机用户
需在虚拟机软件的「处理器」设置面板中,勾选开启「虚拟化引擎」
环境配置过程中可能需要重启计算机。重启后,重新打开 Work Buddy 并向其回复:
「已重启,请继续执行」
等待 Ubuntu 安装收尾,随后打开生成的 Ubuntu 终端。
💡 提示:若安装完成后未在开始菜单或桌面找到 Ubuntu 图标,可在 Work Buddy 对话框中输入:「请在我的桌面上放置一个 Ubuntu 快捷方式」。
在终端中输入以下初始化命令并回车:
openclaw setup --wizard 依据命令行向导提示,依次选择(使用键盘方向键及回车键确认):
步骤
选择项
确认初始化
Yes
模式选择
Quick Start (快速开始)
配置状态
Reset (重置配置)
💡 模型选择建议
在选择与配置大模型 API 前,建议先对各大模型的能力进行综合评估对比。您可以访问大模型评测网站 Pinchbench (https://pinchbench.com),查看各类模型在不同任务维度上的最新排名与性能表现,从而选择最符合您需求与预算的基础大模型。
OpenClaw 需接入第三方大语言模型 API 以提供底层推理能力。在终端的后续向导中,需依次填入以下参数:
Model Provider (模型服务商)
选择对应的供应商名称(支持自定义 Custom Provider)
API Base URL (接口地址)
填入服务商提供的标准调用地址
API Key (鉴权密钥)
填入在服务商控制台生成的对应密钥
Model ID (模型名称)
填入对应的模型标准调用名称(如 glm-4 或 claude-3-5-sonnet)
输入完毕后回车执行网络测试,若终端输出 Verification successful 则表示 API 鉴权通过。随后按提示为机器人命名即可。(详看视频教程)
附录:国内主流大模型服务商配置参考表
智谱 GLM
GLM-5 表现优异,排名较高。量小费用较高,需抢购。链接注册95折。
阿里云百炼
注册含免费体验额度,套餐用量充足,适合熟悉操作流程。
火山引擎
使用邀请码享9折优惠。模型包含豆包及部分主流基础模型。
优云 (第三方整合平台)
模型全面(含 Claude 4.6等),按 Token 积分计费。注册送5元。可用于体验套餐6.9元。
为实现全端交互,需将运行在本地的 OpenClaw 服务接入飞书应用。
参考阅读:WorkBuddy 接入飞书指南
1️⃣ 创建飞书自建应用
登录 飞书开发者后台。
点击 「创建企业自建应用」,填写应用名称与描述。
进入应用管理界面,导航至 「添加应用能力」,开启 「机器人」 功能。
2️⃣ 批量配置应用权限
导航至左侧 「权限管理」 标签页。
批量搜索并添加以下应用权限(可直接复制下方的权限代码文本):
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access",
"base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
} 添加完毕后,点击 「申请开通/发布」,完成权限审批。
3️⃣ 终端凭证校验与服务启动
在飞书开发者后台的 「凭证与基础信息」 页面,复制 App ID 与 App Secret。
返回 Ubuntu 终端,按照终端向导的顺序依次执行以下操作:
步骤
第1步
填入 飞书链接
第2步
填入 App Secret
第3步
填入 App ID
第4步
选项页 1:选择 第一个
第5步
选项页 2:选择 第一个
第6步
选项页 3:选择 第二个
第7步
选项页 4:选择 最后一个
第8步
提示配置项:输入 no
第9步
最终确认项:选择 第一个(按空格键选中,随后按回车键确认)
凭证配置完成后,执行以下命令正式启动服务:
openclaw gateway 4️⃣ 事件订阅配置与设备配对
切换至飞书开发者后台,导航至 「事件与回调」 页面。
将配置方式更改为 「长连接」 并保存。
勾选前文申请的全部事件权限,随后点击 「创建版本并发布应用」。
打开飞书 PC 或移动客户端,搜索并进入该机器人对话框,发送任意测试消息。
此时 Ubuntu 终端界面将实时输出一段 配对识别码(Approve Code)。复制该识别码,并在终端执行以下配对指令:
openclaw pairing approve feishu <在此替换为终端生成的识别码> 🔧 长连接失败的排查建议
若未能成功接收消息或报错,通常由于以下三种原因导致:
原因 1
OpenClaw 服务尚未在终端中启动
(Ubuntu 终端输入:openclaw gateway)
原因 2
OpenClaw 未完成上述的 pairing approve 配对链接
原因 3
飞书自建应用尚未完成发布(未创建可用版本)
当核心服务与飞书配置均已完成,且后端服务保持运行状态时,需通过特定 Token 授权访问本地可视化的控制面板:
新开终端窗口:保持原有运行服务的终端不关闭,在系统中打开一个新的 Ubuntu 终端窗口。
启动交互界面:在新的终端中输入以下命令并回车启动:
openclaw tui 连通性测试:在出现的终端交互界面中,随意输入一段文本进行基础的测试连接。
获取授权链接:测试无误后,继续在对话框中输入指令:
「给我一个带 token 的网址」
访问面板:复制终端返回的带有 token 参数的完整 URL 地址。在本地计算机的浏览器(推荐 Google Chrome 或 Microsoft Edge)地址栏中粘贴并访问该 URL。
页面加载成功后,即可在 Web 可视化界面中进行更高级的模型管理、参数设置与状态监控。
执行完毕后,OpenClaw 服务的本地化部署与配置即全部完成。