首页 > 教程攻略 > ai教程 >本地部署中文OpenClaw的详细教程

本地部署中文OpenClaw的详细教程

来源:互联网 时间:2026-06-02 16:15:29

适用场景:

在 Windows 本地(PowerShell)一键部署 OpenClaw 教程。

好吧,咱们直接开始。这篇教程的目标很明确:带你用 PowerShell 在 Windows 上一键部署 OpenClaw,全程手把手,包教包会。下面按步骤来。

步骤 1:安装 OpenClaw

  • 打开

    PowerShell

  • 运行下面的命令就可以了:

代码语言:ja vascript

# 在 PowerShell 中运行
iwr -useb https://clawd.org.cn/install.ps1 | iex

步骤 2:运行首次配置向导

  • 重新打开一个

    CMD

    (没错,是命令提示符)。
  • 输入命令启动配置向导:
openclaw-cn onboard

向导启动后:

  • 第一步选择继续(YES),跟着提示走就行。

步骤 3:获取 API Key

  • 这里以阿里云百炼平台为例。登录账号后,进入左侧菜单「密钥管理」→「创建 API Key」。
  • 创建完成后复制 Key 备用。
  • 返回 onboard 向导,在对应位置粘贴 Key 并继续。

步骤 4:配置飞书机器人渠道

  • 在 onboard 向导中,选择配置

    Feishu

    渠道。

  • 访问飞书开放平台,创建一个企业自建应用。
  • 选择机器人类型 → 填写基本信息 → 创建。

选择机器人,继续下一步。

输入内容(自定义即可)。

2. 在权限管理/批量导入/导出权限中,清空原有权限,粘贴下方内容:

{
  "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:contact.base:readonly",
      "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",
      "contact:contact.base:readonly",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

  • 在「凭证与基础信息」中复制 App ID 和 App Secret。
  • 进入「事件与回调」:
  • 订阅方式记得选择

    长连接订阅方式

    (千万别选 HTTP 回调)。
  • 添加事件:至少包含 im.message.receive_v1(接收消息)。
  • 保存设置。

注意

:事件订阅和回调配置建议在 openclaw 部署完成后统一在飞书后台设置,防止中途卡住。

3. 在指定位置,输入刚才复制的飞书机器人

App ID

App Secret

,继续下一步直到向导完成。

步骤 5:启动网关服务

配置搞定后,启动 OpenClaw 的网关:

代码语言:ja vascript

openclaw-cn gateway

步骤 6:访问管理后台并验证

  • 浏览器打开命令中提示的网址。
  • 登录 OpenClaw 管理后台。
  • 检查事件订阅是否为

    长连接模式

  • 确认已添加的事件列表完整。

步骤 7:测试部署是否成功

  • 给飞书机器人发一条消息,比如 @机器人 你好。
  • 如果机器人正常回复,那部署就妥妥的了!

快速排错提示

  • onboard 卡住或报错 → 检查网络,重新运行 openclaw-cn onboard。
  • gateway 启动失败 → 检查端口 18789 是否被占用,可加参数 --port 其他端口。
  • 飞书不回复 → 确认选了“长连接”、事件已订阅、App ID/Secret/Key 无误。
  • 模型无响应 → 确认百炼 API Key 有效、配额充足。