☕ KOPI Agent 文档

新加坡咖啡 × AI — 一行命令，装好你的AI助手

简介

KOPI Agent 是基于 Hermes Agent 深度定制的 AI 代理平台，专为新加坡及东南亚用户打造。像在咖啡摊点咖啡一样简单 — 选你的口味，一行命令装好。

产品线

安装

KOPI O（经典版）

curl -fsSL https://kopiaiagent.com/install.sh | bash

KOPI Siew Dai（少糖版）

curl -fsSL https://kopiaiagent.com/install-siew-dai.sh | bash

手动提供 API Key

curl -fsSL https://kopiaiagent.com/install.sh | KOPI_API_KEY=kp-xxx bash

系统要求

• 操作系统：Ubuntu 20.04+, Debian 11+, CentOS 8+, Fedora, Arch
• 架构：x86_64 / arm64
• Python：3.11+（脚本自动安装）
• 内存：1GB+ 推荐
• 磁盘：2GB+ 可用空间
• 网络：需要访问 kopiaiagent.com

快速开始

交互式聊天

kopi

直接在终端里和 AI 对话。支持工具调用、代码执行、文件操作等。

单次提问

kopi "帮我写一个 Python 脚本，批量重命名文件"

切换模型

/model kopi-gau       # 切换到 DeepSeek 浓缩版
/model kopi-o-flash   # 切换到快速版
/model kopi-o         # 切回经典版

常用命令

聊天中命令

Gateway（消息网关）

KOPI Agent 可以通过 Telegram 和 WeChat 与你交互，像聊天一样使用 AI。

Telegram 配置

1. 在 Telegram 搜索 @BotFather
2. 发送 /newbot 创建 Bot
3. 复制获得的 Token
4. 运行 kopi gateway setup 并输入 Token

systemd 服务

systemctl start kopi-gateway     # 启动
systemctl stop kopi-gateway      # 停止
systemctl status kopi-gateway    # 状态
journalctl -u kopi-gateway -f    # 日志

模型

所有模型通过 KOPI Proxy 代理，客户无需自备 API Key。

技能

安装时自动预装 100+ 技能，涵盖：

配置文件

配置文件位于 ~/.kopi/config.yaml：

# 大模型配置
model:
  default: kopi-o              # 默认模型
  provider: custom
  base_url: https://kopiaiagent.com/kp/v1
  api_key: kp-xxxxxxxx         # 安装时自动获取
  context_length: 256000

# 代理配置
agent:
  max_turns: 90

# 终端配置
terminal:
  timeout: 180

# 显示配置
display:
  skin: default
  show_cost: true

# 内存配置
memory:
  memory_enabled: true
  user_profile_enabled: true

故障排除

安装失败

API 相关

Gateway 相关