Files
picoclaw/docs/channels/weixin/README.zh.md
T
Hua Audio dd82794255 Feat/weixin openclaw port (#1873)
* init

* fix lint

* fix go test

* update docs

* incorporate pr review

* Update pkg/channels/weixin/weixin.go

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* feat(weixin): add media sync and typing support

* test(weixin): cover media and sync helpers

---------

Co-authored-by: zhangmikoto <i@electromaster.me>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Hoshina <hoshina@evaz.org>
2026-03-22 14:23:39 +08:00

1.6 KiB

💬 微信个人号渠道 (Weixin)

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

🚀 快速激活

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

picoclaw onboard weixin

该命令将:

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

配置完成后,即可启动网关:

picoclaw gateway

⚙️ 配置说明

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

{
  "channels": {
    "weixin": {
      "enabled": true,
      "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 令牌通常与单个会话绑定。在其他地方重新扫码激活可能会导致旧令牌失效。
  • 频率控制: 为避免触发微信的风控反垃圾机制,请避免设置死循环触发、高频广播等恶意行为。