本地部署中文OpenClaw的详细操作步骤

适用场景：在 Windows 本地（PowerShell）一键部署 OpenClaw教程。

步骤 1：安装 OpenClaw

1. 打开 PowerShell。
2. 执行以下命令一键安装：

代码语言：javascript

AI代码解释

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

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

1. 重新打开一个 CMD 。
2. 输入命令启动配置向导：

openclaw-cn onboard

向导启动后：

1. 第一步选择继续（YES）。

步骤 3：获取 API Key

1. 我这里采用阿里云百炼平台，登录账号
2. 进入左侧菜单「密钥管理」→「创建 API Key」。
3. 创建完成后复制 Key。
4. 返回 onboard 向导，在对应位置粘贴 Key 并继续。

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

1. 在 onboard 向导中，选择配置 Feishu渠道。

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

选择机器人，继续下一步

输入内容（自定义）

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"    ]  }}

1. 在「凭证与基础信息」中复制 App ID 和 App Secret。
2. 进入「事件与回调」：
3. 订阅方式选择 长连接订阅方式（不可选 HTTP 回调）。
4. 添加事件：至少包含 im.message.receive_v1（接收消息）。
5. 保存设置。

注意：事件订阅和回调配置建议在openclaw部署完成后统一在飞书后台设置，避免向导卡住。

3.在指定位置输入刚才复制的飞书机器人App ID 和 App Secret，继续下一步直到向导完成。

步骤 5：启动网关服务

配置完成后，启动 OpenClaw 的网关：

代码语言：javascript

AI代码解释

openclaw-cn gateway

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

1. 浏览器打开命令中提示的网址。
2. 登录 OpenClaw 管理后台。
3. 检查事件订阅是否为 长连接模式。
4. 确认已添加的事件列表完整。

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

1. 发送消息给飞书机器人（如 @机器人 你好）。
2. 如果机器人正常回复，则部署成功！

快速排错提示

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