菜鸟AI - 让提示词生成更简单! 全站导航 全站导航
AI工具安装 新手教程 进阶教程 辅助资源 AI提示词 热点资讯 技术资讯 产业资讯 内容生成 模型技术 AI信息库

已有账号?

首页 > AI教程 > OpenClaw本地部署中文教程 手把手详细版
新手教程 手把手详细版

OpenClaw本地部署中文教程 手把手详细版

2026-06-03
阅读 0
热度 0
作者 菜鸟AI编辑部
摘要

摘要

适用场景:在 Windows 环境下通过 PowerShell 快速部署 OpenClaw 服务。 开始操作。本教程将引导

适用场景:在 Windows 环境下通过 PowerShell 快速部署 OpenClaw 服务。

开始操作。本教程将引导你使用 PowerShell 在 Windows 上一键完成 OpenClaw 部署,每一步都有详细说明。

步骤 1:安装 OpenClaw 客户端

  • 启动 PowerShell 终端。
  • 执行以下命令完成安装:

代码语言:powershell

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

步骤 2:启动首次配置向导

  • 新开一个 命令提示符 (CMD) 窗口。
  • 输入以下命令启动配置向导:
openclaw-cn onboard

向导启动后:

  • 在第一个提示处选择“YES”继续,按屏幕指引完成各项设置。

步骤 3:获取 API 密钥

  • 以阿里云百炼平台为例:登录账号,在左侧菜单找到“密钥管理”,点击“创建 API Key”。
  • 生成后复制该 API Key 并临时保存。
  • 切换回 onboard 向导界面,在指定输入框中粘贴 API Key 并继续下一步。

步骤 4:集成飞书机器人渠道

  • 在 onboard 向导中选择配置 飞书渠道。

  • 前往飞书开放平台,创建一个企业自建应用。
  • 选择“机器人”应用类型 → 填写应用名称等基本信息 → 点击创建。

选中机器人选项,进入下一步。

按需填写应用描述等信息(可自定义)。

2. 进入“权限管理” → “批量导入/导出权限”,清空已有权限,将以下 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: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 IDApp Secret
  • 切换到“事件与回调”配置页:
  • 订阅方式必须选择 长连接订阅方式(切勿选择 HTTP 回调)。
  • 添加事件:至少勾选 im.message.receive_v1(接收消息事件)。
  • 保存配置。

重要提示:事件订阅与回调配置推荐在 OpenClaw 部署完毕后再通过飞书后台统一完成,避免流程中断。

3. 在 onboard 向导的对应输入框中,粘贴刚才复制的 App IDApp Secret,并按步骤完成剩余配置直至向导结束。

步骤 5:启动 OpenClaw 网关

配置完成后,执行以下命令启动网关服务:

代码语言:bash

openclaw-cn gateway

步骤 6:登录管理后台并验证配置

  • 在浏览器中打开命令行提示的管理后台地址。
  • 使用管理员账号登录 OpenClaw 管理界面。
  • 检查“事件订阅”状态,确认已启用 长连接模式
  • 核实已添加的事件列表中包含所需事件(如 im.message.receive_v1)。

步骤 7:验证部署结果

  • 向飞书机器人发送一条消息,例如 @机器人 你好。
  • 若机器人能够正确回复,则表示部署成功。

常见问题排查

  • onboard 进程卡住或报错 → 检查网络连通性,重新执行 openclaw-cn onboard
  • gateway 启动失败 → 确认端口 18789 未被占用,可通过 --port 参数指定其他端口。
  • 飞书机器人不回复 → 检查订阅方式是否为“长连接”、事件是否已添加、App ID/App Secret 及 API Key 是否正确。
  • 模型无响应 → 验证阿里云百炼 API Key 有效且账户配额充足。

来源:互联网

免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

同类文章推荐

相关文章推荐

更多