tlbox 文档

tlbox 把 AI 助手接进你常用的聊天工具（IM 接入），也让 Claude、Codex 这类 Agent 替你管理它（Agent 接入）。下面每一步都能在后台照着点出来。

快速开始

1. 注册登录：用邮箱、GitHub、谷歌或苹果账号登录 后台。新账号要填邀请码开通，邀请码在申请通过后的邮件里。
2. 接入一个号：在后台"总览"点新建，选渠道（个人微信、微信ClawBot、QQ、飞书、Slack 等），按弹窗里的引导做完。号接好后会出现在总览里，显示"在线"。 每个渠道的详细步骤见 IM 接入。
3. 调教助手：点进号，在"人设"里写好它的说话方式，在"提醒与定时任务"里设好要定时发的消息；然后在聊天里私聊它、或在群里 @ 它就行了。

几个说法

• 号：接进 tlbox 的一个聊天账号或机器人，比如一个个人微信、一个 QQ 机器人、一个飞书应用。一个账号下可以有多个号。
• 接收者：提醒、定时任务、推送地址里"发给谁"。后台的输入框会列出这个号的候选（管理员、监听的会话、最近聊过的群和人），选一个就行，也能直接输入。
• 管理员：号出事、定时任务失败时收通知的人，在号设置里填。

下载

需要装在电脑上的客户端，和给 Agent 用的说明文件都在这里。

tlbox-wx · 个人微信客户端

• Windows 电脑上运行，常驻任务栏托盘，可以开机自动启动。
• 有新版本时会提示，点一下就能更新。
• 更新微信前，先到 版本与更新日志 确认支持你要升级到的微信版本。

下载 tlbox-wx（Windows）

给 Agent 的 skill

一份 Markdown 说明，告诉 Agent 怎么用 tlbox 命令行。不用登录就能下载，用法见 给 Agent 的 skill。

下载 skill.md

IM 接入

IM 接入就是把 tlbox 接进一个聊天工具，接好的每个账号或机器人叫一个"号"。所有渠道都从同一个入口开始：后台"总览" → 新建 → 选渠道。

所有渠道都一样的

• 号接好后出现在"总览"，卡片上能看到在线状态、今天的消息数、下一个提醒。
• 能聊天、记得上下文，能设提醒和定时任务、做总结；人设和技能都能自己配，具体回复风格在"人设"里调。
• 个人微信和微信ClawBot 的号还能看图、读文件。
• 同一个应用或微信号再接一次只会更新登录或凭据，不会多出一个号。
• 号只属于接入它的那个账号，别人看不到、也用不了。

个人微信

用你自己的微信号当助手：装上客户端、登录，tlbox 就能在你选定的群和好友里回复。

能做什么

• 接管你选定的群和好友：群里 @ 它、私聊找它都能回复，回复方式可以选 @ 回复、拍一拍、引用回复。
• 收发文字、图片和文件，看得懂图片、PDF 和链接内容。
• 在后台的"聊天"页直接以这个号的身份发消息、发文件。
• 按时发提醒和定时任务，能自动通过好友申请。

准备

• 一台常开的 Windows 电脑，装好电脑版微信。
• tlbox 账号（和后台用同一个）。

步骤

1. 后台"总览" → 新建 → 个人微信，点下载，或者直接 下载 tlbox-wx，安装后打开。
2. 在客户端里用 tlbox 账号登录（可以在浏览器里登录，登完自动回到客户端）。
3. 登录电脑版微信（第一次要用手机扫码）。
4. 在客户端点开始监听。默认会自动开始监听，已经在监听就不用再点。
5. 确认客户端显示"微信已连上"。
6. 回到后台，号会自动出现在"总览"里。打开 微信管理 → 监听，添加要监听的会话（交给 AI 的群和好友）。

怎么确认接好了

• "总览"里号的卡片显示"在线"，"微信管理 → 运行状态"里微信在线、监听已开。
• 在监听的群里 @ 它说一句话，几秒内会回复。

常见问题

