前言：什么是openclaw-cn？

openclaw-cn 是一款私有化部署的AI智能助手，它能在你自己的设备上运行，数据隐私可控，同时支持接入各种大模型API（如DeepSeek、通义千问等）作为“大脑” 。更强大的是，它可以接入WhatsApp、Telegram、飞书等多种通讯渠道，让你通过日常使用的App与AI交互 。本文将手把手带你完成从零到一的部署。

代搭建服务：OpenClaw-cn代搭建 - 小亦商店💕

环境准备与核心认知

在开始安装前，你需要了解：

  1. 核心依赖：openclaw-cn 基于 Node.js 运行，要求 Node.js 版本 ≥ 22 。

  2. API密钥：需要提前准备好AI模型的API密钥。本文以 DeepSeek 为例，请先前往 DeepSeek开放平台 注册账号并创建API Key 。

  3. 系统选择（不建议在自己的主力机上安装openclaw）：

    • Windows：官方强烈推荐使用 WSL2 以获得最佳体验 。当然，你也可以在 PowerShell 中直接安装。

    • Linux：支持 Ubuntu 22.04、CentOS 8 等主流发行版 。

第一章：Windows系统安装openclaw-cn

Windows 下有两种安装方式，建议新手直接使用一键脚本。

方法一：一键安装脚本（推荐）

  1. 以管理员身份打开 PowerShell：右键点击开始菜单，选择“Windows PowerShell (管理员)”或“终端(管理员)”。这是避免权限错误的关键 。

  2. 执行安装命令：在 PowerShell 中复制并粘贴以下命令后回车：

    powershell

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

    该脚本会自动安装 Node.js 24+ 和 openclaw-cn 中文版，并对国内网络进行了优化 。

  3. 验证安装：安装完成后，关闭当前窗口，打开一个新的CMD或PowerShell，输入：

    bash

    openclaw --version

    如果能正常显示版本号，即表示安装成功 。

方法二：npm 安装（手动）

如果你已经手动安装了 Node.js 22+，可以通过 npm 直接安装：

  1. 以管理员身份打开 PowerShell。

  2. 运行全局安装命令：

    bash

    npm install -g openclaw-cn@latest

  3. 可能遇到的坑：如果提示 npm 不是内部或外部命令，说明 Node.js 未正确安装或其路径未添加到系统环境变量。你需要手动将 Node.js 的安装路径（如 C:\Program Files\nodejs\）添加到系统变量的 Path 中 。

  4. （可选）右键我的电脑→属性→高级系统设置→环境变量→找到系统变量的Path双击后添加你的nodejs路径

第二章：Linux系统安装openclaw-cn（以Ubuntu 22.04为例）

Linux 下的安装同样简洁，主要分为安装依赖和运行脚本两步。

  1. 更新系统并安装 Git：

    bash

    sudo apt update && sudo apt install git -y

  2. 安装 Node.js 22.x：
    虽然安装脚本可能会自动处理，但手动安装更稳妥。使用 NodeSource 仓库安装：

    bash

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

    安装后使用 node -v 验证版本应大于 22.0 。

  3. 运行 openclaw-cn 安装脚本：

    bash

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

    这是一个中文安装脚本，可自动检测并安装缺失的依赖 。

第三章：初始化配置与接入DeepSeek API

安装完成后，我们需要通过配置向导让 openclaw-cn 拥有“大脑”——即接入大模型。

  1. 启动配置向导：
    在终端（Windows CMD/PowerShell 或 Linux Terminal）中运行：

    bash

    openclaw-cn onboard

    这是核心配置命令，它会引导你完成所有设置 。

  2. 配置流程详解：

    • 安全警告：阅读关于高权限风险的提示，使用方向键选择 YES 并回车 。

    • 配置模式：选择 QuickStart（快速启动），适合新手 。

    • 网关配置：默认端口 18789 和 IP 127.0.0.1，直接回车确认 。

    • 模型提供商：这是接入DeepSeek的关键一步。由于 DeepSeek 的接口完全兼容 OpenAI 的 SDK 格式，因此请选择列表中的 OpenAI 或 Custom (OpenAI Compatible) 。

    • 输入API信息：根据提示依次输入 ：

      • API Key：粘贴你之前在 DeepSeek 平台创建的 sk-xxx 格式的密钥。

      • Base URL：输入 https://api.deepseek.com（注意末尾不要加 /v1）。

      • Model Name：输入 deepseek-chat（通用对话）或 deepseek-reasoner（深度思考模型R1）。

    • 通道选择：这是配置即时通讯渠道的地方（如飞书、钉钉）。这里先选择“暂时跳过”，我们将在下一章专门配置飞书 。

    • 技能配置：选择 YES 安装基础技能。

    • 包管理器：选择 npm 并回车 。

    • 钩子（Hooks）选择：建议用空格键选中 session-memory（实现长期记忆），然后回车确认 。

    • 孵化机器人：选择在 TUI 中孵化 或 打开网页界面。这里建议选择网页界面，它会自动打开浏览器进入管理后台 。

  3. 验证DeepSeek连接：
    在自动打开的网页界面（通常为 https://127.0.0.1:18789）中，随便发送一条消息。如果机器人能正常回复，则代表DeepSeek API已成功接入 。

