新手教程
手把手详细版
OpenClaw本地部署中文教程 手把手详细版
摘要
适用场景:在 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 ID 和 App Secret。
- 切换到“事件与回调”配置页:
- 订阅方式必须选择 长连接订阅方式(切勿选择 HTTP 回调)。
- 添加事件:至少勾选
im.message.receive_v1(接收消息事件)。 - 保存配置。
重要提示:事件订阅与回调配置推荐在 OpenClaw 部署完毕后再通过飞书后台统一完成,避免流程中断。

3. 在 onboard 向导的对应输入框中,粘贴刚才复制的 App ID 与 App 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 有效且账户配额充足。
来源:互联网
免责声明
本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。