在 Android 手机上运行 Karin 。不用电脑、不用服务器,装好 App 就能把机器人跑起来。
- 一键启动 Karin:右下角电源键启动/停止,实时显示运行时长与内存占用
- 内置插件市场:按分类浏览,直接安装、卸载,插件说明(README)在 App 内渲染
- 切换 Karin 版本:在设置里查看已装版本并随时切换
- 改配置文件:内置文件管理,直接浏览和编辑容器里的
/root/karin(配置、插件数据都能改) - 自动准备环境:容器解包、Node.js、依赖安装全部自动完成,首次启动后无需再操心
- 后台保活:Karin 运行时可保持在后台,不被系统随手回收
- 安装:从 Releases 下载 APK 安装(仅支持 arm64 手机)。
- 首次启动:等它自动准备容器和运行环境,需要联网,耗时取决于网速,界面会显示进度和日志。
- 启动 Karin:进入「控制台」,点右下角电源键。首次会申请通知权限——允许它,Karin 才能在后台稳定运行。
- 装插件:打开「插件」页,用分类和「全部 / 已安装 / 未安装」筛选,点安装即可。要接入平台,记得装对应的适配器插件。
- 改配置:需要改账号、协议端等配置时,用「控制台 → 文件管理」编辑
/root/karin下的文件。
国内网络建议:进「设置」把 NPM 源 切到淘宝源;如果装插件时卡在 GitHub,可以填一个 GitHub 加速前缀(例如
https://gh-proxy.com/,留空表示直连)。
- 控制台:Karin 运行状态、内存占用、右上角容器状态(点开可优雅重启 / 强制重启)、右下角电源开关、文件管理入口
- 插件:插件市场与已安装管理
- 设置:Karin 版本切换、NPM 源、GitHub 加速,以及「重置 Karin 项目」「重置容器」两个危险操作
- 启动失败 / 一直转圈:首次启动需要联网下载运行环境,检查网络后点「重试」;失败时可以把完整日志保存到 Download 目录再看。
- Karin 停止后就不动了:请允许通知权限,否则后台保活能力会下降。
- 机器人没反应:先确认首页显示 Karin 正在运行,再检查适配器插件是否装好、配置是否填对。
- 想从头再来:「重置 Karin 项目」只清空
/root/karin(插件和配置会丢);「重置容器」会重装整个 Debian 环境,耗时更长。 - 终端入口:目前还是占位功能,暂不可用。
技术栈:React Native 0.87 + React 19 + TypeScript,原生侧用 proot 跑 Debian bookworm (arm64) 容器。
pnpm install # 安装依赖
npm start # 启动 Metro
npm run android # 构建并安装到已连接的 arm64 真机
npx tsc --noEmit # 类型检查
npm run lint -- --no-cache