跳到主要内容

最短启动路径

这份页面只关注最短可用路径。目标是在最少步骤内完成以下事情：

  1. 启动 CountBot
  2. 配置一个可用模型
  3. 跑通 Web 聊天
  4. 接入至少一个渠道或一个外部编程工具

如果你需要完整字段说明，请同时阅读：

第一步：启动服务​

在项目根目录执行：

python start_app.py

默认访问地址：

http://localhost:8000

第二步：配置模型​

进入设置页，至少完成以下内容：

  • 选择一个提供商
  • 填入 API Key
  • 指定默认模型

最小可用配置通常包含：

  • providers.<provider>.enabled = true
  • providers.<provider>.api_key
  • model.provider
  • model.model

配置完成后，先在 Web 聊天页发送一条简单消息，确认基础对话可用。

第三步：补齐运行基础​

建议顺手完成三项：

  • Persona：AI 名称、用户称呼、输出语言
  • Workspace：确认工作空间路径
  • Security：危险命令防护、审计日志、工作空间限制

如果你的场景涉及文件、Shell、长期任务或团队协作，这一步不要跳过。

第四步：选择一条扩展路径​

路径 A：先接入渠道​

适合你要把 CountBot 接进 Telegram、飞书、钉钉、企业微信、微博、QQ 或小智等外部入口。

推荐顺序：

  1. 先接入一个已经落地的运行渠道
  2. 跑通单账号
  3. 再扩展到同渠道多账号或多渠道矩阵

路径 B：先接入外部编程工具​

适合你希望把 Claude、Codex、OpenCode 这类 CLI 接到 CountBot，让消息进入编码工作流。

推荐顺序：

  1. 先在“编程工具”页新增一个 profile
  2. 填好命令、参数、工作目录和会话模式
  3. 先在设置页检查命令是否可用
  4. 再决定是否把它绑定到某个渠道账号的默认路由

第五步：做一次完整验证​

建议按下面顺序检查：

  1. Web 聊天能正常回复
  2. 设置页保存后刷新仍然正确
  3. 工作空间目录中能看到运行时文件
  4. 如果接入了渠道，渠道测试接口返回成功
  5. 如果接入了外部编程工具，命令检查可以通过
  6. 如果配置了渠道路由，在目标聊天里能按预期走 AI 模式或直通模式

一个实用的上线顺序​

  1. 先稳定模型和工作空间
  2. 再定义人格和团队
  3. 再接渠道
  4. 最后接外部编程工具和路由

这样做的好处是：基础运行层先稳定，后面的团队、机器人和编程工具都能继承同一套默认值。

下一步​