网关配置
txCode 支持通过钉钉机器人接入,实现钉钉消息与 AI 对话。
功能说明
启用网关后,你可以在钉钉群中 @机器人 发送消息,txCode 会自动处理并回复。每个钉钉用户会有独立的会话上下文。
进入网关设置
- 启动 txCode Web 服务:
txcode web
- 浏览器打开
http://localhost:40000 - 点击左下角 设置图标
- 在左侧菜单中选择 网关
配置步骤
1. 创建钉钉机器人
- 打开钉钉 PC 端或手机端
- 进入目标群聊
- 点击群设置 → 智能群助手 → 添加机器人
- 选择 自定义机器人
- 填写机器人名称
2. 获取 Client ID 和 Client Secret
- 访问 钉钉开放平台
- 登录后进入管理后台
- 创建应用:
- 选择 钉钉应用
- 在应用详情中找到 AppKey(即 Client ID)和 AppSecret
3. 在 txCode 中配置
回到 Web 界面的网关设置页面:
- 启用钉钉机器人:打开开关
- Client ID:填入 AppKey
- Client Secret:填入 AppSecret
- 点击 保存
4. 启动网关
配置保存后,点击 启动 按钮。
钉钉使用方式
在钉钉群中 @机器人 发送消息:
| 命令 | 说明 |
|---|---|
/help |
显示帮助信息,列出可用工具和技能 |
/new |
创建新会话,清除上下文 |
其他消息会被当作普通对话处理。
注意事项
- 网络连通:txCode 能访问互联网
- 签名验证:确保 Client ID 和 Client Secret 正确配置
- 消息限制:钉钉机器人有消息频率限制
获取钉钉 API 凭证
| 凭证 | 获取地址 |
|---|---|
| Client ID (AppKey) | 钉钉开放平台 → 应用详情 |
| Client Secret (AppSecret) | 钉钉开放平台 → 应用详情 |
钉钉开放平台地址:https://open.dingtalk.com/