opencode/picoclaw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(readme): Document possible TLS certificate errors in README

Browse source 
Added a section for possible errors and their fixes related to TLS certificate verification in Termux.
This commit is contained in:
M V Midhun 2026-02-18 15:08:50 +05:30 • committed by GitHub
parent 3390576eea
commit 8db4dd92ea
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 28 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
README.md
View file

@ -113,6 +113,34 @@ termux-chroot ./picoclaw-linux-arm64 onboard
And then follow the instructions in the "Quick Start" section to complete the configuration! And then follow the instructions in the "Quick Start" section to complete the configuration!
<img src="assets/termux.jpg" alt="PicoClaw" width="512"> <img src="assets/termux.jpg" alt="PicoClaw" width="512">
<details>
<summary><b> Possible Errors you may encounter:</b> </summary>
**1. tls: failed to verify certificate**
```
Error: LLM call failed: failed to send request: Post "https://<your-provider>/api/v1/chat/completions": tls: failed to verify certificate: x509: certificate signed by unknown authority
```
This error indicates that the application (`picoclaw`) cannot verify the security certificate of Your Provider API. This is a very common issue in **Termux** because the environment often lacks the latest root certificate authorities required to validate HTTPS connections.
Fix :
Run the following
```bash
pkg update && pkg upgrade
pkg install ca-certificates openssl
echo 'export SSL_CERT_FILE=/data/data/com.termux/files/usr/etc/tls/cert.pem' >> ~/.bashrc
source ~/.bashrc
```
**After running this:**
1. Restart Termux (completely close the app and reopen it).
2. Try running `picoclaw` again.
</details>
### 🐜 Innovative Low-Footprint Deploy ### 🐜 Innovative Low-Footprint Deploy
PicoClaw can be deployed on almost any Linux device! PicoClaw can be deployed on almost any Linux device!