# solveit_wxbot


<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

solveit_wxbot 是一个将 [Solveit](https://solve.it.com/) 接入企业微信的
Webhook
服务。借助企业微信的「微信插件」功能，用户无需安装企业微信客户端，直接在个人微信中即可与
AI 对话。

## Usage

### Installation

Install latest from [pypi](https://pypi.org/project/solveit_wxbot/)

``` sh
$ pip install solveit_wxbot
```

### Documentation

Documentation can be found hosted on this GitHub
[repository](https://github.com/TheSecondStep/solveit_wxbot)’s
[pages](https://TheSecondStep.github.io/solveit_wxbot/). Additionally
you can find package manager specific guidelines on
[pypi](https://pypi.org/project/solveit_wxbot/) respectively.

## How to use

企业微信申请以及配置请选看相关章节[openclaw接入个人微信](https://www.codefather.cn/post/2032650264703492098)

### Configuration

启动前需将企业微信的凭据设置到环境变量。

``` python
import os

os.environ['WECOM_CORP_ID']  = 'ww1234567890abcdef'      # 企业 ID（在「我的企业」页面获取）
os.environ['WECOM_SECRET']   = 'your-app-secret'          # 自建应用的 Secret
os.environ['WECOM_AGENT_ID'] = '1000002'                   # 自建应用的 AgentId
os.environ['WECOM_TOKEN']    = 'your-callback-token'       # 接收消息 API 中设置的 Token
os.environ['WECOM_AES_KEY']  = 'your-43-char-encoding-aes-key'  # 接收消息 API 中设置的 EncodingAESKey
```

### Quick start

配置完成后，导入模块并启动 Webhook 服务：

``` python
from solveit_wxbot.app import *
```

``` python
srv = start_bot()
```

    🚀 Webhook 服务已启动 (port 8000)

    INFO:     Started server process [4584]
    INFO:     Waiting for application startup.
    INFO:     Application startup complete.
    INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

如需停止服务，调用
[`stop_bot`](https://TheSecondStep.github.io/solveit_wxbot/app.html#stop_bot)
并传入启动时返回的服务器对象：

``` python
stop_bot(srv)
```

    INFO:     Shutting down
    INFO:     Waiting for application shutdown.
    INFO:     Application shutdown complete.
    INFO:     Finished server process [4584]

### Deploy on Solveit

要让 bot 在 Solveit 实例启动时自动运行，在 AUTORUN 文件夹下创建一个
Dialog，添加以下两条代码消息并保存即可。Solveit
会在每次实例启动时自动执行 AUTORUN 中所有 Dialog 的代码消息。

第一条——设置环境变量并导入模块：

``` python
import os

os.environ['WECOM_CORP_ID']  = 'your-corp-id'
os.environ['WECOM_SECRET']   = 'your-secret'
os.environ['WECOM_AGENT_ID'] = 'your-agent-id'
os.environ['WECOM_TOKEN']    = 'your-token'
os.environ['WECOM_AES_KEY']  = 'your-aes-key'

from solveit_wxbot.app import *
```

第二条——启动服务：

``` python
srv = start_bot()
```

保存后，每次 Solveit 实例重启都会自动启动 WeChat bot。