• 后台显示离线：先看那台电脑开着没有、客户端在不在运行。微信掉线了可以在"微信管理 → 运行状态"里重新登录，需要扫码时那里会给二维码。
• 群里 @ 了不回：确认这个群在"监听"列表里、状态是正常；不正常就点测活或重置。
• 想升级微信：先看 版本与更新日志，确认 tlbox-wx 支持新版本再升级。
• 出问题要排查：在客户端点"上报日志"，日志默认脱敏，上报后在后台"我上报的日志"里能看到。

个人微信客户端由第三方维护，不是微信官方提供的工具。使用前请阅读并遵守微信的用户协议，由此产生的风险由使用者自行承担。

微信ClawBot

不用装客户端：在后台用微信扫个码就绑好，之后在微信里私聊机器人就行。

能做什么

• 在微信里私聊机器人，记得上下文，会看图、读文件。
• 到点给你发提醒、按时发定时任务的内容。
• 推送地址（Webhook）发给你自己，适合收告警和通知。

准备

• 手机上登录着的微信。

步骤

1. 后台"总览" → 新建 → 微信ClawBot，点开始，页面上出现二维码。
2. 用手机微信扫码，并在手机上确认。
3. 页面提示绑定成功后，号出现在"总览"里。二维码 5 分钟内有效，过期了点重新获取。

怎么确认接好了

• "总览"里号的卡片显示"在线"。
• 在微信里给它发一句话，它会回复。

常见问题

• 提醒、定时任务的接收者里只有"你（管理员）"：机器人只能发给给它发过消息的人。扫码绑定的就是你自己，选"你（管理员）"即可；想发给别人，先让对方给它发一条消息。
• 显示离线了：回到"新建 → 微信ClawBot"再扫一次码，会更新登录，不会多出一个号。

QQ

在 QQ 开放平台建一个官方机器人，把 AppID、AppSecret 填到 tlbox，再把 tlbox 给的回调地址填回 QQ。

能做什么

• 私聊机器人，或在群里、频道里 @ 机器人，它会回复。
• QQ 群里机器人只收得到 @ 它的消息，这是平台的限制；群里不 @ 它的话它看不到。

准备

• 能登录 QQ 开放平台 并创建机器人的 QQ 账号。

步骤

1. 打开 q.qq.com/qqbot，创建一个机器人。
2. 在机器人的「开发 → 开发设置」里拿到 AppID 和 AppSecret。
3. 后台"总览" → 新建 → QQ，填这几项后提交：
   • AppID、AppSecret：上一步拿到的；
   • 管理员的 QQ openid：可不填。接收通知的人，号接好后私聊机器人一句，就能在接收者下拉里找到自己。
4. 提交成功后页面上会显示回调地址 https://tlbox-api.someget.xyz/channel/qq，所有 QQ 机器人都填这一个地址，点复制。
5. 回到 QQ 开放平台「开发 → 回调配置」，把回调地址填进去，并勾选这三个事件：
   GROUP_AT_MESSAGE_CREATEC2C_MESSAGE_CREATEAT_MESSAGE_CREATE
   分别是群里 @ 机器人、单聊、频道里 @ 机器人。
6. 在沙箱配置里加上测试用的群和成员先试；要给更多人用，提交审核并发布上线。

怎么确认接好了

• "总览"里出现这个机器人，显示"在线"。
• 在沙箱群里 @ 它，或私聊它一句，它会回复。

常见问题

• 提交时说凭据不对：确认 AppID、AppSecret 复制完整；AppSecret 重置过的话填新的。
• 群里说话它不理：QQ 群里要 @ 它才收得到；也确认这个群在沙箱里，或者机器人已经发布上线。
• 号显示"凭据已失效"：多半是 AppSecret 重置了。重新"新建 → QQ"填一次新凭据就行，回调地址不变。

飞书

在飞书（或国际版 Lark）里建一个企业自建应用，把凭据填到 tlbox，再把 tlbox 给的回调地址填回飞书，就接好了。

能做什么

• 私聊机器人，或在群里 @ 机器人，它会回复。
• 到点发提醒、按时发定时任务，接收者可以是群，也可以是人。
• 推送地址（Webhook）把脚本、告警的消息发进飞书群。

准备

• 能在飞书开放平台创建企业自建应用的账号（一般是企业管理员或被授权的开发者）。
• 知道你用的是飞书（open.feishu.cn）还是 Lark（open.larksuite.com），新建时要选对。

步骤

