txcode操作文档 文档中心

网关配置

txCode 支持通过钉钉机器人接入,实现钉钉消息与 AI 对话。

功能说明

启用网关后,你可以在钉钉群中 @机器人 发送消息,txCode 会自动处理并回复。每个钉钉用户会有独立的会话上下文。

进入网关设置

  1. 启动 txCode Web 服务:
txcode web
  1. 浏览器打开 http://localhost:40000
  2. 点击左下角 设置图标
  3. 在左侧菜单中选择 网关

配置步骤

1. 创建钉钉机器人

  1. 打开钉钉 PC 端或手机端
  2. 进入目标群聊
  3. 点击群设置 → 智能群助手 → 添加机器人
  4. 选择 自定义机器人
  5. 填写机器人名称

2. 获取 Client ID 和 Client Secret

  1. 访问 钉钉开放平台
  2. 登录后进入管理后台
  3. 创建应用:
    • 选择 钉钉应用
  4. 在应用详情中找到 AppKey(即 Client ID)和 AppSecret

3. 在 txCode 中配置

回到 Web 界面的网关设置页面:

  1. 启用钉钉机器人:打开开关
  2. Client ID:填入 AppKey
  3. Client Secret:填入 AppSecret
  4. 点击 保存

4. 启动网关

配置保存后,点击 启动 按钮。

钉钉使用方式

在钉钉群中 @机器人 发送消息:

命令 说明
/help 显示帮助信息,列出可用工具和技能
/new 创建新会话,清除上下文

其他消息会被当作普通对话处理。

注意事项

  1. 网络连通:txCode 能访问互联网
  2. 签名验证:确保 Client ID 和 Client Secret 正确配置
  3. 消息限制:钉钉机器人有消息频率限制

获取钉钉 API 凭证

凭证 获取地址
Client ID (AppKey) 钉钉开放平台 → 应用详情
Client Secret (AppSecret) 钉钉开放平台 → 应用详情

钉钉开放平台地址:https://open.dingtalk.com/