本地部署中文OpenClaw 教程
·
参考:https://cloud.tencent.com/developer/article/2630449
一、安装 OpenClaw
1.打开windows的PowerShell
2.执行以下命令一键安装
# 在 PowerShell 中运行
iwr -useb https://clawd.org.cn/install.ps1 | iex

二、运行首次配置向导
1.重新打开一个 CMD
2.输入命令启动配置向导:
openclaw-cn onboard
2.1 向导启动后:

随后操作↓
2.2 获取大模型的apikey

随后操作↓
2.3:配置飞书机器人渠道
在 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部署完成后统一在飞书后台设置,避免向导卡住。

在指定位置输入刚才复制的飞书机器人App ID 和 App Secret,继续下一步直到向导完成。
启动网关服务
配置完成后,启动 OpenClaw 的网关
openclaw-cn gateway

访问管理后台并验证
浏览器打开命令中提示的网址。
登录 OpenClaw 管理后台。
检查事件订阅是否为 长连接模式。
确认已添加的事件列表完整。
测试部署是否成功
发送消息给飞书机器人(如 @机器人 你好)。
如果机器人正常回复,则部署成功!
快速排错提示
- onboard 卡住或报错 → 检查网络,重新运行 openclaw-cn onboard。
- gateway 启动失败 → 检查端口 18789 是否被占用,可加参数 --port 其他端口。
- 飞书不回复 → 确认选了“长连接”、事件已订阅、App ID/Secret/Key 无误。
- 模型无响应 → 确认百炼 API Key 有效、配额充足。
更多推荐



所有评论(0)