1. 打开 飞书开发者后台（Lark 用 open.larksuite.com/app）→ 创建企业自建应用，在「应用能力」里添加机器人。
2. 在「权限管理」里开通下面这些权限，然后创建版本并发布：
   im:message:send_as_botim:message.p2p_msg:readonlyim:message.group_at_msg:readonlyim:resourcecontact:user.base:readonlyim:chat:readonly
3. 后台"总览" → 新建 → 飞书，填这几项后提交：
   • 版本：飞书或 Lark；
   • App ID（cli_ 开头）、App Secret：在「凭证与基础信息 → 应用凭证」；
   • Verification Token、Encrypt Key：在「事件与回调 → 加密策略」。Encrypt Key 配了就要填，没配就留空（建议配上）；
   • 管理员的 open_id（ou_ 开头）：可不填，提醒、定时任务的通知发给他，以后也能在号设置里改。
4. 提交成功后页面上会显示回调地址（形如 https://tlbox-api.someget.xyz/channel/lark/…），点复制。
5. 回到飞书「事件与回调 → 事件配置」，订阅方式选「将事件发送至开发者服务器」，把回调地址填进请求地址并保存，校验会自动通过； 再添加事件 im.message.receive_v1（接收消息），然后重新发布版本。

怎么确认接好了

• "总览"里出现这个应用，显示"在线"。
• 在飞书里搜到机器人私聊它一句，或把它拉进群后 @ 它，它会回复。

常见问题

• 提交时说 App ID 或 App Secret 不对：确认复制完整，也确认"版本"选对了飞书还是 Lark。
• 提示还没开启机器人能力：在「应用能力 → 机器人」里开启，并发布一个版本。
• 保存请求地址时校验不过：确认 Verification Token、Encrypt Key 和飞书后台「加密策略」里的一致；改了就回 tlbox 重新提交一次凭据。
• 私聊能回、群里不回：群里要 @ 机器人才会回复；也确认开通了 im:message.group_at_msg:readonly 并重新发布了版本。
• 号显示"凭据已失效"：多半是 App Secret 重置了。重新"新建 → 飞书"填一次新凭据就行，回调地址不变，飞书那边不用改。

Slack

在 Slack 建一个 App 装进你的工作区，把凭据填到 tlbox，再把 tlbox 给的回调地址填回 Slack。

能做什么

• 私聊机器人，或在频道里 @ 机器人，它会回复。
• 到点发提醒、按时发定时任务，接收者可以是频道，也可以是人。
• 推送地址（Webhook）把脚本、告警的消息发进 Slack 频道。

准备

• 能在工作区里安装 App 的 Slack 账号。

步骤

1. 打开 api.slack.com/apps → Create New App → From scratch，选你的工作区。
2. 在 OAuth & Permissions → Bot Token Scopes 加上下面这些权限，然后点 Install to Workspace：
   chat:writefiles:writeim:historyapp_mentions:readusers:readchannels:read
   再到 App Home 打开 Messages Tab，勾上允许用户给 App 发消息。
3. 后台"总览" → 新建 → Slack，填这几项后提交：
   • Bot User OAuth Token（xoxb- 开头）：OAuth & Permissions 页面，安装到工作区后出现；
   • Signing Secret：Basic Information → App Credentials；
   • 管理员的 Slack 用户 ID（U 开头）：可不填。在 Slack 里点开自己的资料 → ⋮ → 复制成员 ID。
4. 提交成功后页面上会显示回调地址（形如 https://tlbox-api.someget.xyz/channel/slack/…），点复制。
5. 回到 Slack 的 Event Subscriptions，打开 Enable Events，把回调地址填进 Request URL，显示 Verified 就对了； 在 Subscribe to bot events 里加上 message.im 和 app_mention，保存后按提示重新安装 App。

怎么确认接好了

• "总览"里出现这个 App，显示"在线"。
• 在 Slack 的 Apps 里找到它私聊一句，或在频道里邀请它进来后 @ 它，它会回复。

常见问题

• 提示 Token 应该以 xoxb- 开头：复制的是 Bot User OAuth Token，不是 User Token 或 App-Level Token。
• 提示缺少 users:read 权限：在 OAuth & Permissions 里加上后重新安装 App。
• 频道里 @ 了不回：先在频道里 /invite 这个 App；也确认订阅了 app_mention 事件并重新安装了。
• 号显示"凭据已失效"：Token 被撤销或 App 被卸载了。重新安装后，回 tlbox 重新"新建 → Slack"填一次，回调地址不变。

