新手指南 【OpenClaw】老电脑养不了虾?用魔法打败魔法,零基础免费本地部署Openclaw
DeepWhite深白色
2026年03月19日 15:58

🚀 OpenClaw 安装与配置指南

基于 AI 辅助部署的完整解决方案

详看视频: 【OpenClaw】老电脑养不了虾?用魔法打败魔法,零基础免费部署OpenClaw​


📋 课程概述

本教案旨在指导用户通过 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):

1️⃣ 本地资源包(网盘下载)

📎 夸克网盘链接

https://pan.quark.cn/s/6959f1e185ac

📦 包含内容

虚拟机、镜像(win10、win11)

Ubuntu 本地安装包、OpenClaw 3.13 版本源代码、相关离线依赖、技能包

2️⃣ 技能包文件(网盘也有)

用于 Work Buddy 加载的 openclaw-win-install-ai-assist:

🔗 技能包下载地址 (ClawHub)

https://clawhub.ai/aslancootl/openclaw-win-install-ai-assist

💡 提示:若网络环境较好,可跳过本地准备,直接交由 AI 脚本自动拉取网络资源。


🔧 三、标准化部署流程

🏁 阶段一:辅助工具安装与配置

  1. 访问腾讯 Work Buddy (Code Buddy) 官方网站(https://www.codebuddy.cn/work/),下载并完成客户端安装。

  2. 右键点击快捷方式,选择 「以管理员身份运行」(获取系统环境变量修改与子系统安装权限)(可选择)。

  3. 完成账号注册与登录,获取初始运行所需的使用额度。

  4. 在软件界面中点击 技能 -> 导入技能,选择已下载的 openclaw-win-install-ai-assist 文件夹进行导入。

  5. 导入完成后,新建对话窗口,并在当前对话中选中该技能。


🖥️ 阶段二:系统环境自动化部署 (WSL2 & Ubuntu)

  1. 在 Work Buddy 对话框中,发送以下执行指令(请根据实际存放路径修改指令内容):

  2. 「请读取本地 C 盘 001 文件夹下的文件,开始部署安装 OpenClaw,并在安装完成后于桌面生成快捷启动方式。」

  3. 允许工具自动执行环境检测、WSL2 开启及 Ubuntu 子系统安装。期间若系统弹出权限确认窗口(UAC),请选择「允许」。


⚠️ 注意事项(CPU 虚拟化异常)

若自动化脚本报错并提示「未检测到虚拟化技术」,说明主板 BIOS 限制了该功能。

🖥️ 物理机用户

需重启设备进入 BIOS 设置,开启 Virtualization Technology (VT-x 或 AMD-V) 功能

💻 虚拟机用户

需在虚拟机软件的「处理器」设置面板中,勾选开启「虚拟化引擎」


🐧 阶段三:Ubuntu 与 OpenClaw 初始化

  1. 环境配置过程中可能需要重启计算机。重启后,重新打开 Work Buddy 并向其回复:

  2. 「已重启,请继续执行」

  3. 等待 Ubuntu 安装收尾,随后打开生成的 Ubuntu 终端。

  4. 💡 提示:若安装完成后未在开始菜单或桌面找到 Ubuntu 图标,可在 Work Buddy 对话框中输入:「请在我的桌面上放置一个 Ubuntu 快捷方式」。

  5. 在终端中输入以下初始化命令并回车:

代码块
Bash
自动换行
复制代码
openclaw setup --wizard
复制成功
  1. 依据命令行向导提示,依次选择(使用键盘方向键及回车键确认):

步骤

选择项

确认初始化

Yes

模式选择

Quick Start (快速开始)

配置状态

Reset (重置配置)


🤖 阶段四:大语言模型 (LLM) API 配置

💡 模型选择建议

在选择与配置大模型 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️⃣ 创建飞书自建应用

  1. 登录 飞书开发者后台。

  2. 点击 「创建企业自建应用」,填写应用名称与描述。

  3. 进入应用管理界面,导航至 「添加应用能力」,开启 「机器人」 功能。


2️⃣ 批量配置应用权限

  1. 导航至左侧 「权限管理」 标签页。

  2. 批量搜索并添加以下应用权限(可直接复制下方的权限代码文本):

代码块
JSON
自动换行
复制代码
{
  "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"
    ]
  }
}
复制成功
  1. 添加完毕后,点击 「申请开通/发布」,完成权限审批。


3️⃣ 终端凭证校验与服务启动

  1. 在飞书开发者后台的 「凭证与基础信息」 页面,复制 App ID 与 App Secret。

  2. 返回 Ubuntu 终端,按照终端向导的顺序依次执行以下操作:

步骤

第1步

填入 飞书链接

第2步

填入 App Secret

第3步

填入 App ID

第4步

选项页 1:选择 第一个

第5步

选项页 2:选择 第一个

第6步

选项页 3:选择 第二个

第7步

选项页 4:选择 最后一个

第8步

提示配置项:输入 no

第9步

最终确认项:选择 第一个(按空格键选中,随后按回车键确认)

  1. 凭证配置完成后,执行以下命令正式启动服务:

代码块
Bash
自动换行
复制代码
openclaw gateway
复制成功

4️⃣ 事件订阅配置与设备配对

  1. 切换至飞书开发者后台,导航至 「事件与回调」 页面。

  2. 将配置方式更改为 「长连接」 并保存。

  3. 勾选前文申请的全部事件权限,随后点击 「创建版本并发布应用」。

  4. 打开飞书 PC 或移动客户端,搜索并进入该机器人对话框,发送任意测试消息。

  5. 此时 Ubuntu 终端界面将实时输出一段 配对识别码(Approve Code)。复制该识别码,并在终端执行以下配对指令:

代码块
Bash
自动换行
复制代码
openclaw pairing approve feishu <在此替换为终端生成的识别码>
复制成功

🔧 长连接失败的排查建议

若未能成功接收消息或报错,通常由于以下三种原因导致:

原因 1

OpenClaw 服务尚未在终端中启动

(Ubuntu 终端输入:openclaw gateway)

原因 2

OpenClaw 未完成上述的 pairing approve 配对链接

原因 3

飞书自建应用尚未完成发布(未创建可用版本)


🌐 阶段六:获取 Token 并访问网页端控制面板

当核心服务与飞书配置均已完成,且后端服务保持运行状态时,需通过特定 Token 授权访问本地可视化的控制面板:

  1. 新开终端窗口:保持原有运行服务的终端不关闭,在系统中打开一个新的 Ubuntu 终端窗口。

  2. 启动交互界面:在新的终端中输入以下命令并回车启动:

代码块
Bash
自动换行
复制代码
openclaw tui
复制成功
  1. 连通性测试:在出现的终端交互界面中,随意输入一段文本进行基础的测试连接。

  2. 获取授权链接:测试无误后,继续在对话框中输入指令:

  3. 「给我一个带 token 的网址」

  4. 访问面板:复制终端返回的带有 token 参数的完整 URL 地址。在本地计算机的浏览器(推荐 Google Chrome 或 Microsoft Edge)地址栏中粘贴并访问该 URL。

页面加载成功后,即可在 Web 可视化界面中进行更高级的模型管理、参数设置与状态监控。


✅ 执行完毕

执行完毕后,OpenClaw 服务的本地化部署与配置即全部完成。