最小配置：连真实微信

dsh-weixin login     # 1) 扫码登录（凭证有效期由腾讯决定，本地自动续连）
dsh-weixin run       # 2) 开始监听（保持终端开着）

登录时终端会打印二维码链接：在手机微信里打开该链接并确认，几秒后配对成功；
微信「我 → 设置 → 插件」中添加「ClawBot/龙虾」插件即可（个人用户免白名单）；
配对成功后，直接在微信里给 Bot 发消息，DSH 就会收到并干活。

常用内置指令：

指令	作用
`/help`	指令列表
`/status`	连接剩余时间 + 当前会话与记忆条数
`/time`	本次连接剩余时间
`/sessions`	列出你的会话（记忆轮数 + 当前标记）
`/new`	新建命名会话并切换过去
`/switch`	切换会话（`main` 为默认会话）
`/clear [名字]`	清除当前（或指定）会话的对话记忆（工作目录文件保留）
`/reconnect`	手动重新连接
`/send [说明]`	把电脑上的文件发给你（绝对路径直接用；相对路径按当前会话的工作目录算；图片/视频按媒体发送，其余按文件发送）

每个微信联系人（from_user_id）有独立的 DSH 对话记忆与工作目录（data/workspaces/），跨轮次的文件操作结果持续保留；记忆按条数/字符双上限滚动裁剪。想让某个会话的工作目录指向别处（如代码仓库根目录）？见 Configuration 的「指定会话的工作目录」。

每个联系人还可拥有多个命名会话：默认会话 main（chatId = wx:，与旧版完全兼容）。 /new 新建并切换、/switch 切换、/sessions 列出；每个会话有独立的记忆流与工作目录， "当前会话"指针存于 data/sessions-registry/.json（缺失或损坏时自动回落 main）。

Configuration

所有选项为命令行参数，均有 DSH_WXBOT_* / DSH_BRIDGE_* 环境变量等价项：

选项	默认	说明
`--base-url`	`https://ilinkai.weixin.qq.com`	iLink 端点（测试时可指向 mock）
`--channel-version`	`2.4.6`	base_info.channel_version
`--bot-agent`	`dsh-wechat-bridge/…`	base_info.bot_agent（仅观测用途）
`--data-dir`	`./data`	凭证/记忆/工作目录根
`--auth-file`	`/weixin-auth.json`	🔒 登录凭证（含 bot token，勿外传）
`--allow-from`	全部	🔒 只响应指定用户 ID（逗号分隔，强烈建议设置）
`--reply-max-chars`	`3800`	单条回复截断上限
`--no-typing`	关	不发"正在输入"状态
`--session-ms` / `--relogin-before-ms`	24h / 2h	本地会话计时 / 计时到期前提醒提前量（实际有效性由腾讯服务器决定）
`--dsh-bin`	自动解析	DSH 可执行文件路径（找不到 `dsh` 时用）
`--timeout-ms` / `--max-turns` / `--max-history-chars`	同 bridge	DSH 调用超时 / 记忆条数上限 / 记忆字符上限

环境变量等价项：DSH_WXBOT_BASE_URL、DSH_WXBOT_AUTH_FILE、DSH_WXBOT_ALLOW_FROM、 DSH_WXBOT_REPLY_MAX、DSH_WXBOT_NO_TYPING、DSH_BRIDGE_*（DSH 层）。

指定会话的工作目录与权限（workspace 覆盖）

默认每个会话的 DSH 工作目录是 data/workspaces//。想让某个会话直接跑在别的目录（例如某个代码仓库根目录），在数据目录下放一个 workspace-overrides.json（值可以是纯字符串路径，也可以带权限的 { dir, permission } 对象）：

{
  "0bf36b275c23e653": {
    "dir": "D:\\path\\to\\your\\workspace",
    "permission": "danger-full-access"
  }
}

`` 即该会话默认工作目录名（safeKey(chatId) 前 16 位，可用 node weixin-bot.mjs chats 的「键」列查看，或直接看 data/workspaces/ 下的目录名）；
permission 可选：read-only / workspace-write / danger-full-access。不设则跟随 DSH 全局设置；danger-full-access（即 full access）表示不限制文件读写、不弹审批。桥接会以 DSH_PERMISSION_MODE 环境变量传给该会话的 DSH 进程；
配置后重启 dsh-weixin run 生效：该会话后续的 DSH 任务以覆盖路径为工作目录、以覆盖权限运行，/send 的相对路径也按它计算，sessions//status 显示的就是覆盖后的目录与权限；
也可用环境变量 DSH_BRIDGE_WORKSPACES（JSON 对象，临时覆盖）或代码内 buildConfig({ workspaces: {...} }) 传入；优先级：代码内 > 环境变量 > 配置文件；
文件在 data/ 下（已 gitignore），属本机配置，不会进入版本库。

通用桥接 bridge.mjs 另有 serve 子命令（HTTP 壳，端口默认 8317、绑定 127.0.0.1、可选 --token 🔒 鉴权），供 OpenClaw exec 工具、wechaty 等外部程序调用，详见 node bridge.mjs 帮助。

dsh-wechat-bridge

Other repositories with this package name

Install

README

最小配置：连真实微信

Configuration

指定会话的工作目录与权限（workspace 覆盖）