Agent 接入

Agent 接入是反过来：让 Muse、GrokBot、Codex、Claude 这类 Agent 替你管理 tlbox。你说"明早 9 点提醒产品群交周报"，Agent 就用 tlbox 命令行帮你设好。

三样东西

• API token：在后台生成，代表你本人（普通用户权限），Agent 带着它调用。
• tlbox 命令行：Agent 执行的命令，常用的日常管理都能做，见下面的列表。
• skill.md：给 Agent 看的说明书，告诉它有哪些命令、怎么安全地用。

Agent 能做什么

• 看名下的号和在线状态。
• 以号的身份发消息、发文件，看聊天记录。
• 加、删提醒和定时任务，马上跑一次定时任务。
• 看和改人设，管理监听列表和推送地址，看自己上报的日志。

Agent 不能做什么

• 生成、删除 API token。
• 接入新的号（扫码、填应用凭据）：要本人登录后台操作。
• 管理员功能（账号、模型、全局技能等）：管理员的 token 也不行。
• 这些都要你自己登录后台操作。

只想让脚本或 Agent 往聊天里发一句话、不需要管理后台的话，用更简单的 推送地址。

生成 API token

1. 登录后台，打开 Agent 接入 页。
2. 点新建，给 token 起个名字，比如"家里的 Claude"，方便以后认出是哪一个。
3. 完整的 token（tlb_ 开头）只显示这一次，马上复制保存。之后列表里只显示 tlb_… 加最后 4 位。

• token 只有你本人的普通用户权限：只能管你名下的号，管理员的 token 也调不了管理员功能。
• 每人最多 10 个 token，不用的随时删掉，删了立刻失效。
• 列表里能看到每个 token 的创建时间和最后使用时间。
• 建议每个 Agent、每台电脑用单独的 token，泄露了只删那一个。

tlbox 命令行

安装和配置

1. 安装 tlbox 命令行（需要 Python 3.10 以上），装好后有一个 tlbox 命令：

   uv tool install https://tlbox-api.someget.xyz/agent/tlbox_cli-0.1.0-py3-none-any.whl
   # 或者用 pipx
   pipx install https://tlbox-api.someget.xyz/agent/tlbox_cli-0.1.0-py3-none-any.whl

   当前版本号和下载地址可以在 https://tlbox-api.someget.xyz/agent/cli.json 查到，里面的 wheel 就是最新的安装地址。
2. 设置环境变量：

   export TLBOX_TOKEN=tlb_...        # 必填：后台生成的 API token
   export TLBOX_BOT=<号>            # 可选：默认操作的号，省得每条命令写 --bot
   export TLBOX_SERVER=https://tlbox-api.someget.xyz   # 可选，默认就是这个

3. 跑一下 tlbox bots list，能列出你的号就对了。

通用约定

• --bot <号>：大多数命令要指定号，号就是 tlbox bots list 里的 bot_id；设了 TLBOX_BOT 可以省掉。
• --to：发给谁，填接收者的 ID：用 tlbox receivers 列出的 uid，或 tlbox chats 里的 chat_id。个人微信的 ID 就是群名或好友昵称，可以直接写。
• --json：每个命令都认，输出原始 JSON，给 Agent 解析用。
• 时间一律写带时区的 ISO-8601，如 2026-10-12T09:00:00+08:00。
• 退出码：0 成功，1 出错，2 危险操作没带 --yes（什么都没做）。

命令一览

带 --yes 的是危险操作，不带 --yes 只打印将要做什么。

示例里省略了 --bot，默认用 TLBOX_BOT。发消息、监听、微信相关的命令目前只有个人微信的号能用。每个命令加 -h 看完整参数。

给 Agent 的 skill

skill.md 是一份写给 Agent 看的说明：有哪些命令、怎么指定号和接收者、出错了怎么跟你说、哪些操作要先问你。不用登录就能下载：

打开 /agent/skill.md

两种用法

