企业官网建设流程全解析

• 人工智能
• AI 应用
• AI Agent
• 交互助手
• 工具调用
• MCP Clients
• Agent 记忆

本篇实战指南面向想要在 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 安装链路。

前置条件

开始之前，请确认满足以下条件：

1. ARM64 Android 设备：在 Termux 中运行uname -m，输出为aarch64即可按本文操作。这一步非常关键——PicoClaw 的发布产物按uname输出命名（详见下文“下载并解压 ARM64 发布包”），架构不匹配将直接导致not found或permission denied。
2. Termux 本体：从 Termux GitHub Releases 或 F-Droid 安装，建议使用官方渠道的较新版本。
3. 网络访问：需要能够下载 GitHub Release 压缩包，并且能够连通你选择的 LLM Provider API。
4. 至少一个模型 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化为Linux，arm64保持不变），因此最终产物名即为picoclaw_Linux_arm64.tar.gz。由于 Go 静态编译（构建时CGO_ENABLED=0），这个二进制不依赖目标机的动态库，非常适合直接部署到 Termux。

解压后务必执行chmod +x ./picoclaw赋予可执行权限，否则会出现permission denied。

首次初始化：通过 termux-chroot 运行 onboard

首次运行请务必通过termux-chroot启动初始化流程：

termux-chroot ./picoclaw onboard

onboard是 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（权限设为 600），PicoClaw 会自动把其中的api_keys映射回配置；详见 安全配置文档。

路径相关的环境变量

PicoClaw 支持通过环境变量覆盖默认路径，在 Termux 这类便携式环境中尤其有用：

例如把数据整体放到 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 共享存储（相册、下载目录等），需要：

1. 先在 Termux 中运行一次termux-setup-storage授权存储访问；
2. 再把 workspace 或相关文件路径指向挂载出来的存储目录（通常位于~/storage/下）。

运行：从单轮验证到常驻网关

单轮 agent 模式验证安装

用一条消息快速确认整个链路（二进制、配置、Provider 网络）是否打通：

termux-chroot ./picoclaw agent -m "Hello from Termux"

agent子命令支持-m/--message单条消息模式（非交互）、-s/--session会话 Key（默认cli:default）、--model指定模型以及-d调试日志；命令定义见 agent 命令入口。若返回正常回复，说明安装与配置已全部就绪。

长期运行：启动 gateway

需要持续提供服务时，启动网关：

termux-chroot ./picoclaw gateway

gateway是 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 version

version子命令会输出当前版本、Git Commit、构建时间与 Go 版本等信息（这些信息在构建时通过 ldflags 注入，见 .goreleaser.yaml），用于确认升级成功。

常见问题排查

总结

在 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 Clients
• Agent 记忆