Skip to content

Proposal: add a NapCat + OneBot + ACP agent Docker Compose sample #780

Description

@happysnaker

Summary

I would like to propose a new Docker Compose sample for a messaging-native AI stack:

  • NapCat for QQ / OneBot transport
  • qq-ai-bot as the OneBot 11 ↔ ACP bridge
  • a tiny mock ACP agent for deterministic first-run validation

Why this sample could be useful

Most Compose examples around AI currently focus on web UIs or local model serving. This sample would instead show a reproducible message-channel deployment path: a user can validate QQ -> OneBot -> bot bridge -> agent runtime as one stack, then swap the mock agent for their own runtime later.

I think this fits the repo goal because it is still a local-development / tinkering sample, but demonstrates multi-service Compose orchestration for a real integration shape instead of a single UI.

Proposed structure

  • compose.yaml for NapCat + qq-ai-bot + mock ACP agent
  • sample README with startup / token / WebUI notes
  • clear note that it is not production-ready and mainly for local validation

If this direction sounds useful, I can prepare the actual sample PR next.

Reference project:

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions