mirror of
https://github.com/NanmiCoder/claude-code-haha.git
synced 2026-10-10 03:43:11 +08:00
程序员阿江(Relakkes)
95 lines
3.0 KiB
Markdown
95 lines
3.0 KiB
Markdown
# WeChat Integration
|
|
|
|
The WeChat adapter binds a bot account by QR code, then authorizes individual private-chat users through pairing or an allowlist.
|
|
|
|
It supports text, transcribed voice content, image and file attachments, project selection, status, stop, and text-based permission approval. Group chats are not supported.
|
|
|
|
## Bind the WeChat bot account
|
|
|
|
Open **Settings → IM Integration → WeChat**:
|
|
|
|
1. Select **Scan to bind**.
|
|
2. Scan the QR code with WeChat.
|
|
3. Confirm the login in WeChat.
|
|
4. Wait for Desktop to show the bound state.
|
|
5. Save the configuration.
|
|
|
|
Desktop stores the returned `accountId`, `botToken`, `baseUrl`, and `userId` in the `wechat` section of `~/.claude/adapters.json`, then restarts the adapter sidecar.
|
|
|
|
Binding credentials does not authorize every WeChat user.
|
|
|
|
## Authorize a user
|
|
|
|
Generate a pairing code at the top of **IM Integration**, then send the six-character code to the bound bot in a private chat.
|
|
|
|
The code:
|
|
|
|
- expires after 60 minutes;
|
|
- can be used once;
|
|
- is replaced immediately when a new code is generated;
|
|
- is rate limited after repeated failures.
|
|
|
|
Known WeChat user IDs can instead be entered in `Allowed Users`.
|
|
|
|
## Projects and sessions
|
|
|
|
With a default project configured, the first accepted message creates or resumes a session in that directory.
|
|
|
|
Without a default project, the adapter returns recent projects. Reply with a number, project name, or absolute path. The resulting chat-to-session mapping is stored in `~/.claude/adapter-sessions.json`.
|
|
|
|
Use `/new` to choose another project and start a new session.
|
|
|
|
## Commands
|
|
|
|
- `/help` or `帮助`
|
|
- `/status` or `状态`
|
|
- `/projects` or `项目列表`
|
|
- `/new` or `新会话`
|
|
- `/new <number, project name, or absolute path>`
|
|
- `/clear` or `清空`
|
|
- `/stop` or `停止`
|
|
|
|
## Permission approval
|
|
|
|
Reply to the text approval message with:
|
|
|
|
- `/allow <requestId>` — allow once
|
|
- `/always <requestId>` — persist the matching approval
|
|
- `/deny <requestId>` — deny
|
|
|
|
The adapter sends the response back to the pending Desktop session.
|
|
|
|
## Attachments and replies
|
|
|
|
- WeChat messages are received through long polling.
|
|
- Long text is split into platform-sized messages.
|
|
- Images enter model input as inline images.
|
|
- Other files are downloaded to a local temporary path for the session.
|
|
- Shared attachment size limits are enforced.
|
|
|
|
## Unbind
|
|
|
|
Unbinding the WeChat account clears its credentials and platform authorization lists. Removing one paired user only revokes that user.
|
|
|
|
## Development
|
|
|
|
Packaged Desktop starts the sidecar automatically. For source development:
|
|
|
|
```bash
|
|
cd adapters
|
|
bun install
|
|
bun run wechat
|
|
```
|
|
|
|
Optional overrides:
|
|
|
|
```bash
|
|
export WECHAT_ACCOUNT_ID="..."
|
|
export WECHAT_BOT_TOKEN="..."
|
|
export WECHAT_BASE_URL="https://ilinkai.weixin.qq.com"
|
|
export WECHAT_USER_ID="..."
|
|
export ADAPTER_SERVER_URL="ws://127.0.0.1:3456"
|
|
```
|
|
|
|
If messages are rejected, confirm that Desktop is running, the account is bound, the sender is paired or allowlisted, and both adapter state files are writable.
|