本地部署中文OpenClaw 教程

一、安装 OpenClaw

第一步，咱们得准备好Windows自带的那个功能强大的终端工具——PowerShell。打开它，准备执行接下来的指令。

1.打开windows的PowerShell

2.执行以下命令一键安装

接下来的操作就简单了，只需要一句命令。在PowerShell里直接运行下面这行代码，安装过程就会自动开始：

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

二、运行首次配置向导

安装完成后，别急着在原来的窗口操作。为了确保环境干净，咱们重新打开一个命令提示符窗口。

1.重新打开一个 CMD

2.输入命令启动配置向导：

在新的CMD窗口中，输入下方命令，调出首次配置的交互式向导：

openclaw-cn onboard

2.1 向导启动后：

向导界面出现后，按照提示进行后续操作即可。

2.2 获取大模型的apikey

随后操作↓

2.3：配置飞书机器人渠道

在onboard向导的步骤中，选择配置Feishu（飞书）渠道。

这时，需要你输入一些自定义的内容。

接下来是关键的一步：进入飞书开放平台的应用后台，找到「权限管理」。在「批量导入/导出权限」功能中，先清空原有的所有权限。

然后，将下面这段完整的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 ID和App Secret复制下来备用。

接着，进入「事件与回调」配置环节：

这里有个重要的选择：订阅方式务必选择“长连接订阅方式”，注意不要选成“HTTP回调”。

然后添加事件，至少需要包含 im.message.receive_v1（接收消息）这一项。

最后，记得保存所有设置。

注意：为了避免在向导中卡住，通常建议先把OpenClaw部署完成，再统一回到飞书后台进行事件订阅和回调的配置。

回到刚才的onboard向导界面，在指定位置输入你复制的飞书机器人App ID和App Secret。然后点击继续，跟随向导完成剩余的步骤。

启动网关服务

配置向导成功跑完，接下来就该启动OpenClaw的核心服务了。在命令行中执行：

openclaw-cn gateway

访问管理后台并验证

网关启动后，命令行会提示一个管理后台的访问地址。用浏览器打开它。

登录到OpenClaw的管理后台后，你需要做几项验证：

首先是检查事件订阅模式，确认它显示为“长连接模式”。

然后，核对已添加的事件列表是否完整，确保所需的事件都在其中。

测试部署是否成功

最终的试金石来了。打开你的飞书，找到刚刚配置的机器人，给它发一条消息试试，比如简单的“@机器人 你好”。

如果一切顺利，机器人应该会给你一个回复。看到回复的那一刻，恭喜你，这意味着整个OpenClaw的部署已经大功告成了！

快速排错提示

当然，部署过程偶尔也会遇到点小波折。这里有几个常见问题的快速排查思路：

onboard 卡住或报错 → 优先检查网络连接是否通畅，然后尝试重新运行一遍 openclaw-cn onboard 命令。

gateway 启动失败 → 很可能是默认端口18789被其他程序占用了。可以尝试在启动命令后加上 --port 参数指定另一个端口。

飞书不回复 → 重点确认三个地方：飞书后台是否选了“长连接”、事件订阅是否已添加、以及App ID、App Secret和API Key是否都填写无误。

模型无响应 → 检查一下你配置的百炼API Key是否依然有效，并且账号的调用配额是否充足。