AnyBot

2. Provider 前置依赖

以及至少配置一个 Provider：

桌面 App 不要求用户手动安装 Node.js；只有源码运行或开发时才需要 Node.js 和 npm。

快速开始

1. 安装桌面 App（推荐）

从 GitHub Releases 下载对应平台的安装包：

启动后会自动打开 AnyBot 桌面窗口。Provider、模型、权限、代理和频道都可以在设置中配置。

Windows 安装版支持在 设置 -> 关于 -> 检测更新 中检查新版本；macOS 暂时请手动下载新版 .dmg 覆盖安装。

macOS 提示“应用已损坏，无法打开”

由于 macOS 的安全机制，非 App Store 下载的应用可能会触发此提示。如果你确认安装包来自 AnyBot 的 GitHub Releases，可以在终端执行以下命令清除隔离标记：

sudo xattr -rd com.apple.quarantine "/Applications/AnyBot.app"

如果你的 Applications 中应用名显示为 Anybot.app，请把命令里的路径改成实际名称。

3. 源码运行

源码运行需要先安装：

<details> <summary><b>Windows 安装指南</b></summary>

1. 从 Node.js 官网下载安装 LTS 版本。
2. 安装 Git for Windows，或使用你已有的 Git 环境。
3. 在 PowerShell / Windows Terminal 中运行后续命令。

</details>

<details> <summary><b>Linux 安装指南</b></summary>

Ubuntu / Debian：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS / RHEL / Fedora：

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs   # Fedora 用 dnf

使用 nvm（推荐，不需要 sudo）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc   # 或 source ~/.zshrc
nvm install --lts

</details>

<details> <summary><b>macOS 安装指南</b></summary>

brew install node

</details>

git clone https://github.com/1935417243/AnyBot.git
cd AnyBot
npm install
npm start

启动后打开 http://localhost:19981 即可使用 Web UI。Provider、模型、权限、代理和频道都在 Web UI 中配置。

4. 后台运行

```bash

后台运行（daemon）

npm run bot:start

使用方式

• 私聊 — 直接发消息给机器人
• 群聊 — 默认仅 @ 机器人时回复（可改为回复所有消息）
• 发送图片 — 自动下载并交给 Provider 处理
• 回复中的图片 / 文件会自动上传回飞书（单文件上限 30MB）
• 支持所有聊天命令（见下方聊天命令）

---

使用方式

• 频道消息 — 在 QQ 频道中 @ 机器人
• 群聊 — 在群中 @ 机器人发送消息
• 私聊 — 直接给机器人发消息
• 支持所有聊天命令（见下方聊天命令）

---

使用方式

• 私聊 — 直接给机器人发消息
• 群聊 — 在群里 @ 机器人后发送消息
• 图片消息 — 自动下载图片并交给 Provider 处理，caption 会一并作为上下文
• 长回复拆分 — 超过 Telegram 单条消息长度时自动分段发送
• 支持所有聊天命令（见下方聊天命令）

---

使用方式

• 私聊 — 直接用绑定的个人微信收发文本、图片和文件消息
• 主动推送 — /api/send 可使用 { "channel": "weixin", "message": "..." }
• 图片会下载后转给 Provider 进行多模态理解；回复中的本地图片路径和 FILE: 文件会通过微信 CDN 加密上传后发送
• 支持所有聊天命令（见下方聊天命令）

---

截图预览

---

飞书侧配置

在 飞书开放平台 创建应用后：

1. 开启 机器人 能力
2. 开启 长连接模式 的事件订阅
3. 订阅事件 im.message.receive_v1
4. 授予 发送消息 权限
5. 如需处理图片消息，还需授予 读取消息资源 相关权限
6. 发布应用

连接配置

频道配置保存在 .data/channels.json，有三种方式管理：

<details> <summary><b>channels.json 完整字段说明</b></summary>

{
  "feishu": {
    "enabled": true,
    "appId": "cli_xxxx",
    "appSecret": "xxxx",
    "groupChatMode": "mention",   // "mention"（仅 @机器人时回复）或 "all"（所有消息都回复）
    "botOpenId": "ou_xxxx",       // 可选；mention 模式下用于精确判断是否 @了机器人
    "ackReaction": "OK",          // 收到消息后的 reaction 表情，留空可关闭
    "ownerChatId": "oc_xxxx"      // 可选；用于 /api/send 主动推送消息的目标聊天 ID
  },
  "qqbot": {
    "enabled": true,
    "appId": "your_app_id",
    "appSecret": "your_app_secret",
    "ownerChatId": ""             // 可选；主动推送的目标聊天 ID
  },
  "telegram": {
    "enabled": true,
    "token": "1234567890:AA...",
    "ownerChatId": ""             // 可选；主动推送的目标 chat ID
  },
  "weixin": {
    "enabled": true,
    "accountId": "",              // 扫码绑定后自动填入
    "token": "",                  // 扫码绑定后自动填入
    "baseUrl": "https://ilinkai.weixin.qq.com",
    "botType": "3",
    "botAgent": "AnyBot/0.1.0",
    "ownerChatId": ""             // 可选；扫码用户或首次来信用户会自动填入
  }
}

</details>

连接配置

与飞书相同，通过 Web UI、REST API 或 .data/channels.json 中的 qqbot 字段配置 App ID / App Secret。

连接配置

与其它频道相同，可通过以下方式配置 telegram.token：

连接配置

1. 在 Web UI 的“频道”页面启用“微信”，或编辑 .data/channels.json 中的 weixin.enabled 为 true
2. 重启 AnyBot
3. 终端会显示二维码，用个人微信扫码并在手机上确认
4. 扫码成功后，weixin.accountId、weixin.token 和 ownerChatId 会自动写回配置

如果登录态失效，清空 weixin.token 后重启服务即可重新扫码绑定。

代理配置

代理功能当前暂时关闭。历史配置会保留在 .data/proxy.json，但应用启动、保存配置和导入配置时都不会再向 Provider 注入 HTTP_PROXY / HTTPS_PROXY。

配置方式

---

环境变量

AnyBot 不再读取 .env 文件。Provider、模型和权限等常用设置会保存到 .data/*.json，也可以在 Web UI 中修改。下面这些变量只作为系统环境变量兼容入口使用，需要时直接在启动命令或系统服务配置里传入。

通用配置

Codex CLI 配置

Claude Code 配置

注意：设置 CLAUDE_CODE_BIN 后，SDK 会执行它指向的可执行文件，不会读取 shell function 或 alias。如果你的 claude 是 shell function 包装器，请把同等逻辑保存成脚本，并将 CLAUDE_CODE_BIN 指向该脚本。

---

REST API

Web UI 通过以下 API 与后端交互，也可以直接调用：

---

飞书集成

通过飞书长连接模式接入，无需公网回调地址。