## 2026.1.8
### 重点更新
- **安全**: 各平台私信默认锁定;采用"先配对+白名单"模式。
- **沙箱**: 默认按智能体划分作用域 + 工作区访问控制;优化工具/会话隔离机制。
- **智能体循环**: 强化上下文压缩、修剪、流式传输及错误处理能力。
- **平台集成**: 提升Telegram/WhatsApp/Discord/Slack的可靠性,优化消息线程、表情回应、媒体处理和重试机制。
- **控制界面**: 新增日志标签页,提升流式传输稳定性,优化专注模式和大数据渲染问题。
- **命令行/网关/诊断工具**: 大幅扩展守护进程/日志/状态功能、认证迁移机制及诊断能力。
### 重要变更
- **【安全更新(请立即升级)】**:Telegram/WhatsApp/Signal/iMessage/Discord/Slack平台的**入站私信现默认锁定**。
- 此前若未配置白名单,机器人可能对**任何人开放**(尤其是可被搜索到的Telegram机器人)。
- 新默认策略:私信配对模式(`dmPolicy="pairing"` / `discord.dm.policy="pairing"` / `slack.dm.policy="pairing"`)。
- 如需保持原有"完全开放"模式:设置`dmPolicy="open"`并在相应平台的`allowFrom`字段中包含`"*"`(Discord/Slack平台需配置`discord.dm.allowFrom` / `slack.dm.allowFrom`)。
- 通过命令管理配对请求:`clawdbot pairing list --provider <平台名称>` 查看列表 + `clawdbot pairing approve --provider <平台名称> <验证码>` 批准请求(Telegram平台额外支持 `clawdbot telegram pairing ...` 命令)。
- **沙箱**: 将`agent.sandbox.scope`默认值设为`"agent"`(每个智能体分配独立容器/工作区)。如需会话级隔离请使用`"session"`;`"shared"`模式将关闭跨会话隔离。
- 智能体信封中的时间戳现统一采用UTC格式(精简为`YYYY-MM-DDTHH:mmZ`);移除`messages.timestampPrefix`配置项。新增`agent.userTimezone`参数用于向模型传递用户本地时区(仅系统提示词生效)。
- 模型配置架构调整(涉及认证配置文件和模型列表);网关启动时会自动迁移旧版配置,诊断工具也支持自动迁移。
- **命令系统**: 所有斜杠命令仅限授权用户使用;新增`/compact`命令用于手动压缩会话上下文。
- **群组管理**: `whatsapp.groups`、`telegram.groups`和`imessage.groups`配置项现作为白名单使用。如需保留允许所有群组的模式,请添加`"*"`。
- **自动回复**: 移除Discord/Slack/Telegram频道配置中的`autoReply`参数;改用`requireMention`控制(Telegram话题现支持单独配置`requireMention`覆盖全局设置)。
- **命令行接口调整**: 移除`update`、`gateway-daemon`、`gateway`系列子命令(包括install/uninstall/start/stop/restart/daemon status/wake/send/agent)及`telegram`命令;将`login/logout`移至`providers login/logout`(保留顶层别名但隐藏);服务控制请使用`daemon`,RPC操作请使用`send`/`agent`/`wake`,画布操作请使用`nodes canvas`。
### 问题修复
- **命令行/网关/诊断工具**: 优化守护进程运行时选择机制;完善日志/状态/健康检查/错误提示;改进本地CLI认证及密码处理;增强连接关闭/超时详情反馈;自动迁移旧版配置/会话/状态;增加完整性检查与修复提示;支持`--yes`/`--non-interactive`静默模式;新增`--deep`深度网关扫描;优化重启提示和服务指引。
- **智能体循环与上下文压缩**: 优化压缩/修剪策略,改进溢出处理,增强引导上下文安全性,完善各平台线程与确认机制;支持工具结果按需修剪,优化压缩追踪。
- **沙箱与工具**: 支持智能体级沙箱配置覆盖,完善工作区访问控制,细化会话工具可见性,优化工具策略覆盖,加强进程隔离,统一工具架构/超时/表情响应。
- **平台集成(Telegram/WhatsApp/Discord/Slack/Signal/iMessage)**: 优化重试与退避机制,完善消息线程处理,增强表情回应支持,改进媒体组/附件处理,强化提及权限控制,优化输入状态显示,提升错误/日志稳定性;Telegram长轮询与论坛话题隔离优化。
- **网关/命令行用户体验**: 新增`clawdbot logs`命令,优化定时任务列表颜色与别名,完善文档搜索功能,优化智能体增删改查流程,改进状态使用快照显示,增强运行时/认证来源展示,统一`/status`与命令的认证机制。
- **控制界面/Web端**: 新增日志标签页,优化专注模式界面,增强配置表单稳定性,提升流式传输可靠性,添加工具输出上限控制,实现聊天历史窗口化管理,优化重连机制与密码URL认证。
- **macOS/Android/终端UI/构建**: 修复macOS网关竞态条件,优化二维码打包,增强JSON5配置安全性,强化语音唤醒功能;Android端修复EXIF图片旋转问题,优化APK命名与版本管理;终端UI优化按键处理;修复工具链与打包问题。
- **打包与兼容性**: 完善npm发布目录覆盖,修复Node 25环境下的qrcode-terminal导入问题,优化Bun/Playwright/WebSocket补丁,改进Docker中Bun的安装流程。
- **文档**: 新增FAQ/ClawdHub/配置示例/案例展示;完善认证机制、沙箱功能和systemd部署文档。
### 维护更新
- 新增技能集成(Himalaya邮件客户端、CodexBar代码分析工具、1Password密码管理器)。
- 依赖库升级(pi-*技术栈、Slack SDK、discord-api-types、file-type文件类型识别库、zod验证库、Biome代码工具链、Vite构建工具)。
- 代码重构:集中化管理群组白名单与提及策略;优化代码规范与导入整理;将TS执行环境从tsx切换至bun。
## 2026.1.5
## 2026.1.8
### Highlights
- Security: DMs locked down by default across providers; pairing-first + allowlist guidance.
- Sandbox: per-agent scope defaults + workspace access controls; tool/session isolation tuned.
- Agent loop: compaction, pruning, streaming, and error handling hardened.
- Providers: Telegram/WhatsApp/Discord/Slack reliability, threading, reactions, media, and retries improved.
- Control UI: logs tab, streaming stability, focus mode, and large-output rendering fixes.
- CLI/Gateway/Doctor: daemon/logs/status, auth migration, and diagnostics significantly expanded.
### Breaking
- **SECURITY (update ASAP):** inbound DMs are now **locked down by default** on Telegram/WhatsApp/Signal/iMessage/Discord/Slack.
- Previously, if you didn’t configure an allowlist, your bot could be **open to anyone** (especially discoverable Telegram bots).
- New default: DM pairing (`dmPolicy="pairing"` / `discord.dm.policy="pairing"` / `slack.dm.policy="pairing"`).
- To keep old “open to everyone” behavior: set `dmPolicy="open"` and include `"*"` in the relevant `allowFrom` (Discord/Slack: `discord.dm.allowFrom` / `slack.dm.allowFrom`).
- Approve requests via `clawdbot pairing list --provider <provider>` + `clawdbot pairing approve --provider <provider> <code>` (Telegram also supports `clawdbot telegram pairing ...`).
- Sandbox: default `agent.sandbox.scope` to `"agent"` (one container/workspace per agent). Use `"session"` for per-session isolation; `"shared"` disables cross-session isolation.
- Timestamps in agent envelopes are now UTC (compact `YYYY-MM-DDTHH:mmZ`); removed `messages.timestampPrefix`. Add `agent.userTimezone` to tell the model the user’s local time (system prompt only).
- Model config schema changes (auth profiles + model lists); doctor auto-migrates and the gateway rewrites legacy configs on startup.
- Commands: gate all slash commands to authorized senders; add `/compact` to manually compact session context.
- Groups: `whatsapp.groups`, `telegram.groups`, and `imessage.groups` now act as allowlists when set. Add `"*"` to keep allow-all behavior.
- Auto-reply: removed `autoReply` from Discord/Slack/Telegram channel configs; use `requireMention` instead (Telegram topics now support `requireMention` overrides).
- CLI: remove `update`, `gateway-daemon`, `gateway {install|uninstall|start|stop|restart|daemon status|wake|send|agent}`, and `telegram` commands; move `login/logout` to `providers login/logout` (top-level aliases hidden); use `daemon` for service control, `send`/`agent`/`wake` for RPC, and `nodes canvas` for canvas ops.
### Fixes
- **CLI/Gateway/Doctor:** daemon runtime selection + improved logs/status/health/errors; auth/password handling for local CLI; richer close/timeout details; auto-migrate legacy config/sessions/state; integrity checks + repair prompts; `--yes`/`--non-interactive`; `--deep` gateway scans; better restart/service hints.
- **Agent loop + compaction:** compaction/pruning tuning, overflow handling, safer bootstrap context, and per-provider threading/confirmations; opt-in tool-result pruning + compact tracking.
- **Sandbox + tools:** per-agent sandbox overrides, workspaceAccess controls, session tool visibility, tool policy overrides, process isolation, and tool schema/timeout/reaction unification.
- **Providers (Telegram/WhatsApp/Discord/Slack/Signal/iMessage):** retry/backoff, threading, reactions, media groups/attachments, mention gating, typing behavior, and error/log stability; long polling + forum topic isolation for Telegram.
- **Gateway/CLI UX:** `clawdbot logs`, cron list colors/aliases, docs search, agents list/add/delete flows, status usage snapshots, runtime/auth source display, and `/status`/commands auth unification.
- **Control UI/Web:** logs tab, focus mode polish, config form resilience, streaming stability, tool output caps, windowed chat history, and reconnect/password URL auth.
- **macOS/Android/TUI/Build:** macOS gateway races, QR bundling, JSON5 config safety, Voice Wake hardening; Android EXIF rotation + APK naming/versioning; TUI key handling; tooling/bundling fixes.
- **Packaging/compat:** npm dist folder coverage, Node 25 qrcode-terminal import fixes, Bun/Playwright/WebSocket patches, and Docker Bun install.
- **Docs:** new FAQ/ClawdHub/config examples/showcase entries and clarified auth, sandbox, and systemd docs.
### Maintenance
- Skills additions (Himalaya email, CodexBar, 1Password).
- Dependency refreshes (pi-* stack, Slack SDK, discord-api-types, file-type, zod, Biome, Vite).
- Refactors: centralized group allowlist/mention policy; lint/import cleanup; switch tsx → bun for TS execution.
## 2026.1.5