VibeAround
创建时间： 2026-05-07
来源： GitHub jazzenchen/VibeAround、本机 ~/.vibearound 运行日志
相关： Harness-Engineering，Agent-Native-Infrastructure，Vibe-Coding-to-Agentic-Engineering
VibeAround 是一个 local-first 的 AI coding agent 中控台：本地运行 Claude Code、Codex CLI、Gemini、Cursor CLI 等 agent，通过桌面 App、浏览器 dashboard、IM 频道和 tunnel 暴露出可远程访问的控制面。它的核心价值不是替代 agent，而是把 agent 会话、workspace、IM 通道、web terminal、handover/pickup 和公网访问统一起来。
关键机制
- 本地 dashboard 默认在
http://127.0.0.1:12358/va/。 - HTTP/WebSocket/MCP 本地端点由
~/.vibearound/auth.json中的 session token 保护；token 会随 daemon 启动轮换。 - IM 通道是插件化的，微信通过
weixin-openclaw-bridge插件扫码登录。 - Tunnel 只负责把本地 dashboard 暴露到公网；Cloudflare tunnel token 是运行 tunnel 的凭证，不是 VibeAround 的浏览器登录凭证。
公网浏览器配对
通过公网 URL 访问 dashboard 时，页面会调用 /va/api/pair/start 生成一次性 6 位 pairing code，并等待用户在任意已连接 IM 中发送：
/pair <code>配对码约 1 分钟过期，且只能匹配当前 dashboard 页面生成的待授权会话。/pair 123456 这样的示例码通常会返回 Invalid or expired pairing code，除非页面当时真的显示 123456。
常见故障
同 WiFi 下无法直接访问
VibeAround 文档说明 Rust daemon 监听 http://127.0.0.1:12358。如果访问 http://<电脑局域网IP>:12358/va/ 被拒绝，说明服务只绑定本机回环地址，手机即使在同一个 WiFi 下也不能直接访问。
可行替代方案：
- 只用微信控制 agent：不需要 dashboard tunnel，手机微信消息经 IM 插件进入本机 VibeAround。
- 使用 VibeAround 内置 tunnel provider：
localtunnel、ngrok或cloudflare。 - 使用本机反向代理/端口转发：让一个监听
0.0.0.0或局域网 IP 的代理转发到127.0.0.1:12358，再用手机访问代理端口。
局域网代理只应在可信网络中启用，并配合 VibeAround pairing/token 机制；不要把代理端口直接暴露到公网。
Invalid or expired pairing code
这个错误说明 IM 命令已经被 VibeAround 收到，但 code 没有匹配到当前待授权会话。常见原因：
- 发送的是示例码或旧码，而不是 dashboard 当前显示的 code。
- code 已超过约 1 分钟有效期。
- dashboard 页面刷新后生成了新 code，但 IM 里发送的是旧 code。
- 浏览器访问的不是同一个 VibeAround 实例或同一个公网入口。
- Cloudflare tunnel 只设置了
tunnel_token，但没有设置tunnel.cloudflare.hostname，导致公网入口没有正常启动。
Cloudflare hostname not set
如果日志出现：
cloudflare hostname not set: set tunnel.cloudflare.hostname in settings.json说明 ~/.vibearound/settings.json 中缺少 Cloudflare 公网域名。配置应包含：
"tunnel": {
"provider": "cloudflare",
"cloudflare": {
"tunnel_token": "...",
"hostname": "vibe.yourdomain.com"
}
}Cloudflare 侧还需要把该 hostname 的 route 指向本机服务：http://127.0.0.1:12358。