【养虾活动】绿联Nas小龙虾钉钉入口配置指南

绿联NAS里的小龙虾太好用了，既方便高效，又省电省心。
唯一的痛点是，对于新手来说，默认只有网页版的访问方式。
今天摸索了一下在钉钉上给NAS小龙虾配入口的方式，分享给各位老铁。


访问原理和流程
该方案下，主要的原理和流程见下图：


配置步骤

1. 钉钉开放平台创建应用

• 登录 https://open.dingtalk.com/
• 进入「应用开发」→「第三方企业应用」→「创建应用」
• 填写应用名称等信息
• 关键：消息接收模式选择「Stream」
• 发布应用并获取凭证：
  
  • Client ID (AppId)
  • Client Secret (AppSecret)
    

2. NAS 安装 Cpolar

在绿联 NAS 的 Docker 中安装并运行 cpolar：

# 方式一：Docker 方式（需要特权模式）docker run -d --name cpolar -itd \  --privileged \  -p 9090:9090 \  -e "CPOLAR_AUTH_TOKEN=你的TOKEN" \  cpolar/cpolar:latest# 方式二：直接在 NAS 系统安装（推荐）# 参考 https://cpolar.com/docs3. 配置 Cpolar TCP 隧道

在 Cpolar 后台创建 TCP 隧道：

• 协议：TCP
• 本地地址：192.168.2.2:18799（NAS 内网 IP + Gateway 端口）
• 端口类型：临时 TCP（免费版）或永久 TCP（付费版）
  

创建后会得到一个地址：tcp://xxx.cpolar.top:xxxxx

4. OpenClaw 配置

4.1 开启 Gateway HTTP 端点

1. {
   
2.   "gateway": {
   
3.     "http": {
   
4.       "endpoints": {
   
5.         "chatCompletions": {
   
6.           "enabled": true
   
7.         }
   
8.       }
   
9.     }
   
10.   }
    
11. }

复制代码

4.2 配置钉钉连接

1. {
   
2.   "channels": {
   
3.     "dingtalk-connector": {
   
4.       "enabled": true,
   
5.       "clientId": "钉钉的ClientID",
   
6.       "clientSecret": "钉钉的ClientSecret",
   
7.       "gatewayUrl": "cpolar的TCP地址",
   
8.       "gatewayToken": "Gateway认证令牌"
   
9.     }
   
10.   }
    
11. }

复制代码

Gateway 令牌获取：在 gateway.auth.token 中查看（默认配置中有）

5. 重启 Gateway

1. openclaw gateway restart
   

复制代码

关键要点总结

[td]

项目	要求
钉钉消息接收模式	必须选择 Stream
Cpolar 协议	TCP（不是 HTTP）
Cpolar 本地地址	NAS 内网 IP:18799
Gateway HTTP 端点	必须开启 chatCompletions
钉钉 gatewayToken	必须配置（否则 401）

常见问题排查

[td]

错误	原因	解决方案
404 Not Found	Gateway HTTP 端点未开启	配置并重启 Gateway
401 Unauthorized	gatewayToken 未配置	填入正确的令牌
设备身份验证失败	认证配置问题	关闭 auth 或正确配置 token
Tunnel unavailable	Cpolar 指向错误地址	检查本地地址是否为内网 IP

完整配置示例

1. {
   
2.   "gateway": {
   
3.     "port": 18799,
   
4.     "mode": "local",
   
5.     "bind": "lan",
   
6.     "auth": {
   
7.       "mode": "token",
   
8.       "token": "你的Gateway令牌"
   
9.     },
   
10.     "http": {
    
11.       "endpoints": {
    
12.         "chatCompletions": {
    
13.           "enabled": true
    
14.         }
    
15.       }
    
16.     }
    
17.   },
    
18.   "channels": {
    
19.     "dingtalk-connector": {
    
20.       "enabled": true,
    
21.       "clientId": "dingxxxxxxxxxxxx",
    
22.       "clientSecret": "xxxxxxxxxxxxxxxx",
    
23.       "gatewayUrl": "tcp://xxx.cpolar.top:12345",
    
24.       "gatewayToken": "你的Gateway令牌"
    
25.     }
    
26.   }
    
27. }

复制代码

其它注意事项
1、新入口有独立的会话编号，所以可以看成独立的会话；同样的，也可以有独立的名称和个性。
2、如果想分享上下文，可以在源头入口，让小龙虾写到记忆里，这样另一端也可以看到。

希望各位联友玩得开心，多多交流指点~

666