人工智能AI 应用AI Agent交互助手工具调用MCP ClientsAgent 记忆【免费下载链接】picoclawTiny, Fast, and Deployable anywhere — automate the mundane, unleash your creativity项目地址https://gitcode.com/gh_mirrors/pi/picoclaw点击查看免费下载本篇实战指南面向想要在 Android 手机上以纯命令行方式运行 PicoClaw 的用户从确认设备架构、安装 Termux 与依赖、下载 ARM64 二进制到完成onboard初始化、配置模型 API Key、以agent单轮模式验证安装并长期运行gateway再到升级二进制与排查常见问题。读完本文你可以在资源有限的旧手机上获得一个轻量、可部署的本地 AI 助手终端环境。适用场景APK 应用与 Termux 终端如何选择PicoClaw 的 Android 使用有两种截然不同的形态本文只讲解其中一种APK 应用体验从 picoclaw.io 下载 Android 应用安装包获得原生 App 界面聊天、WebUI、设置页等。Termux 纯命令行安装在 Termux 终端中直接运行picoclaw二进制。这种方式安装包小、不依赖图形界面非常适合旧机型或资源受限设备也便于与 SSH、脚本、cron 等终端生态结合。本文以 docs/guides/android-termux.md 为主体结合仓库源码与发布配置完整还原 Termux 安装链路。前置条件开始之前请确认满足以下条件ARM64 Android 设备在 Termux 中运行uname -m输出为aarch64即可按本文操作。这一步非常关键——PicoClaw 的发布产物按uname输出命名详见下文“下载并解压 ARM64 发布包”架构不匹配将直接导致not found或permission denied。Termux 本体从 Termux GitHub Releases 或 F-Droid 安装建议使用官方渠道的较新版本。网络访问需要能够下载 GitHub Release 压缩包并且能够连通你选择的 LLM Provider API。至少一个模型 Provider 的 API Key例如 OpenRouter、OpenAI、Anthropic、DeepSeek、智谱 GLM、Gemini 等。安装 PicoClaw安装 Termux 依赖包打开 Termux先更新软件源并安装发布包解压与termux-chroot包装器所需的软件包pkg update pkg install -y wget tar proot其中proot是 Termux 中提供termux-chroot命令的基础组件它让 Linux 二进制在一个更接近标准 Linux 的文件系统布局中运行。下载并解压 ARM64 Linux 发布包创建安装目录并下载对应的 ARM64 发布包mkdir -p ~/picoclaw cd ~/picoclaw wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz tar xzf picoclaw_Linux_arm64.tar.gz chmod x ./picoclaw关于这个发布包文件名仓库中的 .goreleaser.yaml 给出了直接证据构建配置里goarch明确包含arm64归档命名规则为{{ .ProjectName }}_{{ title .Os }}_{{ .Arch }}linux会被title化为Linuxarm64保持不变因此最终产物名即为picoclaw_Linux_arm64.tar.gz。由于 Go 静态编译构建时CGO_ENABLED0这个二进制不依赖目标机的动态库非常适合直接部署到 Termux。解压后务必执行chmod x ./picoclaw赋予可执行权限否则会出现permission denied。首次初始化通过 termux-chroot 运行 onboard首次运行请务必通过termux-chroot启动初始化流程termux-chroot ./picoclaw onboardonboard是 PicoClaw 的初始化子命令。从源码看onboard 命令入口 还支持--enc标志启用凭据加密会生成 SSH 密钥并提示输入口令初始化逻辑位于 onboard/helpers.go它会生成默认配置并保存到~/.picoclaw/config.json若已存在则保留原有配置把内嵌的 workspace 模板AGENT.md、SOUL.md、USER.md、IDENTITY.md、memory/MEMORY.md等复制到默认工作区~/.picoclaw/workspace通过picoclaw is ready!提示初始化完成。termux-chroot相比直接调用二进制会给 Linux 程序提供更标准的根文件系统布局/usr、/etc、/bin等避免 Android 原生用户空间布局差异导致的路径与文件行为异常。仓库主入口 cmd/picoclaw/main.go 中的initTermuxSSL()还会自动探测 Termux 环境通过 HOME/PATH 中的com.termux特征并在发现$PREFIX/etc/tls/cert.pem等 CA 证书文件时自动设置SSL_CERT_FILE从而修复 Termux 环境下常见的 X.509 证书校验失败问题。配置写入 API Key 与调整工作区编辑配置初始化完成后编辑生成的配置文件vim ~/.picoclaw/config.json在model_list中至少添加一个带 API Key 的模型条目。以 OpenRouter 为例推荐可访问大量模型{ model_list: [ { model_name: gpt-5.4, provider: openrouter, model: openai/gpt-5.4, api_keys: [sk-or-your-openrouter-key] } ], agents: { defaults: { model: gpt-5.4 } } }更完整的配置字段与各 Provider 示例见 配置指南 与 Providers 与模型配置仓库中的 config/config.example.json 也是一个可以直接对照的完整参考模板其中列出的 Provider 包括 OpenAI、Anthropic、DeepSeek、Gemini、智谱 GLM、Moonshot、Ollama、LM Studio、VolcEngine 等。如果不想把 Key 明文写在config.json中可以将敏感字段移入~/.picoclaw/.security.yml权限设为 600PicoClaw 会自动把其中的api_keys映射回配置详见 安全配置文档。路径相关的环境变量PicoClaw 支持通过环境变量覆盖默认路径在 Termux 这类便携式环境中尤其有用变量作用默认值PICOCLAW_CONFIG直接指定要加载的config.json路径~/.picoclaw/config.jsonPICOCLAW_HOME覆盖 PicoClaw 数据根目录workspace 等数据目录随之改变~/.picoclaw例如把数据整体放到 Termux 的外部目录PICOCLAW_HOME/data/data/com.termux/files/home/.picoclaw PICOCLAW_CONFIG/data/data/com.termux/files/home/.picoclaw/config.json termux-chroot ./picoclaw gateway访问 Android 共享存储默认工作区是~/.picoclaw/workspace。如果你希望 PicoClaw 读写 Android 共享存储相册、下载目录等需要先在 Termux 中运行一次termux-setup-storage授权存储访问再把 workspace 或相关文件路径指向挂载出来的存储目录通常位于~/storage/下。运行从单轮验证到常驻网关单轮 agent 模式验证安装用一条消息快速确认整个链路二进制、配置、Provider 网络是否打通termux-chroot ./picoclaw agent -m Hello from Termuxagent子命令支持-m/--message单条消息模式非交互、-s/--session会话 Key默认cli:default、--model指定模型以及-d调试日志命令定义见 agent 命令入口。若返回正常回复说明安装与配置已全部就绪。长期运行启动 gateway需要持续提供服务时启动网关termux-chroot ./picoclaw gatewaygateway是 PicoClaw 的常驻进程入口定义见 gateway 命令入口负责监听配置中的通道如 Telegram、Discord、Pico WebUI 等并把消息路由给 Agent 处理它同时支持-d/--debug、-T/--no-truncate、-E/--allow-empty无默认模型时也继续启动与--host覆盖gateway.host绑定地址等标志。保持进程存活的两个要点保持 Termux 会话前台运行PicoClaw 运行期间请勿关闭该 Termux 会话。关闭电池优化Android 的电池优化会中断后台工作如果希望锁屏后 PicoClaw 仍持续运行请在系统设置中为 Termux 关闭电池优化并保持一个前台 Termux 会话处于活动状态。升级 PicoClaw配置与工作区都存放在~/.picoclaw下因此升级二进制不会丢失任何数据。按以下步骤替换二进制并验证版本cd ~/picoclaw rm -f picoclaw_Linux_arm64.tar.gz wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz tar xzf picoclaw_Linux_arm64.tar.gz chmod x ./picoclaw termux-chroot ./picoclaw versionversion子命令会输出当前版本、Git Commit、构建时间与 Go 版本等信息这些信息在构建时通过 ldflags 注入见 .goreleaser.yaml用于确认升级成功。常见问题排查症状排查方向permission denied解压后未执行chmod x ./picoclaw运行./picoclaw报not found确认uname -m输出为aarch64且下载的是picoclaw_Linux_arm64.tar.gz而非 amd64 或 armv7 版本文件或路径行为与标准 Linux 不一致请改用termux-chroot ./picoclaw ...方式运行而不是直接调用二进制Provider 请求失败检查~/.picoclaw/config.json中的 API Key 与网络连通性若报证书错误确认initTermuxSSL()已自动设置SSL_CERT_FILE或手动export SSL_CERT_FILE$PREFIX/etc/tls/cert.pem手机锁屏后 PicoClaw 停止为 Termux 关闭 Android 电池优化并保持前台 Termux 会话活动总结在 Termux 中运行 PicoClaw 的核心链路可以概括为四步确认架构uname -m→aarch64→ 下载解压 ARM64 发布包并chmod x→ 用termux-chroot完成onboard初始化与 API Key 配置 → 用agent -m验证、用gateway常驻运行。得益于 Go 静态编译与仓库对 Termux 环境的专门适配SSL 证书自动探测、termux-chroot文件系统兼容这套方案在资源受限的 ARM64 Android 设备上依然可以提供一个轻量、完整的本地 AI 助手终端环境。赞分享人工智能AI 应用AI Agent交互助手工具调用MCP ClientsAgent 记忆【免费下载链接】picoclawTiny, Fast, and Deployable anywhere — automate the mundane, unleash your creativity项目地址https://gitcode.com/gh_mirrors/pi/picoclaw点击查看免费下载相关推荐Codewhale 终端 AI 编程助手在 Termux / Android arm64 上的安装指南与平台安全行为解析Codewhale 终端 AI 编程助手在 Termux / Android arm64 上的安装指南与平台安全行为解析 Codewhale 是为终端场景设计的人工智能AI Agent代码智能体CLI工具调用MCP Clients如何在 Android Termux 上安装并首次运行 Hermes Agent.[termux] 测试路径如何在 Android Termux 上安装并首次运行 Hermes Agent. termux 测试路径 本文面向想在 Android 手机上直接跑 HeAI Agent人工智能AI 应用工具调用Agent 记忆交互助手RAG任务调度MCP 服务终极Mobox安装指南在Android手机上轻松运行Windows应用终极Mobox安装指南在Android手机上轻松运行Windows应用 你是否曾幻想过在手机上直接运行Photoshop、Office这样的桌面软件现在这个虚拟化CLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考