跳转到内容

OpenClaw 快速接入

agent-wechat 插件用于连接 OpenClaw 与正在运行的 wx Daemon。你的 AI 智能体可以接收来自微信的消息,并使用你的账号名义发送回复。

手机上的微信聊天界面:好友索取平面图设计,智能体通过主人的账号回复了对应的 PDF 文件

前提条件是已启动 Daemon 并完成登录。若尚未配置,请参考连接账号。

  1. 为 OpenClaw 创建访问令牌。

    Terminal window
    wx accounts list # 获取账号对应 "id"
    wx tokens create openclaw --accounts ACCOUNT_ID \
    --scopes read --scopes media --scopes send --scopes login --scopes read-state

    妥善复制输出结果中的 token 字符串。该凭证仅展示一次。

  2. 安装插件。

    Terminal window
    openclaw plugins install @agent-wechat/agent-wechat
  3. 在 ~/.openclaw/openclaw.json 中添加通道配置。 以下示例仅允许指定好友触发智能体:

    {
    "channels": {
    "agent-wechat": {
    "enabled": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["wxid_friend"],
    "native": {
    "mode": "external",
    "accountId": "ACCOUNT_ID",
    "endpoint": "http://127.0.0.1:6174",
    "token": { "source": "env", "provider": "default", "id": "AGENT_WECHAT_TOKEN" },
    "consumerStateDir": "/home/you/.openclaw/agent-wechat"
    }
    }
    }
    }

    可通过 wx contacts find 姓名 查找好友 ID,通过 wx chats find 群名 查找群聊 ID(以 @chatroom 结尾)。联系人 ID 通常以 wxid_ 开头,但也有部分例外。请使用命令返回的真实 ID,而不是昵称或可修改的微信号。你自己的 ID 可以通过发送过的消息中的 senderId 获取(例如执行 wx messages list filehelper --limit 1)。

  4. 注入令牌环境变量。 在 Gateway 运行环境中设置 AGENT_WECHAT_TOKEN,然后重启 OpenClaw Gateway。

  5. 进行测试。 让该好友向你发送一条微信消息。智能体将在相同的聊天窗口中自动生成回复。

下一步:配置响应权限控制(包含群聊权限),为智能体分配专属工具,以及按需开启语音通话。

可选工具需要通过 OpenClaw 显式单独授权。例如,开启语音通话并不会自动将 wechat_call 添加到智能体的工具列表中;需要按照智能体工具中的说明将其添加到 tools.alsoAllow 中。