chenacc1/agentbridge ↗★ 1

@chenacc/agentbridge

Control local coding agents from a phone through a secure WeChat QR web console.

Package
@chenacc/agentbridge
Compatibility
Unverified
Version
0.2.2
License
MIT
Last updated
Nov 8, 2026

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗

常用配置

完整变量见 .env.example。

桥本身:

变量默认值含义
AGENTBRIDGE_PORT8787HTTP 监听端口
AGENTBRIDGE_HOST0.0.0.0监听地址
AGENTBRIDGE_PROJECTS当前目录项目白名单,分号分隔 别名=绝对路径
AGENTBRIDGE_DATA_DIR~/.agentbridge(CLI / 插件)/ 启动目录(npm start)会话、事件、密钥、隧道状态的目录
AGENTBRIDGE_PUBLIC_ORIGIN自动(公网隧道或局域网地址)写进二维码的访问地址;设了它就不再自动开隧道
AGENTBRIDGE_ACCESS_KEY未设置访问密钥;对公网开放时自动生成并写入 access-key 文件
AGENTBRIDGE_PAIRING_TTL_MS300000配对码有效期(5 分钟)
AGENTBRIDGE_SESSION_TTL_MS259200000设备会话有效期(72 小时)
AGENTBRIDGE_CLAUDE_MODEL供应商默认可选的 Claude / Kimi 模型 ID
AGENTBRIDGE_NOTIFY_WEBHOOK未设置通知 Webhook;未设置时该功能静默
AGENTBRIDGE_NOTIFY_IMPORT未设置通知设置存在旧数据目录时,指向它一次即可自动迁过来

通知设置(webhook / token / 静默开关)保存在桥的数据目录下的 notify.json,默认是 %USERPROFILE%\.agentbridge。DSH 插件接管网关后数据目录换过位置,老配置如果留在原来的 .agentbridge 里,用 AGENTBRIDGE_NOTIFY_IMPORT= 启动一次就会自动迁过去;也可以直接在桌面控制台的「通知」面板重填一次。桥启动日志里有一行 Notifications: pushplus/clawbot 或 Notifications: off — no webhook configured in …,能直接看出它到底读到了哪个文件。

跨网络(CLI 与插件都认):

变量默认值含义
AGENTBRIDGE_REMOTEauto走哪条路径:auto / cloudflare / named / funnel / tailscale / zerotier / lan
AGENTBRIDGE_NO_TUNNEL未设置设为 1 等价于 AGENTBRIDGE_REMOTE=lan
AGENTBRIDGE_TUNNEL_URL未设置直接指定隧道域名(给"隧道自己管"的人)
AGENTBRIDGE_CLOUDFLARE_TUNNEL未设置Cloudflare 命名隧道的名字;设了它 auto 会优先用它
AGENTBRIDGE_CLOUDFLARE_HOSTNAME未设置命名隧道对应的公网域名
AGENTBRIDGE_CLOUDFLARED自动查找用你自己那份 cloudflared;设了它既不搜索也不下载
AGENTBRIDGE_CLOUDFLARED_URL官方 Releases换下载源(内网镜像),下载后照样过 --version 校验
AGENTBRIDGE_NO_DOWNLOAD未设置设为 1 禁止自动下载 cloudflared
AGENTBRIDGE_TAILSCALE自动查找指定 tailscale 可执行文件(装在非常规位置时用)
AGENTBRIDGE_ZEROTIER自动检测网卡直接指定 ZeroTier 分配到的 IPv4

插件 / CLI 专用:

变量默认值含义
AGENTBRIDGE_ORIGINhttp://127.0.0.1:8787插件连接的本地桥地址
AGENTBRIDGE_LOCAL_ORIGINhttp://127.0.0.1:8787CLI 连接的本地桥地址
AGENTBRIDGE_NO_AUTOSTART未设置设为 1 关掉"插件加载时自动起桥"

变量要设在真正启动 DSH Desktop / 终端的环境里,不是设在跑桥的另一个窗口里。