第四章：接入飞书——在手机上用AI助手

配置好大脑后，我们来给它装上“嘴巴和耳朵”，通过飞书实现手机端交互。openclaw-cn 目前已支持飞书渠道适配 。

步骤1：创建并配置飞书应用

  1. 登录飞书开放平台：访问 飞书开放平台，点击“创建企业自建应用”，填写应用名称（如“我的AI助手”）、描述和图标后创建 。

  2. 获取凭证：在左侧菜单栏点击“凭证与基础信息”，复制 App ID 和 App Secret。这两个凭证需保密 。

  3. 配置权限：这是最关键的一步，确保机器人有足够权限。

    • 点击左侧“权限管理” -> “批量导入/导出权限”。

    • 在弹出的对话框中，选择“导入”，删除原有内容，粘贴以下 JSON 配置，然后点击“添加格式化JSON” -> “下一步” -> “申请开通” 。

      json

      {
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

  4. 启用机器人能力：点击左侧“应用功能” -> “机器人”，启用机器人，并可以设置机器人的显示名称 。

步骤2：建立连接通道

  1. 配置事件订阅：

    • 在飞书开放平台左侧点击“事件与回调”。

    • 在“事件配置”页签中，将订阅方式改为“长连接”，然后点击保存。注意：必须使用长连接，而不是URL回调 。

    • 点击“添加事件”，搜索并勾选 im.message.receive_v1（接收消息事件），点击确认添加。该事件用于将用户发给机器人的消息推送给 openclaw 。

  2. 在 openclaw 中填入凭证：

    • 回到你的 openclaw 操作终端或 WebUI 配置界面。

    • 在配置飞书的地方，填入之前复制的 App ID 和 App Secret 并应用 。

  3. 发布应用：

    • 点击左侧“版本管理与发布”，创建版本，填写版本号和更新说明，保存后提交审核。只有发布后的应用才能被搜索到并正常使用 。

步骤3：配对与验证

  1. 添加机器人：在飞书电脑客户端，点击左上角“+” -> “添加机器人”，搜索你创建的应用名称并添加 。

  2. 获取配对码：在飞书私聊窗口中向机器人发送任意消息（如“你好”）。机器人会回复一串配对码 。

  3. 批准配对：在 openclaw 的 WebUI 或终端中，运行批准命令：

    bash

    openclaw pairing approve feishu <刚才收到的配对码>

  4. 最终验证：配对成功后，再次在飞书中向机器人发送消息，此时应该能收到来自 openclaw-cn 的正常AI回复了。

常见问题与故障排查

  1. 问题：网关连接断开 (1006)

    • 原因：openclaw-cn gateway 服务没有运行。

    • 解决：回到终端，重新运行 openclaw-cn gateway 启动网关 。

  2. 问题：飞书机器人收不到消息

    • 检查清单 ：

      • 应用是否已发布？

      • 事件订阅是否配置了 im.message.receive_v1？

      • 订阅方式是否为长连接？

      • im:message:send_as_bot 等权限是否已申请通过？

      • openclaw 网关是否正在运行？

  3. 问题：模型报错或没有回复

    • 原因：API Key 错误、网络不通或额度用完。

    • 解决：运行 openclaw-cn doctor 进行自我诊断 ；检查 DeepSeek 账户余额。

  4. 问题：访问不了127.0.0.1:18789

    1. 原因：可能是是远程进行部署和访问

    2. 解决：需要部署另一个软件：tailscale将远程设备与你的本地设备连接到同一个局域网进行访问，具体部署过程需要上网查询，或者直接问deepseek

  5. 问题：实在部署不成功

    1. 小亦为大家提供一系列代搭建服务，欢迎访问OpenClaw-cn代搭建 - 小亦商店💕

总结

至此，你已经成功在 Windows 或 Linux 系统上部署了 openclaw-cn，接入了高性价比的 DeepSeek API，并打通了飞书渠道。现在，你拥有了一位随时随地可用的、数据私密的私人AI助手。你可以继续探索安装更多技能（Skills）来增强它的能力，比如让它能联网搜索或操作你的系统文件 。