win10 本地部署openclaw并集成钉钉
在 Windows 10 本地部署 OpenClaw,最稳妥的路径是“Node.js 环境 + 官方安装脚本”。
第一步:环境准备(Node.js ≥ 22)
官网下载(https://nodejs.org/zh-cn)并安装,使用node -v 验证安装。
第二步:配置 PowerShell 执行策略
Windows 默认禁止运行脚本,需解锁权限(仅需执行一次)。
在管理员 PowerShell 中执行:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
出现提示时输入 Y确认
第三步:安装 OpenClaw
官方一键脚本(推荐)
这是官方最推荐的方式,会自动处理依赖。
iwr -useb https://openclaw.ai/install.ps1 | iex
iwr -useb https://clawd.org.cn/install.ps1 | iex # 国内镜像源,推荐,耗时5min,使用 openclaw --version进行验证
第四步:初始化配置(关键)
这是让 OpenClaw 跑起来的核心步骤。
-
运行引导向导:
openclaw onboard --install-daemon
2. 交互式配置(按以下推荐选择):
-
个人使用:选
Yes(默认)。 -
配置模式:选
QuickStart(快速开始)。 -
模型/认证:选择你的大模型供应商(如
Aliyun Bailian阿里云百炼、OpenAI或DeepSeek),并填入对应的 API Key。 -
频道:本地测试选
WebUI(Web 界面)即可。 -
技能:初次安装选
Skip(跳过),后续再按需安装
第五步:启动服务与访问
-
启动网关:初始化完成后,服务通常会自动启动。若未启动,执行:
openclaw gateway start
2. 访问面板:打开浏览器,访问 。
-
首次登录:需要在终端执行
openclaw dashboard token获取 Token 进行认证
OpenClaw 在本地部署后,如何与钉钉集成?
本地部署 OpenClaw 后,与钉钉集成的本质是让钉钉应用通过插件(Channel)将消息转发给你的本地服务。由于你是在本地(非云服务器)部署,网络穿透(公网访问)是最大的挑战。
集成流程概览
-
钉钉侧:创建应用,获取
Client ID和Client Secret。 -
本地侧:安装钉钉插件,修改配置文件。
-
网络侧(关键):解决钉钉服务器如何回调你本地内网服务的问题(推荐使用内网穿透工具)。
-
验证:重启服务,在钉钉中测试对话。
详细操作步骤
步骤一:钉钉开放平台创建应用
-
登录
-
创建企业内部应用,类型选择“机器人”。
-
记录关键信息:Client ID (AppKey)、Client Secret (AppSecret)、AgentId、CorpId(企业ID)
步骤二:本地安装钉钉插件
在本地部署 OpenClaw 的终端中执行安装命令。目前主流有两个插件可选:
-
社区版(功能稳定):
openclaw plugins install https://github.com/soimy/openclaw-channel-dingtalk.git
- 官方版(需特定版本):
openclaw plugins install @dingtalk-real-ai/dingtalk-connector
安装后执行 openclaw plugins list确认 dingtalk或 dingtalk-connector状态为 loaded。
步骤三:修改 OpenClaw 配置文件
编辑配置文件 ~/.openclaw/openclaw.json,在 channels对象中添加钉钉配置。
配置示例(使用社区插件):
{ "channels": { "dingtalk": { "enabled": true, "clientId": "你的Client ID", "clientSecret": "你的Client Secret", "robotCode": "你的Client ID", // 通常与clientId相同 "corpId": "你的企业CorpId", "agentId": 123456789, // 你的应用AgentId "dmPolicy": "open", // 允许私聊 "groupPolicy": "open" // 允许群聊 } } }
步骤四:解决网络回调(关键难点)
钉钉服务器无法直接访问你的本地 localhost。你必须将本地端口(默认 18789)暴露到公网。
- 推荐方案:使用内网穿透工具(如 ngrok、花生壳)
-
假设你使用
ngrok:ngrok http 18789 -
获取生成的
https://xxx.ngrok.io公网地址。
-
-
钉钉配置:在开发者后台“机器人”配置中,将消息接收地址设置为
https://xxx.ngrok.io/dingtalk/webhook(具体路径视插件而定)。
步骤五:重启与测试
-
重启 OpenClaw Gateway:
openclaw gateway restart -
在钉钉工作台或群聊中搜索你的应用,发送消息测试。
posted on 2026-04-02 23:17 Karlkiller 阅读(6) 评论(0) 收藏 举报
浙公网安备 33010602011771号