• 放进 Agent 的 skill 目录：支持 skill 的 Agent，把文件存成它 skill 目录下的 tlbox/SKILL.md，Agent 会在你提到 tlbox、提醒、发消息时自动用上。
• 直接把链接发给 Agent：不支持 skill 的，在对话里说"先读一下 https://tlbox-api.someget.xyz/agent/skill.md，再帮我……"。

skill 里约定了什么

• 先用 --json，解析 JSON，不解析表格。
• 危险操作（删提醒、删定时任务、删推送地址、删人设、重启或退出微信）先问你，你同意了才带 --yes。
• 改人设前把新旧内容给你看一眼。
• 出错时把错误原因原样转告你，不反复重试；token 失效时让你去后台重新生成。

接到各个 Agent

做法都一样：让 Agent 能执行 tlbox 命令、拿到 TLBOX_TOKEN、读到 skill.md。下面是各家的常见做法，具体以对应产品的说明为准。

Claude

• 在 Claude Code 这类能执行命令的环境里用：装好 tlbox 命令行，在启动 Claude 的终端里设好 TLBOX_TOKEN。
• 把 skill.md 存成 ~/.claude/skills/tlbox/SKILL.md（只给一个项目用就放项目里的 .claude/skills/tlbox/SKILL.md）。
• 试试："用 tlbox 看看我有哪些号"。

Codex

• 装好 tlbox 命令行，在启动 Codex 的终端里设好 TLBOX_TOKEN。
• 把 skill.md 存成 ~/.codex/skills/tlbox/SKILL.md；也可以把链接写进项目的 AGENTS.md，让它用到时去读。
• Codex 默认在沙箱里跑命令，如果连不上网络，要允许 tlbox 命令联网。

Muse

• 如果 Muse 能执行命令行：装好 tlbox 命令行、设好 TLBOX_TOKEN，把 skill.md 按它的方式加成技能或工具说明。
• 不能加技能时，在对话开头把 skill.md 的链接发给它，让它先读。

GrokBot

• 和 Muse 一样：运行环境里有 tlbox 命令和 TLBOX_TOKEN，再把 skill.md 当作说明交给它。
• 只需要往聊天里发通知、不需要管理后台的话，直接给它一个 推送地址 更省事。

ESP32 硬件小 Agent 即将支持

• 像立创实战派 ESP32-S3（N16R8）这类带屏幕、麦克风和喇叭的桌面语音开发板，如果已经刷了 Muse Gadget SDK 或 GrokBot，直接让它背后的 Muse / GrokBot 按上面的方式接上 tlbox，对着板子说话就能查群消息、设提醒。
• 只需要开发板按键或传感器触发往群里报信的话，在固件里用 HTTP POST 调一个 推送地址 就行。
• 开发板直接带 TLBOX_TOKEN 走轻量 HTTP / WebSocket 长连接、收发语音和群消息播报的直连协议正在接入中。

其他 Agent

• 能跑命令的：照上面的三步做。
• 只能发 HTTP 请求的：用推送地址发消息。

推送地址（Webhook）

每个号都能生成专属的推送地址：一个 HTTP 请求，就由这个号把一条消息发给指定的群或人。适合部署脚本、监控告警，或者让 Agent 往聊天里说话。

生成地址

1. 后台左边菜单打开 Webhook，点新建。
2. 选用哪个号发、发给谁（接收者），可以写个备注，比如"部署通知"。
3. 完整地址只在生成时显示一次，马上复制保存。也可以用命令行 tlbox webhooks add 生成。

发送消息

# 最简单的写法
curl -X POST '<后台给你的完整地址，形如 https://…/hook/一串字符>' \
  -H 'Content-Type: application/json' \
  -d '{"text": "部署完成 ✅"}'

请求体支持这几种写法：

• {"text": "内容"}，或者 {"content": "内容"}
• 飞书机器人的格式：{"msg_type": "text", "content": {"text": "内容"}}，原来发飞书的脚本改个地址就能用
• 直接把文字作为请求体

成功返回 {"code": 0, ...}。

限制和管理

• 消息太长或发得太频繁会返回错误，请求失败时看返回里的 message，稍等一会儿再试。
• 后台能看到每个地址最近的调用记录，也能临时停用。
• 地址泄露了点重新生成，旧地址立刻失效；不用了就删掉。

安全

