@chenacc/agentbridge
Control local coding agents from a phone through a secure WeChat QR web console.
インストール
検証済み bundle がないか、互換性チェックに失敗しています。先にリポジトリの説明を読んでください。 README 全文を読む ↗
ドキュメント
README 全文を読む ↗常用配置
完整变量见 .env.example。
桥本身:
| 变量 | 默认值 | 含义 |
|---|---|---|
AGENTBRIDGE_PORT | 8787 | HTTP 监听端口 |
AGENTBRIDGE_HOST | 0.0.0.0 | 监听地址 |
AGENTBRIDGE_PROJECTS | 当前目录 | 项目白名单,分号分隔 别名=绝对路径 |
AGENTBRIDGE_DATA_DIR | ~/.agentbridge(CLI / 插件)/ 启动目录(npm start) | 会话、事件、密钥、隧道状态的目录 |
AGENTBRIDGE_PUBLIC_ORIGIN | 自动(公网隧道或局域网地址) | 写进二维码的访问地址;设了它就不再自动开隧道 |
AGENTBRIDGE_ACCESS_KEY | 未设置 | 访问密钥;对公网开放时自动生成并写入 access-key 文件 |
AGENTBRIDGE_PAIRING_TTL_MS | 300000 | 配对码有效期(5 分钟) |
AGENTBRIDGE_SESSION_TTL_MS | 259200000 | 设备会话有效期(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_REMOTE | auto | 走哪条路径: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_ORIGIN | http://127.0.0.1:8787 | 插件连接的本地桥地址 |
AGENTBRIDGE_LOCAL_ORIGIN | http://127.0.0.1:8787 | CLI 连接的本地桥地址 |
AGENTBRIDGE_NO_AUTOSTART | 未设置 | 设为 1 关掉"插件加载时自动起桥" |
变量要设在真正启动 DSH Desktop / 终端的环境里,不是设在跑桥的另一个窗口里。