WorkBuddy双栈网络部署需满足四方面要求：一、客户端操作系统须启用并正确配置IPv4/IPv6双协议栈；二、腾讯云网关需支持IPv6 DNS解析与HTTPS端到端连通；三、本地DNS与代理须统一支持双栈解析与转发；四、MCP信令通道需显式启用IPv6并验证握手成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在部署WorkBuddy时需确保其能正常接入同时承载IPv4与IPv6流量的双栈网络，则需明确其对IPv6协议栈的实际支持边界及配套配置要求。以下是针对WorkBuddy部署环境中实现双栈网络接入的具体操作路径：
一、确认WorkBuddy客户端本地协议栈兼容性
WorkBuddy作为桌面级AI智能体，其网络通信能力依赖于宿主操作系统提供的底层协议栈。客户端本身不独立实现IPv4/IPv6协议栈，而是复用系统原生能力。因此，双栈接入的前提是操作系统已启用并正确配置IPv4与IPv6双协议栈。
1、在Windows系统中，打开“控制面板 > 网络和Internet > 网络连接”，右键当前活动网络适配器，选择“属性”；
2、勾选“Internet协议版本6 (TCP/IPv6)”与“Internet协议版本4 (TCP/IPv4)”，确保两者均处于启用状态；
3、点击“配置”进入高级设置，确认IPv6地址获取方式为自动（DHCPv6或无状态地址自动配置SLAAC），且未手动禁用IPv6路由器通告处理功能；
4、在命令提示符中执行ipconfig /all，验证输出中同时存在有效的IPv4地址（如192.168.x.x）与全球单播IPv6地址（以2001:db8::或fc00::等开头，非fe80::链路本地地址）。
二、验证腾讯云网关服务端IPv6可达性
WorkBuddy需通过腾讯云网关调用云端模型服务，该链路的双栈能力取决于腾讯云基础设施是否对客户端发起的IPv6连接提供端到端支持。根据官方技术文档，当前WorkBuddy服务端已部署IPv6 DNS解析记录及HTTPS服务端点，但实际连接行为由客户端系统DNS解析结果与HTTP客户端库策略共同决定。
1、在终端中执行nslookup copilot.tencent.com，检查返回结果中是否包含AAAA记录（IPv6地址）；
2、若返回AAAA记录，继续执行curl -6 -I https://copilot.tencent.com，确认HTTP状态码为200且响应头中无IPv6连接拒绝标识；
3、若curl命令报错“Network is unreachable”或超时，说明本地IPv6路由未通达腾讯云任播前缀，需检查上游ISP是否分配了可路由IPv6前缀，并确认防火墙未屏蔽ICMPv6或TCP 443端口的IPv6流量；
4、在WorkBuddy安装目录下查找config.json或network.conf文件，确认其中未强制指定prefer_ipv4: true类参数，避免应用层主动降级至IPv4。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、配置本地代理与DNS以保障双栈解析一致性
当WorkBuddy运行环境处于企业NAT或代理网关后时，DNS解析与出口IP协议族可能产生割裂（例如DNS返回AAAA记录但出口仅支持IPv4），导致连接失败。需统一解析与转发路径，确保A记录与AAAA记录查询均由同一双栈DNS服务器响应，且代理服务支持IPv6隧道封装。
1、在系统网络设置中将DNS服务器显式配置为支持双栈的公共DNS，例如2001:4860:4860::8888（Google IPv6 DNS）或240c::6666（腾讯DNSPod IPv6）；
2、若使用HTTP代理，确认代理软件（如Charles、Fiddler或企业Proxy Server）已启用IPv6监听，并在WorkBuddy配置中设置http_proxy环境变量指向http://[::1]:8888格式的IPv6回环地址；
3、在Windows PowerShell中运行Get-NetIPConfiguration | Where-Object {$_.NetAdapter.Status -eq "Up"} | ForEach-Object {$_.IPv6Address}，核验所有启用适配器均已分配全局IPv6地址且无重复地址冲突；
4、禁用Windows快速启动功能（控制面板 > 电源选项 > 选择电源按钮的功能 > 更改当前不可用的设置），防止IPv6邻居发现缓存残留导致双栈切换异常。
四、启用WorkBuddy多通道协议（MCP）的IPv6信令通道
WorkBuddy通过MCP协议与IM平台（如企业微信、飞书）建立指令信令通道。该通道默认优先尝试IPv6连接，若失败则回退至IPv4。为确保信令层面双栈可用，需在客户端配置中显式开启IPv6信令支持并验证其握手流程。
1、启动WorkBuddy后进入右上角“Claw设置 > 高级网络”，勾选“启用IPv6信令通道”选项；
2、在“企业微信”或“飞书”绑定界面完成OAuth授权后，观察日志窗口是否出现MCP handshake over IPv6 completed字样；
3、若日志显示fallback to IPv4 MCP transport，说明本地IPv6路由或目标IM平台Webhook端点尚未开放IPv6访问，此时应联系IM平台管理员确认其Webhook地址是否已发布AAAA记录；
4、在WorkBuddy任务执行过程中，使用Wireshark捕获本地环回接口（lo或Loopback）流量，过滤条件设为tcp.port == 8081 and (ip.version == 6)，确认信令请求确以IPv6协议发出。