• token 只显示一次：API token 和推送地址都只在生成时完整显示，服务器上只存摘要，找不回来；丢了就删掉重建。
• token 是你本人的普通用户权限：只能管你自己名下的号；就算你是管理员，token 也调不了管理员功能。拿到它的人能替你发消息、改设置，别贴进公开仓库、截图或聊天记录，建议放在环境变量里。
• 危险操作要 --yes：删提醒、删定时任务、删推送地址、删人设、重启或退出微信，不带 --yes 只打印将要做什么，什么都不做。skill 也要求 Agent 先问你。
• 怎么撤销：后台 Agent 接入 页删掉对应的 token，立刻失效；推送地址在 Webhook 页重新生成或删除。
• 管理不了 token：用 API token 不能生成、删除 token，就算 token 泄露，你在后台删掉它就行。
• 看"最后使用时间"：不认识的使用记录，删掉那个 token。

消息怎么传输和保存

• 个人微信：tlbox-wx 客户端与服务端之间端到端加密（每条连接单独协商密钥），外层再走 HTTPS/TLS。端到端加密只限客户端到服务端这一段。
• 其余平台（微信ClawBot、QQ、飞书、Slack 等）：平台到服务端、后台到服务端 HTTPS/TLS 加密传输。
• 服务端需要处理消息内容才能提供记录、总结和回复。记录哪些消息由你按号决定，见 消息记录。
• 我们尽最大努力保护你的数据。请勿通过机器人传输重要商业或敏感内容；如果不接受，请不要打开全量消息记录。

后台各页面

左边菜单分三组：我的号（总览）、当前号（聊天、人设、消息记录、提醒与定时任务，个人微信的号还有微信管理，填凭据接入的号（飞书、Slack、QQ 等）还有接入设置；跟着顶部选中的号走）、我的设置（我的技能、Webhook、Agent 接入、我上报的日志）。顶部可以随时切换号，切过去还停在同一页。

总览

• 名下所有号的卡片：渠道、在线状态、今天的消息数、最近活跃、下一个提醒。
• 点卡片进入这个号的聊天页。
• 右上角新建：先选渠道，再按引导接入，见 IM 接入。
• 离线的号卡片上会写原因，比如凭据失效、电脑客户端没连着。

聊天

• 左边是会话列表，右边是聊天记录，往上滚自动加载更早的消息。
• 可以按关键词搜，被 @ 的消息会标出来。
• 点发送者的名字，看 AI 记下的这个人的画像。
• 个人微信的号还能直接在这里发消息、发文件、引用、拍一拍和 @ 人。

人设

• 写这个号说话的方式（prompt），写 {name} 会换成号的昵称；还能填语音风格。
• 三层，越具体越优先：某个群或人单独的 → 这个号的默认 → 名下所有号共用的。
• 选聊天模型：在管理员开放的模型里选，"默认"跟着平台的主力模型走。
• 改完立刻对之后的回复生效。

消息记录

• 每个号一个全量消息记录开关：关着时只记 @ 机器人的消息和私聊；打开后，群里没 @ 它的消息也会记下来，用来做总结和接上下文。
• 个人微信：默认开，记录监听的会话里的消息。
• 微信ClawBot：只记和管理员（扫码绑定的那个微信）的私聊，没有群消息可记。
• QQ、飞书、Slack：默认只记 @ 机器人的消息和私聊。
• QQ 不支持全量记录：群里机器人只收得到 @ 它的消息，这是平台的限制，开关是置灰的。
• 飞书打开前要在开放平台开通「获取群组中所有消息」权限（im:message.group_msg），并重新发布版本。
• Slack 打开前要给 App 加 channels:history 权限、订阅 message.channels 事件（私有频道是 groups:history 和 message.groups），然后重新安装。
• 数据怎么保护见 安全。

提醒与定时任务

• 提醒：一次性的，到点由这个号给一个接收者发一句话，群里还可以 @ 人。在聊天里让 AI 设的提醒也在这里。
• 定时任务：按时跑内置的任务（比如每天的早报），发给一个或多个接收者；可以每天定点跑，也可以只跑一次。
• "每天"的时间可以选北京时间或美中时间。
• 定时任务可以点"马上跑一次"试试效果；跑失败会通知号的管理员。
• 接收者从下拉里选，也可以直接输入。

