mirror of https://github.com/sipeed/picoclaw.git synced 2026-06-12 18:08:54 +00:00

Files

T

Cytown 667fc85d54 refactor(config): make config.Channel to multiple instance support

add new field type to Channel struct
config.channels refactor to channel_list
update config version to 3
update the docs

2026-04-13 22:21:21 +08:00

1.6 KiB

Raw Blame History

💬 微信个人号渠道 (Weixin)

PicoClaw 支持使用腾讯官方 iLink API 连接您的个人微信账号。

🚀 快速激活

最简单的方法是使用交互式 onboarding 命令进行一键激活：

picoclaw auth weixin

该命令将：

从 iLink API 获取二维码并在终端中打印。
等待您使用手机微信 App 扫码。
扫码确认后，自动将生成的 Access Token 保存至您的 ~/.picoclaw/config.json 中。

配置完成后，即可启动网关：

picoclaw gateway

⚙️ 配置说明

您也可以在 config.json 的 channels.weixin 段目下进行手动维护。

{
  "channel_list": {
    "weixin": {
      "enabled": true,
      "type": "weixin",
      "token": "YOUR_WEIXIN_TOKEN",
      "allow_from": [
        "user_id_1",
        "user_id_2"
      ],
      "proxy": ""
    }
  }
}

字段解析

字段	说明
`enabled`	设置为 `true` 以在启动时激活该频道。
`token`	通过扫码获取的认证令牌。
`allow_from`	(可选) 允许与机器人交互的微信 User ID 列表。如果为空，任何能给此微信号发消息的人都可以触发机器人。
`proxy`	(可选) HTTP 代理地址（例如 `http://localhost:7890`），适合网络访问受限环境。

⚠️ 注意事项

单端绑定: iLink 令牌通常与单个会话绑定。在其他地方重新扫码激活可能会导致旧令牌失效。
频率控制: 为避免触发微信的风控反垃圾机制，请避免设置死循环触发、高频广播等恶意行为。

1.6 KiB Raw Blame History