# Wechat Codex Agent Bridge

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-kaixindelele-wechat-agent-bridge-skills-wechat-codex-agent-bridge-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kaixindelele](https://agentstack.voostack.com/s/kaixindelele)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kaixindelele](https://github.com/kaixindelele)
- **Source:** https://github.com/kaixindelele/wechat_agent_bridge_skills/tree/main/wechat-codex_agent_bridge-skill

## Install

```sh
agentstack add skill-kaixindelele-wechat-agent-bridge-skills-wechat-codex-agent-bridge-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 微信 ↔ Codex CLI 桥接

用微信连接本机运行的 `codex` CLI。桥接服务基于 `codex exec --json`，支持：

- 文字消息转发给 Codex
- 图片作为 `--image` 输入传给 Codex
- 文件、语音、视频落盘后把本地路径交给 Codex
- 使用 `thread_id` 自动续接上下文
- 微信端控制 `/model`、`/sandbox`、`/stop`、`/clear`、`/send`

如果需要修改和微信桥接相关的底层协议，可以参考 `wechat_agent_bridge_skills/openclaw-weixin` 原版 SDK。

## 目录说明

| 路径 | 作用 |
|------|------|
| `templates/` | 可独立运行的 Node 桥接服务 |
| `templates/src/ilink.ts` | 微信 ilink（ClawBot）HTTP API：收发消息、媒体加解密 |
| `templates/src/bridge.ts` | 主循环：`getupdates` + `codex exec --json` |
| `templates/bridge.config.example.json` | 配置模板，复制为 `bridge.config.json` |

## 前置条件

- Node.js >= 18
- 已安装并登录 `codex` CLI（先执行 `codex login`）
- 微信侧已完成 ClawBot / ilink 机器人绑定

## 安装与启动

```bash
cd wechat-codex_agent_bridge-skill/templates
cp bridge.config.example.json bridge.config.json
# 编辑 bridge.config.json：至少设置 cwd 为项目根目录
npm install
npm run setup
npm start
```

## 微信端指令

- `/help` - 查看帮助
- `/status` - 查看当前 bridge 状态
- `/clear` - 清除会话、终止任务、清空队列和追问
- `/stop` - 终止当前任务
- `/stopall` - 终止当前任务并清空队列和追问
- `/send ` - 发送服务器上的文件到微信
- `/model` - 查看当前模型
- `/model ` - 设置下一轮执行使用的模型
- `/model clear` - 恢复 Codex 默认模型
- `/sandbox` - 查看当前 sandbox
- `/sandbox read-only|workspace-write|danger-full-access` - 切换 sandbox

## 重要限制

Codex 版桥接使用的是非交互式 `codex exec`。因此：

- 支持稳定的消息桥接、会话续接、图片输入和文件回传
- 不支持像 Cursor 版那样对每一次工具调用做微信侧逐条审批
- 需要通过 `/sandbox` 控制整体执行范围，而不是在工具执行中途弹微信确认

## 发送文件给微信

如果希望 Codex 把本机文件主动发回微信，在回复中输出：

```text
[SEND_FILE:/绝对路径/文件.ext]
```

桥接层会自动识别并上传该文件。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kaixindelele](https://github.com/kaixindelele)
- **Source:** [kaixindelele/wechat_agent_bridge_skills](https://github.com/kaixindelele/wechat_agent_bridge_skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kaixindelele-wechat-agent-bridge-skills-wechat-codex-agent-bridge-skill
- Seller: https://agentstack.voostack.com/s/kaixindelele
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.