微信管理 只有个人微信的号有

• 运行状态：微信在不在线、监听开没开、微信版本；掉线时在这里重新登录，需要扫码时这里给二维码。也能重启、退出微信。
• 监听：哪些群和好友的消息交给 AI。能看每个监听健康不健康，测活、重置、移除、添加。
• 微信设置：私聊轮询、自动通过好友申请、个人找 AI 的频率限制、群里不 @ 也交给 AI 的消息（链接、PDF、图片、笔记）。
• 群回复方式：@ 回复、拍一拍、引用回复，勾几个就在其中随机挑。
• 电脑离线时设置也能改，下次连上时生效。

接入设置 填凭据接入的号（飞书、Slack、QQ 等）有

• 回调地址：新建弹窗关掉了也不要紧，在这里随时复制，填回飞书、Slack 的事件订阅或 QQ 的回调配置。
• 管理员：改接收通知的人（飞书的 open_id、Slack 的用户 ID、QQ 的 openid）。
• 重填凭据：App Secret、Token 重置了就在这里填新的，回调地址不变。

我的技能

• 自己装的技能：一条命令加一句说明，AI 觉得用得上时会去跑，参数写成 {名字}。
• 可以只给某几个号用，不选就是名下所有号都能用（以后新加的号也算）。
• 在聊天里让 AI "把这个命令存成技能"，也会出现在这里。
• 命令在单独的沙箱里跑：没有你的密钥，只能访问公网。
• 只有你自己名下的号能用，别人看不到。

Webhook

• 新建推送地址：选号和接收者，地址只显示一次。
• 每个地址能看最近的调用记录，能停用、启用、重新生成、删除。
• 用法见 推送地址。

我上报的日志

• 在个人微信客户端里点"上报日志"交上来的日志，按时间列出来，能下载。
• 默认脱敏：聊天内容、群名和昵称都去掉了；关了脱敏上报的会标出来。
• 日志保留 30 天。排查问题时可以把日志时间告诉我们。

Agent 接入 在"我的设置"里

• 生成 token：起个名字就能生成，完整的 token 只显示这一次。
• 撤销 token：列表里能看每个 token 的创建和最后使用时间，删掉立刻失效。
• 复制给 Agent 的说明：一键复制安装命令行、设环境变量和读 skill.md 的说明，直接发给你的 Agent。详见 Agent 接入。

版本与更新日志

tlbox-wx（个人微信客户端）各版本支持的微信版本。微信升级后，请先确认这里列着你的微信版本，再更新微信。

更新日志

0.3.2 2026-10-20

• 修复安装版一启动就退出、版本号读不到的问题

0.3.1 2026-10-19

• 首个生产版本：登录切到正式环境

常见问题

注册时收不到验证码？

验证码 10 分钟内有效。等了一会儿还没收到，先看看垃圾邮件箱，可能被误判了；还是没有就点"重新发送"。

登录后让我填邀请码？

新账号要开通才能用。没有邀请码就先提交申请，通过后邀请码会发到你的邮箱。

号显示离线怎么办？

• 个人微信：看那台电脑和客户端开着没有，再到"微信管理 → 运行状态"里重新登录。
• 微信ClawBot：重新"新建 → 微信ClawBot"扫一次码。
• QQ、飞书、Slack：卡片上写着"凭据已失效"时，重新"新建"填一次凭据，回调地址不变。

群里 @ 了不回？

• 个人微信：确认这个群在"监听"列表里、状态正常。
• QQ、飞书、Slack：确认机器人已经在群（频道）里，事件订阅填好了并重新发布或重新安装过。QQ 群里要 @ 它才收得到。

提醒、定时任务的"发给谁"填什么？

从下拉里选：这个号的管理员、监听的会话、最近聊过的群和人都在里面。也可以直接输入：个人微信填群名或好友昵称；飞书、Slack 填群或用户的 ID，QQ 填群或用户的 openid。

一个账号能接几个号？

可以接多个，不同渠道也能混着接，都在"总览"里，顶部切换。

API token 或推送地址泄露了？

到后台删掉那个 token，或者把推送地址重新生成，旧的立刻失效。见 安全。

联系我们

有问题或建议，发邮件到 [email protected]。