OpenClaw RCS 插件

OpenClaw RCS 通道插件，用于接入 RCS 消息通道。

前提准备

在安装之前，你需要先获取 API 凭据：

1. 访问 https://5g.fontdo.com/ 注册账号
2. 登录后获取 API_ID 和 API_KEY
3. 记录好你的 API 凭据，后续安装需要用到

安装方式

方式一：npx 安装（推荐 ✓）

适用于所有平台（Linux、macOS、Windows）：

npx openclaw-rcs install

使用说明

安装插件

# npx 方式 - 交互式安装
npx openclaw-rcs install

# npx 方式 - 命令行参数安装
npx openclaw-rcs install --number=156000000 --api_id="your-api-id" --api_key="your-api-key" --agree=true --restart=true --default=true

交互式安装

安装过程会提示输入：

• 手机号码：需要绑定的 RCS 接收手机号
• API_ID：从 https://5g.fontdo.com/ 获取
• API_KEY：从 https://5g.fontdo.com/ 获取

命令行参数安装

支持通过命令行参数直接配置，无需交互式输入：

• --number：手机号码（必填）
• --api_id：API ID（必填，需要用双引号包裹）
• --api_key：API Key（必填，需要用双引号包裹）
• --agree：是否同意配置协议（当账号尚未签署协议时，静默安装必须带上 --agree=true，否则将被拒绝）
• --restart：是否自动重启 OpenClaw（可选，默认不重启，设置为 true 时自动重启）
• --default：是否将新账号设置为默认账号（可选，默认设置为默认账号，设置为 false 时不设置为默认账号）

注意事项：

• 默认情况下，如果是首次配置，新增的账号会自动设置为默认账号
• 如果手机号已存在，会覆盖该手机号的配置
• 默认情况下不会自动重启，需要手动执行 openclaw gateway restart
• 使用 --restart=true 可以在配置完成后自动重启 OpenClaw
• 使用 --default=false 可以不将新账号设置为默认账号
• --api_id 和 --api_key 参数值需要用双引号包裹，例如：--api_id="your-api-id"

查看配置列表

npx openclaw-rcs list

显示当前所有已配置的账号信息，包括：

• 手机号
• 通道 ID
• 机器人名称
• 账号状态

获取通道 ID

npx openclaw-rcs bind --number=1560000000 --api_id="your-api-id" --api_key="your-api-key"

参数说明：

• --number：手机号码
• --api_id：API ID（需要用双引号包裹）
• --api_key：API Key（需要用双引号包裹）

响应结果示例：

成功响应

{
  "code": "0",
  "desc": "Success",
  "time": "2026-03-17T09:45:04.369+08:00",
  "data": "13069220000000000"
}

失败响应

{
  "code": "ERROR",
  "desc": "Request failed with status code 403"
}

更新插件

npx openclaw-rcs update

配置说明

配置文件位置

• Linux/macOS: ~/.openclaw/openclaw.json
• Windows: %USERPROFILE%\.openclaw\openclaw.json

配置结构

{
  "channels": {
    "rcs-channel": {
      "dmPolicy": "pairing",
      "allowFrom": [],
      "accounts": {
        "default": {
          "host": "5g.fontdo.com",
          "appId": "your-api-id",
          "appKey": "your-api-key",
          "botName": "蜂动Claw",
          "enabled": true,
          "chnId": "channel-id",
          "phoneNumber": "13800138000"
        }
      }
    }
  }
}

多账号配置

支持配置多个账号：

{
  "channels": {
    "rcs-channel": {
      "accounts": {
        "default": {
          "host": "5g.fontdo.com",
          "appId": "your-api-id",
          "appKey": "your-api-key",
          "botName": "蜂动Claw",
          "enabled": true,
          "chnId": "channel-id",
          "phoneNumber": "13800138000"
        },
        "13900139000": {
          "host": "5g.fontdo.com",
          "appId": "your-api-id",
          "appKey": "your-api-key",
          "botName": "蜂动Claw",
          "enabled": true,
          "chnId": "channel-id",
          "phoneNumber": "13900139000"
        }
      }
    }
  }
}

环境变量

可以通过环境变量预先配置 API 凭据，避免交互式输入：

# Linux/macOS
export RCS_API_ID="your-api-id"
export RCS_API_KEY="your-api-key"
npx openclaw-rcs install

# Windows PowerShell
$env:RCS_API_ID="your-api-id"
$env:RCS_API_KEY="your-api-key"
npx openclaw-rcs install

重启服务

配置完成后，需要重启 OpenClaw 使配置生效：

openclaw gateway restart

或者在安装过程中选择"立即重启"。

命令行选项

npx 方式

| 命令 | 说明 | | -------------------------- | ----------------- | | npx openclaw-rcs install | 安装并配置 RCS 通道 | | npx openclaw-rcs list | 查看已配置的账号列表 | | npx openclaw-rcs bind | 获取通道 ID（命令行方式） | | npx openclaw-rcs update | 更新 rcs-channel 插件 |

脚本方式

| 平台 | 命令 | | ---------------------------- | ------------------------------------------------------ | | Linux/macOS/Windows Git Bash | bash install.sh | | Windows | powershell -ExecutionPolicy Bypass -File install.ps1 |

常见问题

1. 安装失败，提示 "未检测到 OpenClaw"

请确保已正确安装 OpenClaw 客户端。

2. 绑定失败

• 检查 API_ID 和 API_KEY 是否正确
• 确认手机号码格式正确（只需输入数字）
• 检查网络连接是否正常

3. 配置文件不存在

OpenClaw 会在首次运行后自动创建配置文件。如果手动删除，可以重新运行安装脚本。

卸载

如需卸载插件：

# 删除配置
rm ~/.openclaw/openclaw.json

技术支持

如有问题，请联系技术支持。