本地部署中文OpenClaw 教程
来源：互联网 2026-03-13 18:31:12参考：https://cloud.tencent.com/developer/article/2630449一、安装 OpenClaw1.打开windows的PowerShell2.执行以下命令一键安装# 在 PowerShell 中运行iwr -useb https://clawd.org.cn/install.ps1 | iex二、运行首次配置向导1.重新打开一个 CMD2.输入命令启动配置向导：openclaw-cn onboard2.1 向导启动后：随后操
一、安装 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是否依然有效，并且账号的调用配额是否充足。
侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述
