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

rename picoclaw -> piconomous + add fully autonomous mode

Browse source 
## Rename
- Module path: github.com/sipeed/picoclaw -> github.com/sipeed/piconomous
- All binary names: picoclaw* -> piconomous*
- Config/data paths: ~/.picoclaw -> ~/.piconomous
- Env vars: PICOCLAW_* -> PICONOMOUS_*
- Directory renames: cmd/picoclaw -> cmd/piconomous, cmd/picoclaw-launcher-tui -> cmd/piconomous-launcher-tui
- Asset renames, desktop file, docker services

## Fully Autonomous Mode (new feature)
Adds `autonomous` config section with:
- `enabled`: activates goal-driven autonomous operation
- `interval_minutes`: heartbeat frequency (default 5 min in autonomous mode)
- `allow_self_schedule`: agent can create cron jobs for itself without command_confirm
- `max_goals`: cap on concurrent active goals (default 20)

### New: Goal Management Tool (pkg/tools/goal.go)
- `goal` tool with actions: set/list/complete/update/drop
- Goals persist in GOALS.md (human-readable) + goals.json (machine-readable)
- Priority levels P1-P5, status lifecycle: active -> completed/dropped

### Enhanced Heartbeat Service
- SetAutonomous(bool) activates goal-driven prompt mode
- In autonomous mode: reads GOALS.md each cycle, builds a rich prompt that
  instructs the agent to run the full software dev lifecycle:
  write code, run tests, fix failures, commit progress, schedule next steps
- Creates default GOALS.md template on first run
- Autonomous interval overrides heartbeat interval (5 min default vs 30 min)

### Cron Tool
- In autonomous mode, agent can self-schedule on internal channels without
  requiring explicit command_confirm=true (GHSA-pv8c-p6jf-3fpp exception)

### Goal Tool Registration
- Registered in AgentLoop.registerSharedTools when autonomous.enabled=true
  or when tools.goal is explicitly enabled in config

https://claude.ai/code/session_0118WWK5KLRM7ZBUoC8EMgKS
This commit is contained in:
Claude 2026-03-21 15:17:32 +00:00
parent 6148ccc529
commit b7b671f1c1
No known key found for this signature in database
476 changed files with 3773 additions and 3184 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
.github/ISSUE_TEMPLATE/bug_report.md vendored
View file

@ -10,7 +10,7 @@ assignees: ''
## Quick Summary
## Environment & Tools
- **PicoClaw Version:** (e.g., v0.1.2 or commit hash)
- **Piconomous Version:** (e.g., v0.1.2 or commit hash)
- **Go Version:** (e.g., go 1.22)
- **AI Model & Provider:** (e.g., GPT-4o via OpenAI / DeepSeek via SiliconFlow)
- **Operating System:** (e.g., Ubuntu 22.04 / macOS / Android Termux)

2
.github/workflows/docker-build.yml vendored
View file

@ -10,7 +10,7 @@ on:
env:
GHCR_REGISTRY: ghcr.io
GHCR_IMAGE_NAME: ${{ github.repository_owner }}/picoclaw
GHCR_IMAGE_NAME: ${{ github.repository_owner }}/piconomous
DOCKERHUB_REGISTRY: docker.io
DOCKERHUB_IMAGE_NAME: ${{ vars.DOCKERHUB_REPOSITORY }}

4
.github/workflows/upload-tos.yml vendored
View file

@ -41,9 +41,9 @@ jobs:
aws configure set default.s3.addressing_style virtual
TOS_ENDPOINT="https://tos-s3-cn-beijing.volces.com"
# Upload to versioned directory
aws s3 sync artifacts/ "s3://picoclaw-downloads/${{ inputs.tag }}/" \
aws s3 sync artifacts/ "s3://piconomous-downloads/${{ inputs.tag }}/" \
--endpoint-url "$TOS_ENDPOINT"
# Upload to latest (overwrite)
aws s3 sync artifacts/ "s3://picoclaw-downloads/latest/" \
aws s3 sync artifacts/ "s3://piconomous-downloads/latest/" \
--endpoint-url "$TOS_ENDPOINT" \
--delete

70
.goreleaser.yaml
View file

@ -11,17 +11,17 @@ before:
- go-winres make --in web/backend/winres/winres.json --out web/backend/rsrc --product-version={{ .Version }} --file-version={{ .Version }}
builds:
- id: picoclaw
- id: piconomous
env:
- CGO_ENABLED=0
tags:
- stdjson
ldflags:
- -s -w
- -X github.com/sipeed/picoclaw/pkg/config.Version={{ .Version }}
- -X github.com/sipeed/picoclaw/pkg/config.GitCommit={{ .ShortCommit }}
- -X github.com/sipeed/picoclaw/pkg/config.BuildTime={{ .Date }}
- -X github.com/sipeed/picoclaw/pkg/config.GoVersion={{ .Env.GOVERSION }}
- -X github.com/sipeed/piconomous/pkg/config.Version={{ .Version }}
- -X github.com/sipeed/piconomous/pkg/config.GitCommit={{ .ShortCommit }}
- -X github.com/sipeed/piconomous/pkg/config.BuildTime={{ .Date }}
- -X github.com/sipeed/piconomous/pkg/config.GoVersion={{ .Env.GOVERSION }}
goos:
- linux
- windows
@ -41,7 +41,7 @@ builds:
- "7"
gomips:
- softfloat
main: ./cmd/picoclaw
main: ./cmd/piconomous
ignore:
- goos: windows
goarch: arm
@ -52,8 +52,8 @@ builds:
- goos: netbsd
goarch: arm
- id: picoclaw-launcher
binary: picoclaw-launcher
- id: piconomous-launcher
binary: piconomous-launcher
env:
- CGO_ENABLED=0
tags:
@ -90,8 +90,8 @@ builds:
- goos: netbsd
goarch: arm
- id: picoclaw-launcher-tui
binary: picoclaw-launcher-tui
- id: piconomous-launcher-tui
binary: piconomous-launcher-tui
env:
- CGO_ENABLED=0
tags:
@ -117,7 +117,7 @@ builds:
- "7"
gomips:
- softfloat
main: ./cmd/picoclaw-launcher-tui
main: ./cmd/piconomous-launcher-tui
ignore:
- goos: windows
goarch: arm
@ -129,14 +129,14 @@ builds:
goarch: arm
dockers_v2:
- id: picoclaw
- id: piconomous
dockerfile: docker/Dockerfile.goreleaser
extra_files:
- docker/entrypoint.sh
ids:
- picoclaw
- piconomous
images:
- "ghcr.io/{{ .Env.GITHUB_REPOSITORY_OWNER }}/picoclaw"
- "ghcr.io/{{ .Env.GITHUB_REPOSITORY_OWNER }}/piconomous"
- 'docker.io/{{ .Env.DOCKERHUB_IMAGE_NAME }}'
tags:
- '{{ if isEnvSet "NIGHTLY_BUILD" }}nightly{{ else }}{{ .Tag }}{{ end }}'
@ -146,14 +146,14 @@ dockers_v2:
- linux/arm64
- linux/riscv64
- id: picoclaw-launcher
- id: piconomous-launcher
dockerfile: docker/Dockerfile.goreleaser.launcher
ids:
- picoclaw
- picoclaw-launcher
- picoclaw-launcher-tui
- piconomous
- piconomous-launcher
- piconomous-launcher-tui
images:
- "ghcr.io/{{ .Env.GITHUB_REPOSITORY_OWNER }}/picoclaw"
- "ghcr.io/{{ .Env.GITHUB_REPOSITORY_OWNER }}/piconomous"
- 'docker.io/{{ .Env.DOCKERHUB_IMAGE_NAME }}'
tags:
- '{{ if isEnvSet "NIGHTLY_BUILD" }}nightly-launcher{{ else }}{{ .Tag }}-launcher{{ end }}'
@ -167,9 +167,9 @@ notarize:
macos:
- enabled: '{{ isEnvSet "MACOS_SIGN_P12" }}'
ids:
- picoclaw
- picoclaw-launcher
- picoclaw-launcher-tui
- piconomous
- piconomous-launcher
- piconomous-launcher-tui
sign:
certificate: "{{.Env.MACOS_SIGN_P12}}"
password: "{{.Env.MACOS_SIGN_PASSWORD}}"
@ -196,32 +196,32 @@ archives:
formats: [zip]
nfpms:
- id: picoclaw
- id: piconomous
ids:
- picoclaw
- picoclaw-launcher
- picoclaw-launcher-tui
package_name: picoclaw
- piconomous
- piconomous-launcher
- piconomous-launcher-tui
package_name: piconomous
file_name_template: >-
{{ .PackageName }}_
{{- if eq .Arch "amd64" }}x86_64
{{- else if eq .Arch "arm64" }}aarch64
{{- else if eq .Arch "arm" }}armv{{ .Arm }}
{{- else }}{{ .Arch }}{{ end }}
vendor: picoclaw
homepage: https://github.com/{{ .Env.GITHUB_REPOSITORY_OWNER }}/picoclaw
maintainer: picoclaw contributors
description: picoclaw - a tool for managing and running tasks
vendor: piconomous
homepage: https://github.com/{{ .Env.GITHUB_REPOSITORY_OWNER }}/piconomous
maintainer: piconomous contributors
description: piconomous - a tool for managing and running tasks
license: MIT
formats:
- rpm
- deb
bindir: /usr/bin
contents:
- src: web/picoclaw-launcher.desktop
dst: /usr/share/applications/picoclaw-launcher.desktop
- src: web/picoclaw-launcher.png
dst: /usr/share/icons/hicolor/512x512/apps/picoclaw-launcher.png
- src: web/piconomous-launcher.desktop
dst: /usr/share/applications/piconomous-launcher.desktop
- src: web/piconomous-launcher.png
dst: /usr/share/icons/hicolor/512x512/apps/piconomous-launcher.png
changelog:
sort: asc

18
CONTRIBUTING.md
View file

@ -1,8 +1,8 @@
# Contributing to PicoClaw
# Contributing to Piconomous
Thank you for your interest in contributing to PicoClaw! This project is a community-driven effort to build the lightweight and versatile personal AI assistant. We welcome contributions of all kinds: bug fixes, features, documentation, translations, and testing.
Thank you for your interest in contributing to Piconomous! This project is a community-driven effort to build the lightweight and versatile personal AI assistant. We welcome contributions of all kinds: bug fixes, features, documentation, translations, and testing.
PicoClaw itself was substantially developed with AI assistance — we embrace this approach and have built our contribution process around it.
Piconomous itself was substantially developed with AI assistance — we embrace this approach and have built our contribution process around it.
## Table of Contents
@ -31,7 +31,7 @@ We are committed to maintaining a welcoming and respectful community. Be kind, c
- **Feature requests** — Open an issue using the feature request template; discuss before implementing.
- **Code** — Fix bugs or implement features. See the workflow below.
- **Documentation** — Improve READMEs, docs, inline comments, or translations.
- **Testing** — Run PicoClaw on new hardware, channels, or LLM providers and report your results.
- **Testing** — Run Piconomous on new hardware, channels, or LLM providers and report your results.
For substantial new features, please open an issue first to discuss the design before writing code. This prevents wasted effort and ensures alignment with the project's direction.
@ -42,12 +42,12 @@ For substantial new features, please open an issue first to discuss the design b
1. **Fork** the repository on GitHub.
2. **Clone** your fork locally:
```bash
git clone https://github.com/<your-username>/picoclaw.git
cd picoclaw
git clone https://github.com/<your-username>/piconomous.git
cd piconomous
```
3. Add the upstream remote:
```bash
git remote add upstream https://github.com/sipeed/picoclaw.git
git remote add upstream https://github.com/sipeed/piconomous.git
```
---
@ -123,7 +123,7 @@ git rebase upstream/main
## AI-Assisted Contributions
PicoClaw was built with substantial AI assistance, and we fully embrace AI-assisted development. However, contributors must understand their responsibilities when using AI tools.
Piconomous was built with substantial AI assistance, and we fully embrace AI-assisted development. However, contributors must understand their responsibilities when using AI tools.
### Disclosure Is Required
@ -295,7 +295,7 @@ When in doubt, open an issue before writing code. It costs little and prevents w
## A Note on the Project's AI-Driven Origin
PicoClaw's architecture was substantially designed and implemented with AI assistance, guided by human oversight. If you find something that looks odd or over-engineered, it may be an artifact of that process — opening an issue to discuss it is always welcome.
Piconomous's architecture was substantially designed and implemented with AI assistance, guided by human oversight. If you find something that looks odd or over-engineered, it may be an artifact of that process — opening an issue to discuss it is always welcome.
We believe AI-assisted development done responsibly produces great results. We also believe humans must remain accountable for what they ship. These two beliefs are not in conflict.

18
CONTRIBUTING.zh.md
View file

@ -1,8 +1,8 @@
# 参与贡献 PicoClaw
# 参与贡献 Piconomous
感谢你对 PicoClaw 的关注！本项目是一个社区驱动的开源项目，目标是构建 轻量灵活,人人可用 的个人AI助手。我们欢迎一切形式的贡献：Bug 修复、新功能、文档、翻译和测试。
感谢你对 Piconomous 的关注！本项目是一个社区驱动的开源项目，目标是构建 轻量灵活,人人可用 的个人AI助手。我们欢迎一切形式的贡献：Bug 修复、新功能、文档、翻译和测试。
PicoClaw 本身在很大程度上是借助 AI 辅助开发的——我们拥抱这种方式，并围绕它构建了贡献流程。
Piconomous 本身在很大程度上是借助 AI 辅助开发的——我们拥抱这种方式，并围绕它构建了贡献流程。
## 目录
@ -31,7 +31,7 @@ PicoClaw 本身在很大程度上是借助 AI 辅助开发的——我们拥抱
- **功能建议** — 使用功能请求模板提交 Issue，建议在开始实现前先进行讨论。
- **代码贡献** — 修复 Bug 或实现新功能，参见下方工作流程。
- **文档改进** — 完善 README、文档、代码注释或翻译。
- **测试与验证** — 在新硬件、新渠道或新 LLM 提供商上运行 PicoClaw 并反馈结果。
- **测试与验证** — 在新硬件、新渠道或新 LLM 提供商上运行 Piconomous 并反馈结果。
对于较大的新功能，请先提交 Issue 讨论设计方案，再动手写代码。这能避免无效投入，也确保与项目方向保持一致。
@ -42,12 +42,12 @@ PicoClaw 本身在很大程度上是借助 AI 辅助开发的——我们拥抱
1. 在 GitHub 上 **Fork** 本仓库。
2. 将你的 Fork **克隆**到本地：
```bash
git clone https://github.com/<你的用户名>/picoclaw.git
cd picoclaw
git clone https://github.com/<你的用户名>/piconomous.git
cd piconomous
```
3. 添加上游远程仓库：
```bash
git remote add upstream https://github.com/sipeed/picoclaw.git
git remote add upstream https://github.com/sipeed/piconomous.git
```
---
@ -123,7 +123,7 @@ git rebase upstream/main
## AI 辅助贡献
PicoClaw 在很大程度上借助 AI 辅助开发，我们完全拥抱这种开发方式。但贡献者必须清楚地了解自己在使用 AI 工具时所承担的责任。
Piconomous 在很大程度上借助 AI 辅助开发，我们完全拥抱这种开发方式。但贡献者必须清楚地了解自己在使用 AI 工具时所承担的责任。
### 必须披露 AI 使用情况
@ -296,7 +296,7 @@ Release 分支的保护级别高于 `main`，在任何情况下均不允许直
## 关于本项目的 AI 驱动起源
PicoClaw 的架构在人工监督下，经由 AI 辅助完成了大量设计和实现工作。如果你发现某处看起来奇怪或过度设计，这可能是该过程留下的痕迹——欢迎提 Issue 讨论。
Piconomous 的架构在人工监督下，经由 AI 辅助完成了大量设计和实现工作。如果你发现某处看起来奇怪或过度设计，这可能是该过程留下的痕迹——欢迎提 Issue 讨论。
我们相信，负责任地使用 AI 辅助开发能产生优秀的成果。我们同样相信，人类必须对自己提交的内容负责。这两点并不矛盾。

64
Makefile
View file

@ -1,7 +1,7 @@
.PHONY: all build install uninstall clean help test
# Build variables
BINARY_NAME=picoclaw
BINARY_NAME=piconomous
BUILD_DIR=build
CMD_DIR=cmd/$(BINARY_NAME)
MAIN_GO=$(CMD_DIR)/main.go
@ -11,7 +11,7 @@ VERSION?=$(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
GIT_COMMIT=$(shell git rev-parse --short=8 HEAD 2>/dev/null || echo "dev")
BUILD_TIME=$(shell date +%FT%T%z)
GO_VERSION=$(shell $(GO) version | awk '{print $$3}')
CONFIG_PKG=github.com/sipeed/picoclaw/pkg/config
CONFIG_PKG=github.com/sipeed/piconomous/pkg/config
LDFLAGS=-X $(CONFIG_PKG).Version=$(VERSION) -X $(CONFIG_PKG).GitCommit=$(GIT_COMMIT) -X $(CONFIG_PKG).BuildTime=$(BUILD_TIME) -X $(CONFIG_PKG).GoVersion=$(GO_VERSION) -s -w
# Go variables
@ -51,8 +51,8 @@ INSTALL_MAN_DIR=$(INSTALL_PREFIX)/share/man/man1
INSTALL_TMP_SUFFIX=.new
# Workspace and Skills
PICOCLAW_HOME?=$(HOME)/.picoclaw
WORKSPACE_DIR?=$(PICOCLAW_HOME)/workspace
PICONOMOUS_HOME?=$(HOME)/.piconomous
WORKSPACE_DIR?=$(PICONOMOUS_HOME)/workspace
WORKSPACE_SKILLS_DIR=$(WORKSPACE_DIR)/skills
BUILTIN_SKILLS_DIR=$(CURDIR)/skills
@ -105,7 +105,7 @@ generate:
@$(GO) generate ./...
@echo "Run generate complete"
## build: Build the picoclaw binary for current platform
## build: Build the piconomous binary for current platform
build: generate
@echo "Building $(BINARY_NAME) for $(PLATFORM)/$(ARCH)..."
@mkdir -p $(BUILD_DIR)
@ -113,17 +113,17 @@ build: generate
@echo "Build complete: $(BINARY_PATH)"
@ln -sf $(BINARY_NAME)-$(PLATFORM)-$(ARCH) $(BUILD_DIR)/$(BINARY_NAME)
## build-launcher: Build the picoclaw-launcher (web console) binary
## build-launcher: Build the piconomous-launcher (web console) binary
build-launcher:
@echo "Building picoclaw-launcher for $(PLATFORM)/$(ARCH)..."
@echo "Building piconomous-launcher for $(PLATFORM)/$(ARCH)..."
@mkdir -p $(BUILD_DIR)
@if [ ! -f web/backend/dist/index.html ]; then \
echo "Building frontend..."; \
cd web/frontend && pnpm install && pnpm build:backend; \
fi
@$(WEB_GO) build $(GOFLAGS) -o $(BUILD_DIR)/picoclaw-launcher-$(PLATFORM)-$(ARCH) ./web/backend
@ln -sf picoclaw-launcher-$(PLATFORM)-$(ARCH) $(BUILD_DIR)/picoclaw-launcher
@echo "Build complete: $(BUILD_DIR)/picoclaw-launcher"
@$(WEB_GO) build $(GOFLAGS) -o $(BUILD_DIR)/piconomous-launcher-$(PLATFORM)-$(ARCH) ./web/backend
@ln -sf piconomous-launcher-$(PLATFORM)-$(ARCH) $(BUILD_DIR)/piconomous-launcher
@echo "Build complete: $(BUILD_DIR)/piconomous-launcher"
## build-whatsapp-native: Build with WhatsApp native (whatsmeow) support; larger binary
build-whatsapp-native: generate
@ -169,7 +169,7 @@ build-linux-mipsle: generate
build-pi-zero: build-linux-arm build-linux-arm64
@echo "Pi Zero 2 W builds: $(BUILD_DIR)/$(BINARY_NAME)-linux-arm (32-bit), $(BUILD_DIR)/$(BINARY_NAME)-linux-arm64 (64-bit)"
## build-all: Build picoclaw for all platforms
## build-all: Build piconomous for all platforms
build-all: generate
@echo "Building for multiple platforms..."
@mkdir -p $(BUILD_DIR)
@ -187,7 +187,7 @@ build-all: generate
GOOS=netbsd GOARCH=arm64 $(GO) build -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-netbsd-arm64 ./$(CMD_DIR)
@echo "All builds complete"
## install: Install picoclaw to system and copy builtin skills
## install: Install piconomous to system and copy builtin skills
install: build
@echo "Installing $(BINARY_NAME)..."
@mkdir -p $(INSTALL_BIN_DIR)
@ -198,7 +198,7 @@ install: build
@echo "Installed binary to $(INSTALL_BIN_DIR)/$(BINARY_NAME)"
@echo "Installation complete!"
## uninstall: Remove picoclaw from system
## uninstall: Remove piconomous from system
uninstall:
@echo "Uninstalling $(BINARY_NAME)..."
@rm -f $(INSTALL_BIN_DIR)/$(BINARY_NAME)
@ -206,11 +206,11 @@ uninstall:
@echo "Note: Only the executable file has been deleted."
@echo "If you need to delete all configurations (config.json, workspace, etc.), run 'make uninstall-all'"
## uninstall-all: Remove picoclaw and all data
## uninstall-all: Remove piconomous and all data
uninstall-all:
@echo "Removing workspace and skills..."
@rm -rf $(PICOCLAW_HOME)
@echo "Removed workspace: $(PICOCLAW_HOME)"
@rm -rf $(PICONOMOUS_HOME)
@echo "Removed workspace: $(PICONOMOUS_HOME)"
@echo "Complete uninstallation done!"
## clean: Remove build artifacts
@ -222,12 +222,12 @@ clean:
## vet: Run go vet for static analysis
vet: generate
@packages="$$(go list ./...)" && \
$(GO) vet $$(printf '%s\n' "$$packages" | grep -v '^github.com/sipeed/picoclaw/web/')
$(GO) vet $$(printf '%s\n' "$$packages" | grep -v '^github.com/sipeed/piconomous/web/')
@cd web/backend && $(WEB_GO) vet ./...
## test: Test Go code
test: generate
@$(GO) test $$(go list ./... | grep -v github.com/sipeed/picoclaw/web/)
@$(GO) test $$(go list ./... | grep -v github.com/sipeed/piconomous/web/)
@cd web && make test
## fmt: Format Go code
@ -255,19 +255,19 @@ update-deps:
## check: Run vet, fmt, and verify dependencies
check: deps fmt vet test
## run: Build and run picoclaw
## run: Build and run piconomous
run: build
@$(BUILD_DIR)/$(BINARY_NAME) $(ARGS)
## docker-build: Build Docker image (minimal Alpine-based)
docker-build:
@echo "Building minimal Docker image (Alpine-based)..."
docker compose -f docker/docker-compose.yml build picoclaw-agent picoclaw-gateway
docker compose -f docker/docker-compose.yml build piconomous-agent piconomous-gateway
## docker-build-full: Build Docker image with full MCP support (Node.js 24)
docker-build-full:
@echo "Building full-featured Docker image (Node.js 24)..."
docker compose -f docker/docker-compose.full.yml build picoclaw-agent picoclaw-gateway
docker compose -f docker/docker-compose.full.yml build piconomous-agent piconomous-gateway
## docker-test: Test MCP tools in Docker container
docker-test:
@ -275,30 +275,30 @@ docker-test:
@chmod +x scripts/test-docker-mcp.sh
@./scripts/test-docker-mcp.sh
## docker-run: Run picoclaw gateway in Docker (Alpine-based)
## docker-run: Run piconomous gateway in Docker (Alpine-based)
docker-run:
docker compose -f docker/docker-compose.yml --profile gateway up
## docker-run-full: Run picoclaw gateway in Docker (full-featured)
## docker-run-full: Run piconomous gateway in Docker (full-featured)
docker-run-full:
docker compose -f docker/docker-compose.full.yml --profile gateway up
## docker-run-agent: Run picoclaw agent in Docker (interactive, Alpine-based)
## docker-run-agent: Run piconomous agent in Docker (interactive, Alpine-based)
docker-run-agent:
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent
docker compose -f docker/docker-compose.yml run --rm piconomous-agent
## docker-run-agent-full: Run picoclaw agent in Docker (interactive, full-featured)
## docker-run-agent-full: Run piconomous agent in Docker (interactive, full-featured)
docker-run-agent-full:
docker compose -f docker/docker-compose.full.yml run --rm picoclaw-agent
docker compose -f docker/docker-compose.full.yml run --rm piconomous-agent
## docker-clean: Clean Docker images and volumes
docker-clean:
docker compose -f docker/docker-compose.yml down -v
docker compose -f docker/docker-compose.full.yml down -v
docker rmi picoclaw:latest picoclaw:full 2>/dev/null || true
docker rmi piconomous:latest piconomous:full 2>/dev/null || true
## build-macos-app: Build PicoClaw macOS .app bundle (no terminal window)
## build-macos-app: Build Piconomous macOS .app bundle (no terminal window)
build-macos-app:
@echo "Building macOS .app bundle..."
@if [ "$(UNAME_S)" != "Darwin" ]; then \
@ -307,11 +307,11 @@ build-macos-app:
fi
@cd web && $(MAKE) build && cd ..
@./scripts/build-macos-app.sh $(BINARY_NAME)-$(PLATFORM)-$(ARCH)
@echo "macOS .app bundle created: $(BUILD_DIR)/PicoClaw.app"
@echo "macOS .app bundle created: $(BUILD_DIR)/Piconomous.app"
## help: Show this help message
help:
@echo "picoclaw Makefile"
@echo "piconomous Makefile"
@echo ""
@echo "Usage:"
@echo " make [target]"
@ -329,7 +329,7 @@ help:
@echo ""
@echo "Environment Variables:"
@echo " INSTALL_PREFIX # Installation prefix (default: ~/.local)"
@echo " WORKSPACE_DIR # Workspace directory (default: ~/.picoclaw/workspace)"
@echo " WORKSPACE_DIR # Workspace directory (default: ~/.piconomous/workspace)"
@echo " VERSION # Version string (default: git describe)"
@echo ""
@echo "Current Configuration:"

106
README.fr.md
View file

@ -1,7 +1,7 @@
<div align="center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw : Assistant IA Ultra-Efficace en Go</h1>
<h1>Piconomous : Assistant IA Ultra-Efficace en Go</h1>
<h3>Matériel à $10 · <10 Mo de RAM · Démarrage en <1s · 皮皮虾，我们走！</h3>
<p>
@ -9,9 +9,9 @@
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -24,9 +24,9 @@
---
> **PicoClaw** est un projet open-source indépendant initié par [Sipeed](https://sipeed.com). Il est entièrement écrit en **Go** — ce n'est pas un fork d'OpenClaw, de NanoBot ou de tout autre projet.
> **Piconomous** est un projet open-source indépendant initié par [Sipeed](https://sipeed.com). Il est entièrement écrit en **Go** — ce n'est pas un fork d'OpenClaw, de NanoBot ou de tout autre projet.
🦐 **PicoClaw** est un assistant personnel IA ultra-léger inspiré de [NanoBot](https://github.com/HKUDS/nanobot), entièrement réécrit en **Go** via un processus d'auto-amorçage (self-bootstrapping) — où l'agent IA lui-même a piloté l'intégralité de la migration architecturale et de l'optimisation du code.
🦐 **Piconomous** est un assistant personnel IA ultra-léger inspiré de [NanoBot](https://github.com/HKUDS/nanobot), entièrement réécrit en **Go** via un processus d'auto-amorçage (self-bootstrapping) — où l'agent IA lui-même a piloté l'intégralité de la migration architecturale et de l'optimisation du code.
⚡️ **Extrêmement léger :** Fonctionne sur du matériel à seulement **$10** avec **<10 Mo** de RAM. C'est 99% de mémoire en moins qu'OpenClaw et 98% moins cher qu'un Mac mini !
@ -34,7 +34,7 @@
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -48,31 +48,31 @@
> [!CAUTION]
> **🚨 SÉCURITÉ & CANAUX OFFICIELS**
>
> * **PAS DE CRYPTO :** PicoClaw n'a **AUCUN** token/jeton officiel. Toute annonce sur `pump.fun` ou d'autres plateformes de trading est une **ARNAQUE**.
> * **PAS DE CRYPTO :** Piconomous n'a **AUCUN** token/jeton officiel. Toute annonce sur `pump.fun` ou d'autres plateformes de trading est une **ARNAQUE**.
>
> * **DOMAINE OFFICIEL :** Le **SEUL** site officiel est **[picoclaw.io](https://picoclaw.io)**, et le site de l'entreprise est **[sipeed.com](https://sipeed.com)**.
> * **DOMAINE OFFICIEL :** Le **SEUL** site officiel est **[piconomous.io](https://piconomous.io)**, et le site de l'entreprise est **[sipeed.com](https://sipeed.com)**.
> * **Attention :** De nombreux domaines `.ai/.org/.com/.net/...` sont enregistrés par des tiers.
> * **Attention :** PicoClaw est en phase de développement précoce et peut présenter des problèmes de sécurité réseau non résolus. Ne déployez pas en environnement de production avant la version v1.0.
> * **Note :** PicoClaw a récemment fusionné de nombreuses PR, ce qui peut entraîner une empreinte mémoire plus importante (10–20 Mo) dans les dernières versions. Nous prévoyons de prioriser l'optimisation des ressources dès que l'ensemble des fonctionnalités sera stabilisé.
> * **Attention :** Piconomous est en phase de développement précoce et peut présenter des problèmes de sécurité réseau non résolus. Ne déployez pas en environnement de production avant la version v1.0.
> * **Note :** Piconomous a récemment fusionné de nombreuses PR, ce qui peut entraîner une empreinte mémoire plus importante (10–20 Mo) dans les dernières versions. Nous prévoyons de prioriser l'optimisation des ressources dès que l'ensemble des fonctionnalités sera stabilisé.
## 📢 Actualités
2026-03-17 🚀 **v0.2.3 publié !** Interface système tray (Windows & Linux), suivi de statut des sous-agents (`spawn_status`), rechargement à chaud expérimental du gateway, portes de sécurité cron, et 2 correctifs de sécurité. PicoClaw atteint **25K ⭐** !
2026-03-17 🚀 **v0.2.3 publié !** Interface système tray (Windows & Linux), suivi de statut des sous-agents (`spawn_status`), rechargement à chaud expérimental du gateway, portes de sécurité cron, et 2 correctifs de sécurité. Piconomous atteint **25K ⭐** !
2026-03-09 🎉 **v0.2.1 — Plus grande mise à jour !** Support du protocole MCP, 4 nouveaux canaux (Matrix/IRC/WeCom/Discord Proxy), 3 nouveaux fournisseurs (Kimi/Minimax/Avian), pipeline de vision, stockage mémoire JSONL, et routage de modèles.
2026-02-28 📦 **v0.2.0** publié avec support Docker Compose et lanceur Web UI.
2026-02-26 🎉 PicoClaw a atteint **20K étoiles** en seulement 17 jours ! L'orchestration automatique des canaux et les interfaces de capacités sont arrivées.
2026-02-26 🎉 Piconomous a atteint **20K étoiles** en seulement 17 jours ! L'orchestration automatique des canaux et les interfaces de capacités sont arrivées.
<details>
<summary>Actualités précédentes...</summary>
2026-02-16 🎉 PicoClaw a atteint 12K étoiles en une semaine ! Les rôles de mainteneurs communautaires et la [feuille de route](ROADMAP.md) sont officiellement publiés.
2026-02-16 🎉 Piconomous a atteint 12K étoiles en une semaine ! Les rôles de mainteneurs communautaires et la [feuille de route](ROADMAP.md) sont officiellement publiés.
2026-02-13 🎉 PicoClaw a atteint 5000 étoiles en 4 jours ! La Feuille de Route du Projet et le Groupe de Développeurs sont en cours de mise en place.
2026-02-13 🎉 Piconomous a atteint 5000 étoiles en 4 jours ! La Feuille de Route du Projet et le Groupe de Développeurs sont en cours de mise en place.
2026-02-09 🎉 **PicoClaw est lancé !** Construit en 1 jour pour apporter les Agents IA au matériel à $10 avec <10 Mo de RAM. 🦐 PicoClaw, c'est parti !
2026-02-09 🎉 **Piconomous est lancé !** Construit en 1 jour pour apporter les Agents IA au matériel à $10 avec <10 Mo de RAM. 🦐 Piconomous, c'est parti !
</details>
@ -96,14 +96,14 @@
_*Les versions récentes peuvent utiliser 10–20 Mo en raison des fusions rapides de fonctionnalités. L'optimisation des ressources est prévue. La comparaison de démarrage est basée sur des benchmarks à cœur unique 0,8 GHz (voir tableau ci-dessous)._
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- |
| **Langage** | TypeScript | Python | **Go** |
| **RAM** | >1 Go | >100 Mo | **< 10 Mo*** |
| **Démarrage**</br>(cœur 0,8 GHz) | >500s | >30s | **<1s** |
| **Coût** | Mac Mini $599 | La plupart des SBC Linux </br>~$50 | **N'importe quelle carte Linux**</br>**À partir de $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
> 📋 **[Liste de Compatibilité Matérielle](docs/hardware-compatibility.md)** — Voir toutes les cartes testées, du RISC-V à $5 au Raspberry Pi en passant par les téléphones Android. Votre carte n'est pas listée ? Soumettez une PR !
@ -118,9 +118,9 @@ _*Les versions récentes peuvent utiliser 10–20 Mo en raison des fusions rapid
<th><p align="center">🔎 Recherche Web & Apprentissage</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">Développer • Déployer • Mettre à l'échelle</td>
@ -131,26 +131,26 @@ _*Les versions récentes peuvent utiliser 10–20 Mo en raison des fusions rapid
### 📱 Utiliser sur d'anciens téléphones Android
Donnez une seconde vie à votre téléphone d'il y a dix ans ! Transformez-le en assistant IA intelligent avec PicoClaw. Démarrage rapide :
Donnez une seconde vie à votre téléphone d'il y a dix ans ! Transformez-le en assistant IA intelligent avec Piconomous. Démarrage rapide :
1. **Installez [Termux](https://github.com/termux/termux-app)** (Téléchargez depuis [GitHub Releases](https://github.com/termux/termux-app/releases), ou recherchez sur F-Droid / Google Play).
2. **Exécutez les commandes**
```bash
# Téléchargez la dernière version depuis https://github.com/sipeed/picoclaw/releases
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
# Téléchargez la dernière version depuis https://github.com/sipeed/piconomous/releases
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard # chroot fournit une disposition standard du système de fichiers Linux
termux-chroot ./piconomous onboard # chroot fournit une disposition standard du système de fichiers Linux
```
Puis suivez les instructions de la section « Démarrage Rapide » pour terminer la configuration !
<img src="assets/termux.jpg" alt="PicoClaw" width="512">
<img src="assets/termux.jpg" alt="Piconomous" width="512">
### 🐜 Déploiement Innovant à Faible Empreinte
PicoClaw peut être déployé sur pratiquement n'importe quel appareil Linux !
Piconomous peut être déployé sur pratiquement n'importe quel appareil Linux !
- 9,9$ [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) version E (Ethernet) ou W (WiFi6), pour un Assistant Domotique Minimaliste
- 30~$50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), ou 100$ [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) pour la Maintenance Automatisée de Serveurs
@ -162,20 +162,20 @@ PicoClaw peut être déployé sur pratiquement n'importe quel appareil Linux !
## 📦 Installation
### Télécharger depuis picoclaw.io (Recommandé)
### Télécharger depuis piconomous.io (Recommandé)
Visitez **[picoclaw.io](https://picoclaw.io)** — le site officiel détecte automatiquement votre plateforme et propose un téléchargement en un clic. Pas besoin de choisir manuellement une architecture.
Visitez **[piconomous.io](https://piconomous.io)** — le site officiel détecte automatiquement votre plateforme et propose un téléchargement en un clic. Pas besoin de choisir manuellement une architecture.
### Télécharger le binaire précompilé
Vous pouvez aussi télécharger le binaire pour votre plateforme depuis la page [GitHub Releases](https://github.com/sipeed/picoclaw/releases).
Vous pouvez aussi télécharger le binaire pour votre plateforme depuis la page [GitHub Releases](https://github.com/sipeed/piconomous/releases).
### Compiler depuis les sources (pour le développement)
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# Compiler, pas besoin d'installer
@ -210,7 +210,7 @@ Pour des guides détaillés, consultez la documentation ci-dessous. Ce README ne
## <img src="assets/clawdchat-icon.png" width="24" height="24" alt="ClawdChat"> Rejoignez le Réseau Social d'Agents
Connectez PicoClaw au Réseau Social d'Agents simplement en envoyant un seul message via le CLI ou n'importe quelle application de chat intégrée.
Connectez Piconomous au Réseau Social d'Agents simplement en envoyant un seul message via le CLI ou n'importe quelle application de chat intégrée.
**Lisez `https://clawdchat.ai/skill.md` et suivez les instructions pour rejoindre [ClawdChat.ai](https://clawdchat.ai)**
@ -218,25 +218,25 @@ Connectez PicoClaw au Réseau Social d'Agents simplement en envoyant un seul mes
| Commande | Description |
| ------------------------- | ---------------------------------- |
| `picoclaw onboard` | Initialiser la config & le workspace |
| `picoclaw agent -m "..."` | Discuter avec l'agent |
| `picoclaw agent` | Mode chat interactif |
| `picoclaw gateway` | Démarrer le gateway |
| `picoclaw status` | Afficher le statut |
| `picoclaw version` | Afficher les infos de version |
| `picoclaw cron list` | Lister les tâches planifiées |
| `picoclaw cron add ...` | Ajouter une tâche planifiée |
| `picoclaw cron disable` | Désactiver une tâche planifiée |
| `picoclaw cron remove` | Supprimer une tâche planifiée |
| `picoclaw skills list` | Lister les compétences installées |
| `picoclaw skills install` | Installer une compétence |
| `picoclaw migrate` | Migrer les données des anciennes versions |
| `picoclaw auth login` | S'authentifier auprès des fournisseurs |
| `picoclaw model` | Voir ou changer le modèle par défaut |
| `piconomous onboard` | Initialiser la config & le workspace |
| `piconomous agent -m "..."` | Discuter avec l'agent |
| `piconomous agent` | Mode chat interactif |
| `piconomous gateway` | Démarrer le gateway |
| `piconomous status` | Afficher le statut |
| `piconomous version` | Afficher les infos de version |
| `piconomous cron list` | Lister les tâches planifiées |
| `piconomous cron add ...` | Ajouter une tâche planifiée |
| `piconomous cron disable` | Désactiver une tâche planifiée |
| `piconomous cron remove` | Supprimer une tâche planifiée |
| `piconomous skills list` | Lister les compétences installées |
| `piconomous skills install` | Installer une compétence |
| `piconomous migrate` | Migrer les données des anciennes versions |
| `piconomous auth login` | S'authentifier auprès des fournisseurs |
| `piconomous model` | Voir ou changer le modèle par défaut |
### Tâches Planifiées / Rappels
PicoClaw prend en charge les rappels planifiés et les tâches récurrentes via l'outil `cron` :
Piconomous prend en charge les rappels planifiés et les tâches récurrentes via l'outil `cron` :
* **Rappels ponctuels** : « Rappelle-moi dans 10 minutes » → se déclenche une fois après 10 min
* **Tâches récurrentes** : « Rappelle-moi toutes les 2 heures » → se déclenche toutes les 2 heures
@ -246,7 +246,7 @@ PicoClaw prend en charge les rappels planifiés et les tâches récurrentes via
Les PR sont les bienvenues ! Le code est intentionnellement petit et lisible. 🤗
Consultez notre [Feuille de Route Communautaire](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md) complète.
Consultez notre [Feuille de Route Communautaire](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md) complète.
Groupe de développeurs en construction, rejoignez-nous après votre première PR fusionnée !
@ -254,4 +254,4 @@ Groupes d'utilisateurs :
discord : <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">

98
README.id.md
View file

@ -1,7 +1,7 @@
<div align="center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw: Asisten AI Super Ringan berbasis Go</h1>
<h1>Piconomous: Asisten AI Super Ringan berbasis Go</h1>
<h3>Perangkat Keras $10 · RAM <10MB · Boot <1 Detik · Ayo, Berangkat!</h3>
<p>
@ -9,9 +9,9 @@
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -24,9 +24,9 @@
---
> **PicoClaw** adalah proyek open-source independen yang diinisiasi oleh [Sipeed](https://sipeed.com). Ditulis sepenuhnya dalam **Go** — bukan fork dari OpenClaw, NanoBot, atau proyek lainnya.
> **Piconomous** adalah proyek open-source independen yang diinisiasi oleh [Sipeed](https://sipeed.com). Ditulis sepenuhnya dalam **Go** — bukan fork dari OpenClaw, NanoBot, atau proyek lainnya.
🦐 PicoClaw adalah asisten AI pribadi yang super ringan, terinspirasi dari [NanoBot](https://github.com/HKUDS/nanobot), ditulis ulang sepenuhnya dalam Go melalui proses "self-bootstrapping" — di mana AI Agent itu sendiri yang memandu seluruh migrasi arsitektur dan optimasi kode.
🦐 Piconomous adalah asisten AI pribadi yang super ringan, terinspirasi dari [NanoBot](https://github.com/HKUDS/nanobot), ditulis ulang sepenuhnya dalam Go melalui proses "self-bootstrapping" — di mana AI Agent itu sendiri yang memandu seluruh migrasi arsitektur dan optimasi kode.
⚡️ Berjalan di perangkat keras $10 dengan RAM <10MB: Hemat 99% memori dibanding OpenClaw dan 98% lebih murah dibanding Mac mini!
@ -34,7 +34,7 @@
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -48,31 +48,31 @@
> [!CAUTION]
> **🚨 KEAMANAN & SALURAN RESMI**
>
> * **TANPA KRIPTO:** PicoClaw **TIDAK** memiliki token/koin resmi. Semua klaim di `pump.fun` atau platform trading lainnya adalah **PENIPUAN**.
> * **TANPA KRIPTO:** Piconomous **TIDAK** memiliki token/koin resmi. Semua klaim di `pump.fun` atau platform trading lainnya adalah **PENIPUAN**.
>
> * **DOMAIN RESMI:** Satu-satunya website resmi adalah **[picoclaw.io](https://picoclaw.io)**, dan website perusahaan adalah **[sipeed.com](https://sipeed.com)**
> * **DOMAIN RESMI:** Satu-satunya website resmi adalah **[piconomous.io](https://piconomous.io)**, dan website perusahaan adalah **[sipeed.com](https://sipeed.com)**
> * **Peringatan:** Banyak domain `.ai/.org/.com/.net/...` yang didaftarkan oleh pihak ketiga.
> * **Peringatan:** PicoClaw masih dalam tahap pengembangan awal dan mungkin memiliki masalah keamanan jaringan yang belum teratasi. Jangan deploy ke lingkungan produksi sebelum rilis v1.0.
> * **Catatan:** PicoClaw baru-baru ini menggabungkan banyak PR, yang mungkin mengakibatkan penggunaan memori lebih besar (10–20MB) pada versi terbaru. Kami berencana untuk memprioritaskan optimasi sumber daya segera setelah fitur saat ini mencapai kondisi stabil.
> * **Peringatan:** Piconomous masih dalam tahap pengembangan awal dan mungkin memiliki masalah keamanan jaringan yang belum teratasi. Jangan deploy ke lingkungan produksi sebelum rilis v1.0.
> * **Catatan:** Piconomous baru-baru ini menggabungkan banyak PR, yang mungkin mengakibatkan penggunaan memori lebih besar (10–20MB) pada versi terbaru. Kami berencana untuk memprioritaskan optimasi sumber daya segera setelah fitur saat ini mencapai kondisi stabil.
## 📢 Berita
2026-03-17 🚀 **v0.2.3 Dirilis!** UI system tray (Windows & Linux), pelacakan status sub-agent (`spawn_status`), eksperimental gateway hot-reload, gerbang keamanan cron, dan 2 perbaikan keamanan. PicoClaw kini di **25K ⭐**!
2026-03-17 🚀 **v0.2.3 Dirilis!** UI system tray (Windows & Linux), pelacakan status sub-agent (`spawn_status`), eksperimental gateway hot-reload, gerbang keamanan cron, dan 2 perbaikan keamanan. Piconomous kini di **25K ⭐**!
2026-03-09 🎉 **v0.2.1 — Update terbesar!** Dukungan protokol MCP, 4 channel baru (Matrix/IRC/WeCom/Discord Proxy), 3 provider baru (Kimi/Minimax/Avian), pipeline vision, penyimpanan memori JSONL, dan routing model.
2026-02-28 📦 **v0.2.0** dirilis dengan dukungan Docker Compose dan launcher Web UI.
2026-02-26 🎉 PicoClaw mencapai **20K bintang** hanya dalam 17 hari! Orkestrasi channel otomatis dan antarmuka kapabilitas diluncurkan.
2026-02-26 🎉 Piconomous mencapai **20K bintang** hanya dalam 17 hari! Orkestrasi channel otomatis dan antarmuka kapabilitas diluncurkan.
<details>
<summary>Berita lama...</summary>
2026-02-16 🎉 PicoClaw mencapai 12K bintang dalam satu minggu! Peran maintainer komunitas dan [roadmap](ROADMAP.md) resmi diposting.
2026-02-16 🎉 Piconomous mencapai 12K bintang dalam satu minggu! Peran maintainer komunitas dan [roadmap](ROADMAP.md) resmi diposting.
2026-02-13 🎉 PicoClaw mencapai 5000 bintang dalam 4 hari! Roadmap Proyek dan pengaturan Grup Pengembang sedang berjalan.
2026-02-13 🎉 Piconomous mencapai 5000 bintang dalam 4 hari! Roadmap Proyek dan pengaturan Grup Pengembang sedang berjalan.
2026-02-09 🎉 **PicoClaw Diluncurkan!** Dibangun dalam 1 hari untuk menghadirkan AI Agent ke perangkat keras $10 dengan RAM <10MB. 🦐 PicoClaw, Ayo Berangkat!
2026-02-09 🎉 **Piconomous Diluncurkan!** Dibangun dalam 1 hari untuk menghadirkan AI Agent ke perangkat keras $10 dengan RAM <10MB. 🦐 Piconomous, Ayo Berangkat!
</details>
@ -96,14 +96,14 @@
_*Versi terbaru mungkin menggunakan 10–20MB karena penggabungan fitur yang cepat. Optimasi sumber daya direncanakan. Perbandingan startup berdasarkan benchmark prosesor single-core 0,8GHz (lihat tabel di bawah)._
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- |
| **Bahasa** | TypeScript | Python | **Go** |
| **RAM** | >1GB | >100MB | **< 10MB*** |
| **Startup**</br>(0,8GHz core) | >500d | >30d | **<1d** |
| **Biaya** | Mac Mini $599 | Kebanyakan Linux SBC </br>~$50 | **Semua Board Linux**</br>**Mulai dari $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
## 🦾 Demonstrasi
@ -116,9 +116,9 @@ _*Versi terbaru mungkin menggunakan 10–20MB karena penggabungan fitur yang cep
<th><p align="center">🔎 Pencarian Web & Pembelajaran</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">Develop • Deploy • Scale</td>
@ -129,26 +129,26 @@ _*Versi terbaru mungkin menggunakan 10–20MB karena penggabungan fitur yang cep
### 📱 Jalankan di HP Android Lama
Berikan kehidupan kedua untuk HP lama Anda! Ubah menjadi Asisten AI pintar dengan PicoClaw. Panduan Cepat:
Berikan kehidupan kedua untuk HP lama Anda! Ubah menjadi Asisten AI pintar dengan Piconomous. Panduan Cepat:
1. **Instal [Termux](https://github.com/termux/termux-app)** (Unduh dari [GitHub Releases](https://github.com/termux/termux-app/releases), atau cari di F-Droid / Google Play).
2. **Jalankan perintah**
```bash
# Unduh rilis terbaru dari https://github.com/sipeed/picoclaw/releases
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
# Unduh rilis terbaru dari https://github.com/sipeed/piconomous/releases
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard
termux-chroot ./piconomous onboard
```
Kemudian ikuti instruksi di bagian "Panduan Cepat" untuk menyelesaikan konfigurasi!
<img src="assets/termux.jpg" alt="PicoClaw" width="512">
<img src="assets/termux.jpg" alt="Piconomous" width="512">
### 🐜 Deploy Inovatif dengan Footprint Rendah
PicoClaw dapat di-deploy di hampir semua perangkat Linux!
Piconomous dapat di-deploy di hampir semua perangkat Linux!
- $9,9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) versi E(Ethernet) atau W(WiFi6), untuk Home Assistant Minimal
- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), atau $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) untuk Pemeliharaan Server Otomatis
@ -162,14 +162,14 @@ PicoClaw dapat di-deploy di hampir semua perangkat Linux!
### Instal dengan binary yang sudah dikompilasi
Unduh binary untuk platform Anda dari halaman [Releases](https://github.com/sipeed/picoclaw/releases).
Unduh binary untuk platform Anda dari halaman [Releases](https://github.com/sipeed/piconomous/releases).
### Instal dari source (fitur terbaru, disarankan untuk pengembangan)
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# Build, tidak perlu instal
@ -211,24 +211,24 @@ Hubungkan Picoclaw ke Jaringan Sosial Agent hanya dengan mengirim satu pesan mel
| Perintah | Deskripsi |
| ------------------------- | -------------------------------- |
| `picoclaw onboard` | Inisialisasi konfigurasi & workspace |
| `picoclaw agent -m "..."` | Chat dengan agent |
| `picoclaw agent` | Mode chat interaktif |
| `picoclaw gateway` | Mulai gateway |
| `picoclaw status` | Tampilkan status |
| `picoclaw version` | Tampilkan info versi |
| `picoclaw cron list` | Daftar semua tugas terjadwal |
| `picoclaw cron add ...` | Tambah tugas terjadwal |
| `picoclaw cron disable` | Nonaktifkan tugas terjadwal |
| `picoclaw cron remove` | Hapus tugas terjadwal |
| `picoclaw skills list` | Daftar skill yang terinstal |
| `picoclaw skills install` | Instal skill |
| `picoclaw migrate` | Migrasi data dari versi lama |
| `picoclaw auth login` | Autentikasi dengan provider |
| `piconomous onboard` | Inisialisasi konfigurasi & workspace |
| `piconomous agent -m "..."` | Chat dengan agent |
| `piconomous agent` | Mode chat interaktif |
| `piconomous gateway` | Mulai gateway |
| `piconomous status` | Tampilkan status |
| `piconomous version` | Tampilkan info versi |
| `piconomous cron list` | Daftar semua tugas terjadwal |
| `piconomous cron add ...` | Tambah tugas terjadwal |
| `piconomous cron disable` | Nonaktifkan tugas terjadwal |
| `piconomous cron remove` | Hapus tugas terjadwal |
| `piconomous skills list` | Daftar skill yang terinstal |
| `piconomous skills install` | Instal skill |
| `piconomous migrate` | Migrasi data dari versi lama |
| `piconomous auth login` | Autentikasi dengan provider |
### Tugas Terjadwal / Pengingat
PicoClaw mendukung pengingat terjadwal dan tugas berulang melalui tool `cron`:
Piconomous mendukung pengingat terjadwal dan tugas berulang melalui tool `cron`:
* **Pengingat satu kali**: "Ingatkan saya dalam 10 menit" → terpicu sekali setelah 10 menit
* **Tugas berulang**: "Ingatkan saya setiap 2 jam" → terpicu setiap 2 jam
@ -238,7 +238,7 @@ PicoClaw mendukung pengingat terjadwal dan tugas berulang melalui tool `cron`:
PR sangat diterima! Codebase sengaja dibuat kecil dan mudah dibaca. 🤗
Lihat [Roadmap Komunitas](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md) lengkap kami.
Lihat [Roadmap Komunitas](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md) lengkap kami.
Grup pengembang sedang dibangun, bergabunglah setelah PR pertama Anda di-merge!
@ -246,4 +246,4 @@ Grup Pengguna:
discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">

100
README.it.md
View file

@ -1,7 +1,7 @@
<div align="center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw: Assistente IA Ultra-Efficiente in Go</h1>
<h1>Piconomous: Assistente IA Ultra-Efficiente in Go</h1>
<h3>Hardware da $10 · <10MB RAM · Boot in <1s · 皮皮虾，我们走！</h3>
<p>
@ -9,9 +9,9 @@
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -24,9 +24,9 @@
---
> **PicoClaw** è un progetto open-source indipendente avviato da [Sipeed](https://sipeed.com). È scritto interamente in **Go** — non è un fork di OpenClaw, NanoBot o di qualsiasi altro progetto.
> **Piconomous** è un progetto open-source indipendente avviato da [Sipeed](https://sipeed.com). È scritto interamente in **Go** — non è un fork di OpenClaw, NanoBot o di qualsiasi altro progetto.
🦐 PicoClaw è un assistente IA personale ultra-leggero ispirato a [NanoBot](https://github.com/HKUDS/nanobot), riscritto da zero in Go attraverso un processo di auto-bootstrapping, in cui l'agente IA stesso ha guidato l'intera migrazione architetturale e l'ottimizzazione del codice.
🦐 Piconomous è un assistente IA personale ultra-leggero ispirato a [NanoBot](https://github.com/HKUDS/nanobot), riscritto da zero in Go attraverso un processo di auto-bootstrapping, in cui l'agente IA stesso ha guidato l'intera migrazione architetturale e l'ottimizzazione del codice.
⚡️ Funziona su hardware da $10 con meno di 10MB di RAM: il 99% di memoria in meno rispetto a OpenClaw e il 98% più economico di un Mac mini!
@ -34,7 +34,7 @@
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -48,31 +48,31 @@
> [!CAUTION]
> **🚨 SICUREZZA & CANALI UFFICIALI**
>
> * **NESSUNA CRYPTO:** PicoClaw non ha **NESSUN** token/coin ufficiale. Qualsiasi annuncio su `pump.fun` o altre piattaforme di trading è una **TRUFFA**.
> * **NESSUNA CRYPTO:** Piconomous non ha **NESSUN** token/coin ufficiale. Qualsiasi annuncio su `pump.fun` o altre piattaforme di trading è una **TRUFFA**.
>
> * **DOMINIO UFFICIALE:** L'**UNICO** sito ufficiale è **[picoclaw.io](https://picoclaw.io)**, e il sito aziendale è **[sipeed.com](https://sipeed.com)**.
> * **DOMINIO UFFICIALE:** L'**UNICO** sito ufficiale è **[piconomous.io](https://piconomous.io)**, e il sito aziendale è **[sipeed.com](https://sipeed.com)**.
> * **Attenzione:** Molti domini `.ai/.org/.com/.net/...` sono registrati da terze parti.
> * **Attenzione:** PicoClaw è in fase di sviluppo iniziale e potrebbe avere problemi di sicurezza di rete non risolti. Non distribuire in ambienti di produzione prima della release v1.0.
> * **Nota:** PicoClaw ha recentemente unito molte PR, il che potrebbe comportare un'impronta di memoria maggiore (10–20MB) nelle ultime versioni. Prevediamo di dare priorità all'ottimizzazione delle risorse non appena il set di funzionalità corrente raggiungerà uno stato stabile.
> * **Attenzione:** Piconomous è in fase di sviluppo iniziale e potrebbe avere problemi di sicurezza di rete non risolti. Non distribuire in ambienti di produzione prima della release v1.0.
> * **Nota:** Piconomous ha recentemente unito molte PR, il che potrebbe comportare un'impronta di memoria maggiore (10–20MB) nelle ultime versioni. Prevediamo di dare priorità all'ottimizzazione delle risorse non appena il set di funzionalità corrente raggiungerà uno stato stabile.
## 📢 Novità
2026-03-17 🚀 **v0.2.3 rilasciata!** Interfaccia system tray (Windows & Linux), tracciamento dello stato dei sub-agent (`spawn_status`), hot-reload sperimentale del gateway, gate di sicurezza per cron e 2 correzioni di sicurezza. PicoClaw raggiunge **25K ⭐**!
2026-03-17 🚀 **v0.2.3 rilasciata!** Interfaccia system tray (Windows & Linux), tracciamento dello stato dei sub-agent (`spawn_status`), hot-reload sperimentale del gateway, gate di sicurezza per cron e 2 correzioni di sicurezza. Piconomous raggiunge **25K ⭐**!
2026-03-09 🎉 **v0.2.1 — Il più grande aggiornamento di sempre!** Supporto al protocollo MCP, 4 nuovi canali (Matrix/IRC/WeCom/Discord Proxy), 3 nuovi provider (Kimi/Minimax/Avian), pipeline di visione, store di memoria JSONL e routing dei modelli.
2026-02-28 📦 **v0.2.0** rilasciata con supporto Docker Compose e launcher Web UI.
2026-02-26 🎉 PicoClaw ha raggiunto **20K stelle** in soli 17 giorni! Arrivate l'orchestrazione automatica dei canali e le interfacce di capacità.
2026-02-26 🎉 Piconomous ha raggiunto **20K stelle** in soli 17 giorni! Arrivate l'orchestrazione automatica dei canali e le interfacce di capacità.
<details>
<summary>Notizie precedenti...</summary>
2026-02-16 🎉 PicoClaw ha raggiunto 12K stelle in una settimana! Ruoli di maintainer della community e [roadmap](ROADMAP.md) pubblicati ufficialmente.
2026-02-16 🎉 Piconomous ha raggiunto 12K stelle in una settimana! Ruoli di maintainer della community e [roadmap](ROADMAP.md) pubblicati ufficialmente.
2026-02-13 🎉 PicoClaw ha raggiunto 5000 stelle in 4 giorni! Roadmap del progetto e gruppo sviluppatori in fase di avvio.
2026-02-13 🎉 Piconomous ha raggiunto 5000 stelle in 4 giorni! Roadmap del progetto e gruppo sviluppatori in fase di avvio.
2026-02-09 🎉 **PicoClaw lanciato!** Costruito in 1 giorno per portare gli agenti IA su hardware da $10 con <10MB di RAM. 🦐 PicoClaw, andiamo!
2026-02-09 🎉 **Piconomous lanciato!** Costruito in 1 giorno per portare gli agenti IA su hardware da $10 con <10MB di RAM. 🦐 Piconomous, andiamo!
</details>
@ -96,14 +96,14 @@
_*Le versioni recenti potrebbero usare 10–20MB a causa delle fusioni rapide di funzionalità. L'ottimizzazione delle risorse è pianificata. Il confronto dell'avvio è basato su benchmark con singolo core a 0,8 GHz (vedi tabella sotto)._
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- |
| **Linguaggio** | TypeScript | Python | **Go** |
| **RAM** | >1GB | >100MB | **< 10MB*** |
| **Avvio**</br>(core 0,8 GHz) | >500s | >30s | **<1s** |
| **Costo** | Mac Mini $599 | La maggior parte degli SBC Linux </br>~$50 | **Qualsiasi scheda Linux**</br>**A partire da $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
## 🦾 Dimostrazione
@ -116,9 +116,9 @@ _*Le versioni recenti potrebbero usare 10–20MB a causa delle fusioni rapide di
<th><p align="center">🔎 Ricerca Web & Apprendimento</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">Sviluppa • Distribuisci • Scala</td>
@ -129,26 +129,26 @@ _*Le versioni recenti potrebbero usare 10–20MB a causa delle fusioni rapide di
### 📱 Usa su vecchi telefoni Android
Dai una seconda vita al tuo telefono di dieci anni fa! Trasformalo in un assistente IA intelligente con PicoClaw. Avvio rapido:
Dai una seconda vita al tuo telefono di dieci anni fa! Trasformalo in un assistente IA intelligente con Piconomous. Avvio rapido:
1. **Installa [Termux](https://github.com/termux/termux-app)** (Scarica da [GitHub Releases](https://github.com/termux/termux-app/releases), o cerca su F-Droid / Google Play).
2. **Esegui i comandi**
```bash
# Scarica l'ultima release da https://github.com/sipeed/picoclaw/releases
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
# Scarica l'ultima release da https://github.com/sipeed/piconomous/releases
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard
termux-chroot ./piconomous onboard
```
Poi segui le istruzioni nella sezione "Avvio Rapido" per completare la configurazione!
<img src="assets/termux.jpg" alt="PicoClaw" width="512">
<img src="assets/termux.jpg" alt="Piconomous" width="512">
### 🐜 Deploy Innovativo a Bassa Impronta
PicoClaw può essere distribuito su quasi qualsiasi dispositivo Linux!
Piconomous può essere distribuito su quasi qualsiasi dispositivo Linux!
- $9,9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) versione E (Ethernet) o W (WiFi6), per un Assistente Domotico Minimale
- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), o $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) per la Manutenzione Automatizzata dei Server
@ -162,14 +162,14 @@ PicoClaw può essere distribuito su quasi qualsiasi dispositivo Linux!
### Installa con binario precompilato
Scarica il binario per la tua piattaforma dalla pagina delle [Releases](https://github.com/sipeed/picoclaw/releases).
Scarica il binario per la tua piattaforma dalla pagina delle [Releases](https://github.com/sipeed/piconomous/releases).
### Installa dai sorgenti (ultime funzionalità, consigliato per lo sviluppo)
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# Compila, senza installare
@ -203,7 +203,7 @@ Per guide dettagliate, consulta la documentazione qui sotto. Il README copre sol
## <img src="assets/clawdchat-icon.png" width="24" height="24" alt="ClawdChat"> Unisciti al Social Network degli Agent
Connetti PicoClaw al Social Network degli Agent semplicemente inviando un singolo messaggio tramite CLI o qualsiasi app di chat integrata.
Connetti Piconomous al Social Network degli Agent semplicemente inviando un singolo messaggio tramite CLI o qualsiasi app di chat integrata.
**Leggi `https://clawdchat.ai/skill.md` e segui le istruzioni per unirti a [ClawdChat.ai](https://clawdchat.ai)**
@ -211,24 +211,24 @@ Connetti PicoClaw al Social Network degli Agent semplicemente inviando un singol
| Comando | Descrizione |
| ------------------------- | ---------------------------------- |
| `picoclaw onboard` | Inizializza config & workspace |
| `picoclaw agent -m "..."` | Chatta con l'agent |
| `picoclaw agent` | Modalità chat interattiva |
| `picoclaw gateway` | Avvia il gateway |
| `picoclaw status` | Mostra lo stato |
| `picoclaw version` | Mostra le info sulla versione |
| `picoclaw cron list` | Elenca tutti i job pianificati |
| `picoclaw cron add ...` | Aggiunge un job pianificato |
| `picoclaw cron disable` | Disabilita un job pianificato |
| `picoclaw cron remove` | Rimuove un job pianificato |
| `picoclaw skills list` | Elenca le skill installate |
| `picoclaw skills install` | Installa una skill |
| `picoclaw migrate` | Migra i dati dalle versioni precedenti |
| `picoclaw auth login` | Autenticazione con i provider |
| `piconomous onboard` | Inizializza config & workspace |
| `piconomous agent -m "..."` | Chatta con l'agent |
| `piconomous agent` | Modalità chat interattiva |
| `piconomous gateway` | Avvia il gateway |
| `piconomous status` | Mostra lo stato |
| `piconomous version` | Mostra le info sulla versione |
| `piconomous cron list` | Elenca tutti i job pianificati |
| `piconomous cron add ...` | Aggiunge un job pianificato |
| `piconomous cron disable` | Disabilita un job pianificato |
| `piconomous cron remove` | Rimuove un job pianificato |
| `piconomous skills list` | Elenca le skill installate |
| `piconomous skills install` | Installa una skill |
| `piconomous migrate` | Migra i dati dalle versioni precedenti |
| `piconomous auth login` | Autenticazione con i provider |
### Task Pianificati / Promemoria
PicoClaw supporta promemoria pianificati e task ricorrenti tramite lo strumento `cron`:
Piconomous supporta promemoria pianificati e task ricorrenti tramite lo strumento `cron`:
* **Promemoria una tantum**: "Ricordami tra 10 minuti" → si attiva una volta dopo 10 min
* **Task ricorrenti**: "Ricordami ogni 2 ore" → si attiva ogni 2 ore
@ -238,7 +238,7 @@ PicoClaw supporta promemoria pianificati e task ricorrenti tramite lo strumento
Le PR sono benvenute! Il codice è volutamente piccolo e leggibile. 🤗
Consulta la nostra [Roadmap della Community](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md) completa.
Consulta la nostra [Roadmap della Community](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md) completa.
Gruppo sviluppatori in costruzione, unisciti dopo la tua prima PR accettata!
@ -246,4 +246,4 @@ Gruppi utenti:
discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">

106
README.ja.md
View file

@ -1,7 +1,7 @@
<div align="center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw: Go で書かれた超効率 AI アシスタント</h1>
<h1>Piconomous: Go で書かれた超効率 AI アシスタント</h1>
<h3>$10 ハードウェア · <10MB RAM · <1秒起動 · 行くぜ、シャコ！</h3>
<p>
@ -9,9 +9,9 @@
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -24,9 +24,9 @@
---
> **PicoClaw** は [Sipeed](https://sipeed.com) が立ち上げた独立したオープンソースプロジェクトです。完全に **Go 言語**で一から書かれており、OpenClaw、NanoBot、その他のプロジェクトのフォークではありません。
> **Piconomous** は [Sipeed](https://sipeed.com) が立ち上げた独立したオープンソースプロジェクトです。完全に **Go 言語**で一から書かれており、OpenClaw、NanoBot、その他のプロジェクトのフォークではありません。
🦐 PicoClaw は [NanoBot](https://github.com/HKUDS/nanobot) にインスパイアされた超軽量パーソナル AI アシスタントです。Go でゼロからリファクタリングされ、AI エージェント自身がアーキテクチャの移行とコード最適化を推進するセルフブートストラッピングプロセスで構築されました。
🦐 Piconomous は [NanoBot](https://github.com/HKUDS/nanobot) にインスパイアされた超軽量パーソナル AI アシスタントです。Go でゼロからリファクタリングされ、AI エージェント自身がアーキテクチャの移行とコード最適化を推進するセルフブートストラッピングプロセスで構築されました。
⚡️ $10 のハードウェアで 10MB 未満の RAM で動作：OpenClaw より 99% 少ないメモリ、Mac mini より 98% 安い！
@ -34,7 +34,7 @@
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -48,31 +48,31 @@
> [!CAUTION]
> **🚨 セキュリティ＆公式チャンネル**
>
> * **暗号通貨なし:** PicoClaw には公式トークン/コインは**一切ありません**。`pump.fun` やその他の取引プラットフォームでの主張はすべて**詐欺**です。
> * **暗号通貨なし:** Piconomous には公式トークン/コインは**一切ありません**。`pump.fun` やその他の取引プラットフォームでの主張はすべて**詐欺**です。
>
> * **公式ドメイン:** **唯一**の公式サイトは **[picoclaw.io](https://picoclaw.io)**、企業サイトは **[sipeed.com](https://sipeed.com)** です。
> * **公式ドメイン:** **唯一**の公式サイトは **[piconomous.io](https://piconomous.io)**、企業サイトは **[sipeed.com](https://sipeed.com)** です。
> * **注意:** 多くの `.ai/.org/.com/.net/...` ドメインは第三者によって登録されています。
> * **注意:** PicoClaw は初期開発段階にあり、未解決のネットワークセキュリティ問題がある可能性があります。v1.0 リリース前に本番環境へのデプロイは避けてください。
> * **注記:** PicoClaw は最近多くの PR をマージしており、最新バージョンではメモリフットプリントが大きくなる場合があります（10〜20MB）。機能セットが安定次第、リソース最適化を優先する予定です。
> * **注意:** Piconomous は初期開発段階にあり、未解決のネットワークセキュリティ問題がある可能性があります。v1.0 リリース前に本番環境へのデプロイは避けてください。
> * **注記:** Piconomous は最近多くの PR をマージしており、最新バージョンではメモリフットプリントが大きくなる場合があります（10〜20MB）。機能セットが安定次第、リソース最適化を優先する予定です。
## 📢 ニュース
2026-03-17 🚀 **v0.2.3 リリース！** システムトレイ UI（Windows & Linux）、サブエージェントステータス追跡（`spawn_status`）、実験的ゲートウェイホットリロード、cron セキュリティゲート、セキュリティ修正 2 件。PicoClaw **25K ⭐** 達成！
2026-03-17 🚀 **v0.2.3 リリース！** システムトレイ UI（Windows & Linux）、サブエージェントステータス追跡（`spawn_status`）、実験的ゲートウェイホットリロード、cron セキュリティゲート、セキュリティ修正 2 件。Piconomous **25K ⭐** 達成！
2026-03-09 🎉 **v0.2.1 — 史上最大のアップデート！** MCP プロトコル対応、4 つの新チャネル（Matrix/IRC/WeCom/Discord Proxy）、3 つの新プロバイダー（Kimi/Minimax/Avian）、ビジョンパイプライン、JSONL メモリストア、モデルルーティング。
2026-02-28 📦 **v0.2.0** リリース — Docker Compose 対応と Web UI ランチャー。
2026-02-26 🎉 PicoClaw がわずか 17 日で **20K スター** 達成！チャネル自動オーケストレーションとケイパビリティインターフェースが実装されました。
2026-02-26 🎉 Piconomous がわずか 17 日で **20K スター** 達成！チャネル自動オーケストレーションとケイパビリティインターフェースが実装されました。
<details>
<summary>過去のニュース...</summary>
2026-02-16 🎉 PicoClaw が 1 週間で 12K スター達成！コミュニティメンテナーの役割と[ロードマップ](ROADMAP.md)が正式に公開されました。
2026-02-16 🎉 Piconomous が 1 週間で 12K スター達成！コミュニティメンテナーの役割と[ロードマップ](ROADMAP.md)が正式に公開されました。
2026-02-13 🎉 PicoClaw が 4 日間で 5000 スター達成！プロジェクトロードマップと開発者グループの準備が進行中。
2026-02-13 🎉 Piconomous が 4 日間で 5000 スター達成！プロジェクトロードマップと開発者グループの準備が進行中。
2026-02-09 🎉 **PicoClaw リリース！** $10 ハードウェアで 10MB 未満の RAM で動く AI エージェントを 1 日で構築。🦐 行くぜ、シャコ！
2026-02-09 🎉 **Piconomous リリース！** $10 ハードウェアで 10MB 未満の RAM で動く AI エージェントを 1 日で構築。🦐 行くぜ、シャコ！
</details>
@ -96,14 +96,14 @@
_*最近のバージョンでは急速な機能マージにより 10〜20MB になる場合があります。リソース最適化は計画中です。起動時間の比較は 0.8GHz シングルコアベンチマークに基づいています（下表参照）。_
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- |
| **言語** | TypeScript | Python | **Go** |
| **RAM** | >1GB | >100MB | **< 10MB*** |
| **起動時間**</br>(0.8GHz コア) | >500秒 | >30秒 | **<1秒** |
| **コスト** | Mac Mini $599 | 大半の Linux SBC </br>~$50 | **あらゆる Linux ボード**</br>**最安 $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
> 📋 **[ハードウェア互換性リスト](docs/hardware-compatibility.md)** — テスト済みの全ボード一覧（$5 RISC-V から Raspberry Pi、Android スマートフォンまで）。お使いのボードが未掲載？PR を送ってください！
@ -118,9 +118,9 @@ _*最近のバージョンでは急速な機能マージにより 10〜20MB に
<th><p align="center">🔎 Web 検索＆学習</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">開発 · デプロイ · スケール</td>
@ -131,26 +131,26 @@ _*最近のバージョンでは急速な機能マージにより 10〜20MB に
### 📱 古い Android スマホで動かす
10 年前のスマホに第二の人生を！PicoClaw でスマート AI アシスタントに変身させましょう。クイックスタート：
10 年前のスマホに第二の人生を！Piconomous でスマート AI アシスタントに変身させましょう。クイックスタート：
1. **[Termux](https://github.com/termux/termux-app) をインストール**（[GitHub Releases](https://github.com/termux/termux-app/releases) からダウンロード、または F-Droid / Google Play で検索）。
2. **コマンドを実行**
```bash
# https://github.com/sipeed/picoclaw/releases から最新リリースをダウンロード
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
# https://github.com/sipeed/piconomous/releases から最新リリースをダウンロード
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard # chroot で標準的な Linux ファイルシステムレイアウトを提供
termux-chroot ./piconomous onboard # chroot で標準的な Linux ファイルシステムレイアウトを提供
```
その後「クイックスタート」セクションの手順に従って設定を完了してください！
<img src="assets/termux.jpg" alt="PicoClaw" width="512">
<img src="assets/termux.jpg" alt="Piconomous" width="512">
### 🐜 革新的な省フットプリントデプロイ
PicoClaw はほぼすべての Linux デバイスにデプロイできます！
Piconomous はほぼすべての Linux デバイスにデプロイできます！
- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) E(Ethernet) または W(WiFi6) バージョン、最小ホームアシスタントに
- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html) または $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) サーバー自動メンテナンスに
@ -162,20 +162,20 @@ PicoClaw はほぼすべての Linux デバイスにデプロイできます！
## 📦 インストール
### picoclaw.io からダウンロード（推奨）
### piconomous.io からダウンロード（推奨）
**[picoclaw.io](https://picoclaw.io)** にアクセス — 公式サイトがプラットフォームを自動検出し、ワンクリックでダウンロードできます。アーキテクチャを手動で選ぶ必要はありません。
**[piconomous.io](https://piconomous.io)** にアクセス — 公式サイトがプラットフォームを自動検出し、ワンクリックでダウンロードできます。アーキテクチャを手動で選ぶ必要はありません。
### プリコンパイル済みバイナリをダウンロード
または、[GitHub Releases](https://github.com/sipeed/picoclaw/releases) ページからプラットフォームに合ったバイナリをダウンロードしてください。
または、[GitHub Releases](https://github.com/sipeed/piconomous/releases) ページからプラットフォームに合ったバイナリをダウンロードしてください。
### ソースからビルド（開発用）
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# ビルド（インストール不要）
@ -210,7 +210,7 @@ make install
## <img src="assets/clawdchat-icon.png" width="24" height="24" alt="ClawdChat"> エージェントソーシャルネットワークに参加
CLI または統合チャットアプリからメッセージを 1 つ送るだけで、PicoClaw をエージェントソーシャルネットワークに接続できます。
CLI または統合チャットアプリからメッセージを 1 つ送るだけで、Piconomous をエージェントソーシャルネットワークに接続できます。
**`https://clawdchat.ai/skill.md` を読み、指示に従って [ClawdChat.ai](https://clawdchat.ai) に参加してください**
@ -218,25 +218,25 @@ CLI または統合チャットアプリからメッセージを 1 つ送るだ
| コマンド | 説明 |
| ------------------------- | ------------------------------ |
| `picoclaw onboard` | 設定＆ワークスペースの初期化 |
| `picoclaw agent -m "..."` | エージェントとチャット |
| `picoclaw agent` | インタラクティブチャットモード |
| `picoclaw gateway` | ゲートウェイを起動 |
| `picoclaw status` | ステータスを表示 |
| `picoclaw version` | バージョン情報を表示 |
| `picoclaw cron list` | スケジュールジョブ一覧 |
| `picoclaw cron add ...` | スケジュールジョブを追加 |
| `picoclaw cron disable` | スケジュールジョブを無効化 |
| `picoclaw cron remove` | スケジュールジョブを削除 |
| `picoclaw skills list` | インストール済みスキル一覧 |
| `picoclaw skills install` | スキルをインストール |
| `picoclaw migrate` | 旧バージョンからデータを移行 |
| `picoclaw auth login` | プロバイダーへの認証 |
| `picoclaw model` | デフォルトモデルの表示・切替 |
| `piconomous onboard` | 設定＆ワークスペースの初期化 |
| `piconomous agent -m "..."` | エージェントとチャット |
| `piconomous agent` | インタラクティブチャットモード |
| `piconomous gateway` | ゲートウェイを起動 |
| `piconomous status` | ステータスを表示 |
| `piconomous version` | バージョン情報を表示 |
| `piconomous cron list` | スケジュールジョブ一覧 |
| `piconomous cron add ...` | スケジュールジョブを追加 |
| `piconomous cron disable` | スケジュールジョブを無効化 |
| `piconomous cron remove` | スケジュールジョブを削除 |
| `piconomous skills list` | インストール済みスキル一覧 |
| `piconomous skills install` | スキルをインストール |
| `piconomous migrate` | 旧バージョンからデータを移行 |
| `piconomous auth login` | プロバイダーへの認証 |
| `piconomous model` | デフォルトモデルの表示・切替 |
### スケジュールタスク / リマインダー
PicoClaw は `cron` ツールによるスケジュールリマインダーと定期タスクをサポートしています：
Piconomous は `cron` ツールによるスケジュールリマインダーと定期タスクをサポートしています：
* **ワンタイムリマインダー**: 「10分後にリマインド」→ 10分後に1回トリガー
* **定期タスク**: 「2時間ごとにリマインド」→ 2時間ごとにトリガー
@ -246,7 +246,7 @@ PicoClaw は `cron` ツールによるスケジュールリマインダーと定
PR 歓迎！コードベースは意図的に小さく読みやすくしています。🤗
完全な[コミュニティロードマップ](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md)をご覧ください。
完全な[コミュニティロードマップ](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md)をご覧ください。
開発者グループ構築中、最初の PR がマージされたら参加できます！
@ -254,4 +254,4 @@ PR 歓迎！コードベースは意図的に小さく読みやすくしてい
discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">

340
README.md
View file

@ -1,7 +1,7 @@
<div align="center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw: Ultra-Efficient AI Assistant in Go</h1>
<h1>Piconomous: Ultra-Efficient AI Assistant in Go</h1>
<h3>$10 Hardware · <10MB RAM · <1s Boot · 皮皮虾，我们走！</h3>
<p>
@ -9,9 +9,9 @@
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -24,9 +24,9 @@
---
> **PicoClaw** is an independent open-source project initiated by [Sipeed](https://sipeed.com). It is written entirely in **Go** — not a fork of OpenClaw, NanoBot, or any other project.
> **Piconomous** is an independent open-source project initiated by [Sipeed](https://sipeed.com). It is written entirely in **Go** — not a fork of OpenClaw, NanoBot, or any other project.
🦐 PicoClaw is an ultra-lightweight personal AI Assistant inspired by [NanoBot](https://github.com/HKUDS/nanobot), refactored from the ground up in Go through a self-bootstrapping process, where the AI agent itself drove the entire architectural migration and code optimization.
🦐 Piconomous is an ultra-lightweight personal AI Assistant inspired by [NanoBot](https://github.com/HKUDS/nanobot), refactored from the ground up in Go through a self-bootstrapping process, where the AI agent itself drove the entire architectural migration and code optimization.
⚡️ Runs on $10 hardware with <10MB RAM: That's 99% less memory than OpenClaw and 98% cheaper than a Mac mini!
@ -34,7 +34,7 @@
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -48,31 +48,31 @@
> [!CAUTION]
> **🚨 SECURITY & OFFICIAL CHANNELS / 安全声明**
>
> * **NO CRYPTO:** PicoClaw has **NO** official token/coin. All claims on `pump.fun` or other trading platforms are **SCAMS**.
> * **NO CRYPTO:** Piconomous has **NO** official token/coin. All claims on `pump.fun` or other trading platforms are **SCAMS**.
>
> * **OFFICIAL DOMAIN:** The **ONLY** official website is **[picoclaw.io](https://picoclaw.io)**, and company website is **[sipeed.com](https://sipeed.com)**
> * **OFFICIAL DOMAIN:** The **ONLY** official website is **[piconomous.io](https://piconomous.io)**, and company website is **[sipeed.com](https://sipeed.com)**
> * **Warning:** Many `.ai/.org/.com/.net/...` domains are registered by third parties.
> * **Warning:** picoclaw is in early development now and may have unresolved network security issues. Do not deploy to production environments before the v1.0 release.
> * **Note:** picoclaw has recently merged a lot of PRs, which may result in a larger memory footprint (10–20MB) in the latest versions. We plan to prioritize resource optimization as soon as the current feature set reaches a stable state.
> * **Warning:** piconomous is in early development now and may have unresolved network security issues. Do not deploy to production environments before the v1.0 release.
> * **Note:** piconomous has recently merged a lot of PRs, which may result in a larger memory footprint (10–20MB) in the latest versions. We plan to prioritize resource optimization as soon as the current feature set reaches a stable state.
## 📢 News
2026-03-17 🚀 **v0.2.3 Released!** System tray UI (Windows & Linux), sub-agent status tracking (`spawn_status`), experimental gateway hot-reload, cron security gates, and 2 security fixes. PicoClaw now at **25K ⭐**!
2026-03-17 🚀 **v0.2.3 Released!** System tray UI (Windows & Linux), sub-agent status tracking (`spawn_status`), experimental gateway hot-reload, cron security gates, and 2 security fixes. Piconomous now at **25K ⭐**!
2026-03-09 🎉 **v0.2.1 — Biggest update yet!** MCP protocol support, 4 new channels (Matrix/IRC/WeCom/Discord Proxy), 3 new providers (Kimi/Minimax/Avian), vision pipeline, JSONL memory store, and model routing.
2026-02-28 📦 **v0.2.0** released with Docker Compose support and Web UI launcher.
2026-02-26 🎉 PicoClaw hit **20K stars** in just 17 days! Channel auto-orchestration and capability interfaces landed.
2026-02-26 🎉 Piconomous hit **20K stars** in just 17 days! Channel auto-orchestration and capability interfaces landed.
<details>
<summary>Older news...</summary>
2026-02-16 🎉 PicoClaw hit 12K stars in one week! Community maintainer roles and [roadmap](ROADMAP.md) officially posted.
2026-02-16 🎉 Piconomous hit 12K stars in one week! Community maintainer roles and [roadmap](ROADMAP.md) officially posted.
2026-02-13 🎉 PicoClaw hit 5000 stars in 4 days! Project Roadmap and Developer Group setup underway.
2026-02-13 🎉 Piconomous hit 5000 stars in 4 days! Project Roadmap and Developer Group setup underway.
2026-02-09 🎉 **PicoClaw Launched!** Built in 1 day to bring AI Agents to $10 hardware with <10MB RAM. 🦐 PicoClaw，Let's Go！
2026-02-09 🎉 **Piconomous Launched!** Built in 1 day to bring AI Agents to $10 hardware with <10MB RAM. 🦐 Piconomous，Let's Go！
</details>
@ -96,14 +96,14 @@
_*Recent versions may use 10–20MB due to rapid feature merges. Resource optimization is planned. Startup comparison based on 0.8GHz single-core benchmarks (see table below)._
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- |
| **Language** | TypeScript | Python | **Go** |
| **RAM** | >1GB | >100MB | **< 10MB*** |
| **Startup**</br>(0.8GHz core) | >500s | >30s | **<1s** |
| **Cost** | Mac Mini $599 | Most Linux SBC </br>~$50 | **Any Linux Board**</br>**As low as $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
> 📋 **[Hardware Compatibility List](docs/hardware-compatibility.md)** — See all tested boards, from $5 RISC-V to Raspberry Pi to Android phones. Your board not listed? Submit a PR!
@ -118,9 +118,9 @@ _*Recent versions may use 10–20MB due to rapid feature merges. Resource optimi
<th><p align="center">🔎 Web Search & Learning</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">Develop • Deploy • Scale</td>
@ -131,26 +131,26 @@ _*Recent versions may use 10–20MB due to rapid feature merges. Resource optimi
### 📱 Run on old Android Phones
Give your decade-old phone a second life! Turn it into a smart AI Assistant with PicoClaw. Quick Start:
Give your decade-old phone a second life! Turn it into a smart AI Assistant with Piconomous. Quick Start:
1. **Install [Termux](https://github.com/termux/termux-app)** (Download from [GitHub Releases](https://github.com/termux/termux-app/releases), or search in F-Droid / Google Play).
2. **Execute cmds**
```bash
# Download the latest release from https://github.com/sipeed/picoclaw/releases
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
# Download the latest release from https://github.com/sipeed/piconomous/releases
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard # chroot provides a standard Linux filesystem layout
termux-chroot ./piconomous onboard # chroot provides a standard Linux filesystem layout
```
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="Piconomous" width="512">
### 🐜 Innovative Low-Footprint Deploy
PicoClaw can be deployed on almost any Linux device!
Piconomous can be deployed on almost any Linux device!
- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) E(Ethernet) or W(WiFi6) version, for Minimal Home Assistant
- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), or $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) for Automated Server Maintenance
@ -162,20 +162,20 @@ PicoClaw can be deployed on almost any Linux device!
## 📦 Install
### Download from picoclaw.io (Recommended)
### Download from piconomous.io (Recommended)
Visit **[picoclaw.io](https://picoclaw.io)** — the official website auto-detects your platform and provides one-click download. No need to manually pick an architecture.
Visit **[piconomous.io](https://piconomous.io)** — the official website auto-detects your platform and provides one-click download. No need to manually pick an architecture.
### Download precompiled binary
Alternatively, download the binary for your platform from the [GitHub Releases](https://github.com/sipeed/picoclaw/releases) page.
Alternatively, download the binary for your platform from the [GitHub Releases](https://github.com/sipeed/piconomous/releases) page.
### Build from source (for development)
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# Build, no need to install
@ -199,8 +199,8 @@ For detailed guides, see the docs below. The README covers quick start only.
```bash
# 1. Clone this repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
git clone https://github.com/sipeed/piconomous.git
cd piconomous
# 2. First run — auto-generates docker/data/config.json then exits
docker compose -f docker/docker-compose.yml --profile gateway up
@ -214,11 +214,11 @@ docker compose -f docker/docker-compose.yml --profile gateway up -d
```
> [!TIP]
> **Docker Users**: By default, the Gateway listens on `127.0.0.1` which is not accessible from the host. If you need to access the health endpoints or expose ports, set `PICOCLAW_GATEWAY_HOST=0.0.0.0` in your environment or update `config.json`.
> **Docker Users**: By default, the Gateway listens on `127.0.0.1` which is not accessible from the host. If you need to access the health endpoints or expose ports, set `PICONOMOUS_GATEWAY_HOST=0.0.0.0` in your environment or update `config.json`.
```bash
# 5. Check logs
docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway
docker compose -f docker/docker-compose.yml logs -f piconomous-gateway
# 6. Stop
docker compose -f docker/docker-compose.yml --profile gateway down
@ -226,7 +226,7 @@ docker compose -f docker/docker-compose.yml --profile gateway down
### Launcher Mode (Web Console)
The `launcher` image includes all three binaries (`picoclaw`, `picoclaw-launcher`, `picoclaw-launcher-tui`) and starts the web console by default, which provides a browser-based UI for configuration and chat.
The `launcher` image includes all three binaries (`piconomous`, `piconomous-launcher`, `piconomous-launcher-tui`) and starts the web console by default, which provides a browser-based UI for configuration and chat.
```bash
docker compose -f docker/docker-compose.yml --profile launcher up -d
@ -241,10 +241,10 @@ Open http://localhost:18800 in your browser. The launcher manages the gateway pr
```bash
# Ask a question
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "What is 2+2?"
docker compose -f docker/docker-compose.yml run --rm piconomous-agent -m "What is 2+2?"
# Interactive mode
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent
docker compose -f docker/docker-compose.yml run --rm piconomous-agent
```
### Update
@ -257,21 +257,21 @@ docker compose -f docker/docker-compose.yml --profile gateway up -d
### 🚀 Quick Start
> [!TIP]
> Set your API Key in `~/.picoclaw/config.json`. Get API Keys: [Volcengine (CodingPlan)](https://console.volcengine.com) (LLM) · [OpenRouter](https://openrouter.ai/keys) (LLM) · [Zhipu](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) (LLM). Web search is optional — get a free [Tavily API](https://tavily.com) (1000 free queries/month) or [Brave Search API](https://brave.com/search/api) (2000 free queries/month).
> Set your API Key in `~/.piconomous/config.json`. Get API Keys: [Volcengine (CodingPlan)](https://console.volcengine.com) (LLM) · [OpenRouter](https://openrouter.ai/keys) (LLM) · [Zhipu](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) (LLM). Web search is optional — get a free [Tavily API](https://tavily.com) (1000 free queries/month) or [Brave Search API](https://brave.com/search/api) (2000 free queries/month).
**1. Initialize**
```bash
picoclaw onboard
piconomous onboard
```
**2. Configure** (`~/.picoclaw/config.json`)
**2. Configure** (`~/.piconomous/config.json`)
```json
{
"agents": {
"defaults": {
"workspace": "~/.picoclaw/workspace",
"workspace": "~/.piconomous/workspace",
"model_name": "gpt-5.4",
"max_tokens": 8192,
"temperature": 0.7,
@ -328,7 +328,7 @@ picoclaw onboard
```
> **New**: The `model_list` configuration format allows zero-code provider addition. See [Model Configuration](#model-configuration-model_list) for details.
> `request_timeout` is optional and uses seconds. If omitted or set to `<= 0`, PicoClaw uses the default timeout (120s).
> `request_timeout` is optional and uses seconds. If omitted or set to `<= 0`, Piconomous uses the default timeout (120s).
**3. Get API Keys**
@ -345,7 +345,7 @@ picoclaw onboard
**4. Chat**
```bash
picoclaw agent -m "What is 2+2?"
piconomous agent -m "What is 2+2?"
```
That's it! You have a working AI assistant in 2 minutes.
@ -354,7 +354,7 @@ That's it! You have a working AI assistant in 2 minutes.
## 💬 Chat Apps
Talk to your picoclaw through Telegram, Discord, WhatsApp, Matrix, QQ, DingTalk, LINE, or WeCom
Talk to your piconomous through Telegram, Discord, WhatsApp, Matrix, QQ, DingTalk, LINE, or WeCom
> **Note**: All webhook-based channels (LINE, WeCom, etc.) are served on a single shared Gateway HTTP server (`gateway.host`:`gateway.port`, default `127.0.0.1:18790`). There are no per-channel ports to configure. Note: Feishu uses WebSocket/SDK mode and does not use the shared HTTP webhook server.
@ -397,15 +397,15 @@ Talk to your picoclaw through Telegram, Discord, WhatsApp, Matrix, QQ, DingTalk,
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
**4. Telegram command menu (auto-registered at startup)**
PicoClaw now keeps command definitions in one shared registry. On startup, Telegram will automatically register supported bot commands (for example `/start`, `/help`, `/show`, `/list`) so command menu and runtime behavior stay in sync.
Piconomous now keeps command definitions in one shared registry. On startup, Telegram will automatically register supported bot commands (for example `/start`, `/help`, `/show`, `/list`) so command menu and runtime behavior stay in sync.
Telegram command menu registration remains channel-local discovery UX; generic command execution is handled centrally in the agent loop via the commands executor.
If command registration fails (network/API transient errors), the channel still starts and PicoClaw retries registration in the background.
If command registration fails (network/API transient errors), the channel still starts and Piconomous retries registration in the background.
</details>
@ -477,7 +477,7 @@ You can also trigger by keyword prefixes (e.g. `!bot`):
**6. Run**
```bash
picoclaw gateway
piconomous gateway
```
</details>
@ -485,7 +485,7 @@ picoclaw gateway
<details>
<summary><b>WhatsApp</b> (native via whatsmeow)</summary>
PicoClaw can connect to WhatsApp in two ways:
Piconomous can connect to WhatsApp in two ways:
- **Native (recommended):** In-process using [whatsmeow](https://github.com/tulir/whatsmeow). No separate bridge. Set `"use_native": true` and leave `bridge_url` empty. On first run, scan the QR code with WhatsApp (Linked Devices). Session is stored under your workspace (e.g. `workspace/whatsapp/`). The native channel is **optional** to keep the default binary small; build with `-tags whatsapp_native` (e.g. `make build-whatsapp-native` or `go build -tags whatsapp_native ./cmd/...`).
- **Bridge:** Connect to an external WebSocket bridge. Set `bridge_url` (e.g. `ws://localhost:3001`) and keep `use_native` false.
@ -505,7 +505,7 @@ PicoClaw can connect to WhatsApp in two ways:
}
```
If `session_store_path` is empty, the session is stored in `&lt;workspace&gt;/whatsapp/`. Run `picoclaw gateway`; on first run, scan the QR code printed in the terminal with WhatsApp → Linked Devices.
If `session_store_path` is empty, the session is stored in `&lt;workspace&gt;/whatsapp/`. Run `piconomous gateway`; on first run, scan the QR code printed in the terminal with WhatsApp → Linked Devices.
</details>
@ -537,7 +537,7 @@ If `session_store_path` is empty, the session is stored in `&lt;workspace&gt;/wh
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
</details>
@ -571,7 +571,7 @@ picoclaw gateway
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
</details>
@ -602,7 +602,7 @@ picoclaw gateway
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
For full options (`device_id`, `join_on_invite`, `group_trigger`, `placeholder`, `reasoning_channel_id`), see [Matrix Channel Configuration Guide](docs/channels/matrix/README.md).
@ -650,7 +650,7 @@ Then set the Webhook URL in LINE Developers Console to `https://your-domain/webh
**4. Run**
```bash
picoclaw gateway
piconomous gateway
```
> In group chats, the bot responds only when @mentioned. Replies quote the original message.
@ -660,7 +660,7 @@ picoclaw gateway
<details>
<summary><b>WeCom (企业微信)</b></summary>
PicoClaw supports three types of WeCom integration:
Piconomous supports three types of WeCom integration:
**Option 1: WeCom Bot (Bot)** - Easier setup, supports group chats
**Option 2: WeCom App (Custom App)** - More features, proactive messaging, private chat only
@ -695,7 +695,7 @@ See [WeCom AI Bot Configuration Guide](docs/channels/wecom/wecom_aibot/README.zh
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
> **Note**: WeCom AI Bot uses streaming pull protocol — no reply timeout concerns. Long tasks (>30 seconds) automatically switch to `response_url` push delivery.
@ -712,24 +712,24 @@ Connect Picoclaw to the Agent Social Network simply by sending a single message
| Command | Description |
| ------------------------- | ----------------------------- |
| `picoclaw onboard` | Initialize config & workspace |
| `picoclaw agent -m "..."` | Chat with the agent |
| `picoclaw agent` | Interactive chat mode |
| `picoclaw gateway` | Start the gateway |
| `picoclaw status` | Show status |
| `picoclaw version` | Show version info |
| `picoclaw cron list` | List all scheduled jobs |
| `picoclaw cron add ...` | Add a scheduled job |
| `picoclaw cron disable` | Disable a scheduled job |
| `picoclaw cron remove` | Remove a scheduled job |
| `picoclaw skills list` | List installed skills |
| `picoclaw skills install` | Install a skill |
| `picoclaw migrate` | Migrate data from older versions |
| `picoclaw auth login` | Authenticate with providers |
| `piconomous onboard` | Initialize config & workspace |
| `piconomous agent -m "..."` | Chat with the agent |
| `piconomous agent` | Interactive chat mode |
| `piconomous gateway` | Start the gateway |
| `piconomous status` | Show status |
| `piconomous version` | Show version info |
| `piconomous cron list` | List all scheduled jobs |
| `piconomous cron add ...` | Add a scheduled job |
| `piconomous cron disable` | Disable a scheduled job |
| `piconomous cron remove` | Remove a scheduled job |
| `piconomous skills list` | List installed skills |
| `piconomous skills install` | Install a skill |
| `piconomous migrate` | Migrate data from older versions |
| `piconomous auth login` | Authenticate with providers |
### Scheduled Tasks / Reminders
PicoClaw supports scheduled reminders and recurring tasks through the `cron` tool:
Piconomous supports scheduled reminders and recurring tasks through the `cron` tool:
* **One-time reminders**: "Remind me in 10 minutes" → triggers once after 10min
* **Recurring tasks**: "Remind me every 2 hours" → triggers every 2 hours
@ -739,7 +739,7 @@ PicoClaw supports scheduled reminders and recurring tasks through the `cron` too
PRs welcome! The codebase is intentionally small and readable. 🤗
See our full [Community Roadmap](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md).
See our full [Community Roadmap](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md).
Developer group building, join after your first merged PR!
@ -747,10 +747,10 @@ User Groups:
discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512"> center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512"> center">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw: Ultra-Efficient AI Assistant in Go</h1>
<h1>Piconomous: Ultra-Efficient AI Assistant in Go</h1>
<h3>$10 Hardware · <10MB RAM · <1s Boot · 皮皮虾，我们走！</h3>
<p>
@ -758,9 +758,9 @@ discord: <https://discord.gg/V4sAZ9XWpN>
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -773,9 +773,9 @@ discord: <https://discord.gg/V4sAZ9XWpN>
---
> **PicoClaw** is an independent open-source project initiated by [Sipeed](https://sipeed.com). It is written entirely in **Go** — not a fork of OpenClaw, NanoBot, or any other project.
> **Piconomous** is an independent open-source project initiated by [Sipeed](https://sipeed.com). It is written entirely in **Go** — not a fork of OpenClaw, NanoBot, or any other project.
🦐 PicoClaw is an ultra-lightweight personal AI Assistant inspired by [NanoBot](https://github.com/HKUDS/nanobot), refactored from the ground up in Go through a self-bootstrapping process, where the AI agent itself drove the entire architectural migration and code optimization.
🦐 Piconomous is an ultra-lightweight personal AI Assistant inspired by [NanoBot](https://github.com/HKUDS/nanobot), refactored from the ground up in Go through a self-bootstrapping process, where the AI agent itself drove the entire architectural migration and code optimization.
⚡️ Runs on $10 hardware with <10MB RAM: That's 99% less memory than OpenClaw and 98% cheaper than a Mac mini!
@ -783,7 +783,7 @@ discord: <https://discord.gg/V4sAZ9XWpN>
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -797,31 +797,31 @@ discord: <https://discord.gg/V4sAZ9XWpN>
> [!CAUTION]
> **🚨 SECURITY & OFFICIAL CHANNELS / 安全声明**
>
> * **NO CRYPTO:** PicoClaw has **NO** official token/coin. All claims on `pump.fun` or other trading platforms are **SCAMS**.
> * **NO CRYPTO:** Piconomous has **NO** official token/coin. All claims on `pump.fun` or other trading platforms are **SCAMS**.
>
> * **OFFICIAL DOMAIN:** The **ONLY** official website is **[picoclaw.io](https://picoclaw.io)**, and company website is **[sipeed.com](https://sipeed.com)**
> * **OFFICIAL DOMAIN:** The **ONLY** official website is **[piconomous.io](https://piconomous.io)**, and company website is **[sipeed.com](https://sipeed.com)**
> * **Warning:** Many `.ai/.org/.com/.net/...` domains are registered by third parties.
> * **Warning:** picoclaw is in early development now and may have unresolved network security issues. Do not deploy to production environments before the v1.0 release.
> * **Note:** picoclaw has recently merged a lot of PRs, which may result in a larger memory footprint (10–20MB) in the latest versions. We plan to prioritize resource optimization as soon as the current feature set reaches a stable state.
> * **Warning:** piconomous is in early development now and may have unresolved network security issues. Do not deploy to production environments before the v1.0 release.
> * **Note:** piconomous has recently merged a lot of PRs, which may result in a larger memory footprint (10–20MB) in the latest versions. We plan to prioritize resource optimization as soon as the current feature set reaches a stable state.
## 📢 News
2026-03-17 🚀 **v0.2.3 Released!** System tray UI (Windows & Linux), sub-agent status tracking (`spawn_status`), experimental gateway hot-reload, cron security gates, and 2 security fixes. PicoClaw now at **25K ⭐**!
2026-03-17 🚀 **v0.2.3 Released!** System tray UI (Windows & Linux), sub-agent status tracking (`spawn_status`), experimental gateway hot-reload, cron security gates, and 2 security fixes. Piconomous now at **25K ⭐**!
2026-03-09 🎉 **v0.2.1 — Biggest update yet!** MCP protocol support, 4 new channels (Matrix/IRC/WeCom/Discord Proxy), 3 new providers (Kimi/Minimax/Avian), vision pipeline, JSONL memory store, and model routing.
2026-02-28 📦 **v0.2.0** released with Docker Compose support and Web UI launcher.
2026-02-26 🎉 PicoClaw hit **20K stars** in just 17 days! Channel auto-orchestration and capability interfaces landed.
2026-02-26 🎉 Piconomous hit **20K stars** in just 17 days! Channel auto-orchestration and capability interfaces landed.
<details>
<summary>Older news...</summary>
2026-02-16 🎉 PicoClaw hit 12K stars in one week! Community maintainer roles and [roadmap](ROADMAP.md) officially posted.
2026-02-16 🎉 Piconomous hit 12K stars in one week! Community maintainer roles and [roadmap](ROADMAP.md) officially posted.
2026-02-13 🎉 PicoClaw hit 5000 stars in 4 days! Project Roadmap and Developer Group setup underway.
2026-02-13 🎉 Piconomous hit 5000 stars in 4 days! Project Roadmap and Developer Group setup underway.
2026-02-09 🎉 **PicoClaw Launched!** Built in 1 day to bring AI Agents to $10 hardware with <10MB RAM. 🦐 PicoClaw，Let's Go！
2026-02-09 🎉 **Piconomous Launched!** Built in 1 day to bring AI Agents to $10 hardware with <10MB RAM. 🦐 Piconomous，Let's Go！
</details>
@ -845,14 +845,14 @@ discord: <https://discord.gg/V4sAZ9XWpN>
_*Recent versions may use 10–20MB due to rapid feature merges. Resource optimization is planned. Startup comparison based on 0.8GHz single-core benchmarks (see table below)._
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- |
| **Language** | TypeScript | Python | **Go** |
| **RAM** | >1GB | >100MB | **< 10MB*** |
| **Startup**</br>(0.8GHz core) | >500s | >30s | **<1s** |
| **Cost** | Mac Mini $599 | Most Linux SBC </br>~$50 | **Any Linux Board**</br>**As low as $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
> 📋 **[Hardware Compatibility List](docs/hardware-compatibility.md)** — See all tested boards, from $5 RISC-V to Raspberry Pi to Android phones. Your board not listed? Submit a PR!
@ -867,9 +867,9 @@ _*Recent versions may use 10–20MB due to rapid feature merges. Resource optimi
<th><p align="center">🔎 Web Search & Learning</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">Develop • Deploy • Scale</td>
@ -880,26 +880,26 @@ _*Recent versions may use 10–20MB due to rapid feature merges. Resource optimi
### 📱 Run on old Android Phones
Give your decade-old phone a second life! Turn it into a smart AI Assistant with PicoClaw. Quick Start:
Give your decade-old phone a second life! Turn it into a smart AI Assistant with Piconomous. Quick Start:
1. **Install [Termux](https://github.com/termux/termux-app)** (Download from [GitHub Releases](https://github.com/termux/termux-app/releases), or search in F-Droid / Google Play).
2. **Execute cmds**
```bash
# Download the latest release from https://github.com/sipeed/picoclaw/releases
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
# Download the latest release from https://github.com/sipeed/piconomous/releases
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard
termux-chroot ./piconomous onboard
```
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="Piconomous" width="512">
### 🐜 Innovative Low-Footprint Deploy
PicoClaw can be deployed on almost any Linux device!
Piconomous can be deployed on almost any Linux device!
- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) E(Ethernet) or W(WiFi6) version, for Minimal Home Assistant
- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), or $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) for Automated Server Maintenance
@ -913,14 +913,14 @@ PicoClaw can be deployed on almost any Linux device!
### Install with precompiled binary
Download the binary for your platform from the [Releases](https://github.com/sipeed/picoclaw/releases) page.
Download the binary for your platform from the [Releases](https://github.com/sipeed/piconomous/releases) page.
### Install from source (latest features, recommended for development)
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# Build, no need to install
@ -944,8 +944,8 @@ For detailed guides, see the docs below. The README covers quick start only.
```bash
# 1. Clone this repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
git clone https://github.com/sipeed/piconomous.git
cd piconomous
# 2. First run — auto-generates docker/data/config.json then exits
docker compose -f docker/docker-compose.yml --profile gateway up
@ -959,11 +959,11 @@ docker compose -f docker/docker-compose.yml --profile gateway up -d
```
> [!TIP]
> **Docker Users**: By default, the Gateway listens on `127.0.0.1` which is not accessible from the host. If you need to access the health endpoints or expose ports, set `PICOCLAW_GATEWAY_HOST=0.0.0.0` in your environment or update `config.json`.
> **Docker Users**: By default, the Gateway listens on `127.0.0.1` which is not accessible from the host. If you need to access the health endpoints or expose ports, set `PICONOMOUS_GATEWAY_HOST=0.0.0.0` in your environment or update `config.json`.
```bash
# 5. Check logs
docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway
docker compose -f docker/docker-compose.yml logs -f piconomous-gateway
# 6. Stop
docker compose -f docker/docker-compose.yml --profile gateway down
@ -971,7 +971,7 @@ docker compose -f docker/docker-compose.yml --profile gateway down
### Launcher Mode (Web Console)
The `launcher` image includes all three binaries (`picoclaw`, `picoclaw-launcher`, `picoclaw-launcher-tui`) and starts the web console by default, which provides a browser-based UI for configuration and chat.
The `launcher` image includes all three binaries (`piconomous`, `piconomous-launcher`, `piconomous-launcher-tui`) and starts the web console by default, which provides a browser-based UI for configuration and chat.
```bash
docker compose -f docker/docker-compose.yml --profile launcher up -d
@ -986,10 +986,10 @@ Open http://localhost:18800 in your browser. The launcher manages the gateway pr
```bash
# Ask a question
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "What is 2+2?"
docker compose -f docker/docker-compose.yml run --rm piconomous-agent -m "What is 2+2?"
# Interactive mode
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent
docker compose -f docker/docker-compose.yml run --rm piconomous-agent
```
### Update
@ -1002,21 +1002,21 @@ docker compose -f docker/docker-compose.yml --profile gateway up -d
### 🚀 Quick Start
> [!TIP]
> Set your API Key in `~/.picoclaw/config.json`. Get API Keys: [Volcengine (CodingPlan)](https://console.volcengine.com) (LLM) · [OpenRouter](https://openrouter.ai/keys) (LLM) · [Zhipu](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) (LLM). Web search is optional — get a free [Tavily API](https://tavily.com) (1000 free queries/month) or [Brave Search API](https://brave.com/search/api) (2000 free queries/month).
> Set your API Key in `~/.piconomous/config.json`. Get API Keys: [Volcengine (CodingPlan)](https://console.volcengine.com) (LLM) · [OpenRouter](https://openrouter.ai/keys) (LLM) · [Zhipu](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) (LLM). Web search is optional — get a free [Tavily API](https://tavily.com) (1000 free queries/month) or [Brave Search API](https://brave.com/search/api) (2000 free queries/month).
**1. Initialize**
```bash
picoclaw onboard
piconomous onboard
```
**2. Configure** (`~/.picoclaw/config.json`)
**2. Configure** (`~/.piconomous/config.json`)
```json
{
"agents": {
"defaults": {
"workspace": "~/.picoclaw/workspace",
"workspace": "~/.piconomous/workspace",
"model_name": "gpt-5.4",
"max_tokens": 8192,
"temperature": 0.7,
@ -1073,7 +1073,7 @@ picoclaw onboard
```
> **New**: The `model_list` configuration format allows zero-code provider addition. See [Model Configuration](#model-configuration-model_list) for details.
> `request_timeout` is optional and uses seconds. If omitted or set to `<= 0`, PicoClaw uses the default timeout (120s).
> `request_timeout` is optional and uses seconds. If omitted or set to `<= 0`, Piconomous uses the default timeout (120s).
**3. Get API Keys**
@ -1090,7 +1090,7 @@ picoclaw onboard
**4. Chat**
```bash
picoclaw agent -m "What is 2+2?"
piconomous agent -m "What is 2+2?"
```
That's it! You have a working AI assistant in 2 minutes.
@ -1099,7 +1099,7 @@ That's it! You have a working AI assistant in 2 minutes.
## 💬 Chat Apps
Talk to your picoclaw through Telegram, Discord, WhatsApp, Matrix, QQ, DingTalk, LINE, or WeCom
Talk to your piconomous through Telegram, Discord, WhatsApp, Matrix, QQ, DingTalk, LINE, or WeCom
> **Note**: All webhook-based channels (LINE, WeCom, etc.) are served on a single shared Gateway HTTP server (`gateway.host`:`gateway.port`, default `127.0.0.1:18790`). There are no per-channel ports to configure. Note: Feishu uses WebSocket/SDK mode and does not use the shared HTTP webhook server.
@ -1142,15 +1142,15 @@ Talk to your picoclaw through Telegram, Discord, WhatsApp, Matrix, QQ, DingTalk,
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
**4. Telegram command menu (auto-registered at startup)**
PicoClaw now keeps command definitions in one shared registry. On startup, Telegram will automatically register supported bot commands (for example `/start`, `/help`, `/show`, `/list`) so command menu and runtime behavior stay in sync.
Piconomous now keeps command definitions in one shared registry. On startup, Telegram will automatically register supported bot commands (for example `/start`, `/help`, `/show`, `/list`) so command menu and runtime behavior stay in sync.
Telegram command menu registration remains channel-local discovery UX; generic command execution is handled centrally in the agent loop via the commands executor.
If command registration fails (network/API transient errors), the channel still starts and PicoClaw retries registration in the background.
If command registration fails (network/API transient errors), the channel still starts and Piconomous retries registration in the background.
</details>
@ -1222,7 +1222,7 @@ You can also trigger by keyword prefixes (e.g. `!bot`):
**6. Run**
```bash
picoclaw gateway
piconomous gateway
```
</details>
@ -1230,7 +1230,7 @@ picoclaw gateway
<details>
<summary><b>WhatsApp</b> (native via whatsmeow)</summary>
PicoClaw can connect to WhatsApp in two ways:
Piconomous can connect to WhatsApp in two ways:
- **Native (recommended):** In-process using [whatsmeow](https://github.com/tulir/whatsmeow). No separate bridge. Set `"use_native": true` and leave `bridge_url` empty. On first run, scan the QR code with WhatsApp (Linked Devices). Session is stored under your workspace (e.g. `workspace/whatsapp/`). The native channel is **optional** to keep the default binary small; build with `-tags whatsapp_native` (e.g. `make build-whatsapp-native` or `go build -tags whatsapp_native ./cmd/...`).
- **Bridge:** Connect to an external WebSocket bridge. Set `bridge_url` (e.g. `ws://localhost:3001`) and keep `use_native` false.
@ -1250,7 +1250,7 @@ PicoClaw can connect to WhatsApp in two ways:
}
```
If `session_store_path` is empty, the session is stored in `&lt;workspace&gt;/whatsapp/`. Run `picoclaw gateway`; on first run, scan the QR code printed in the terminal with WhatsApp → Linked Devices.
If `session_store_path` is empty, the session is stored in `&lt;workspace&gt;/whatsapp/`. Run `piconomous gateway`; on first run, scan the QR code printed in the terminal with WhatsApp → Linked Devices.
</details>
@ -1282,7 +1282,7 @@ If `session_store_path` is empty, the session is stored in `&lt;workspace&gt;/wh
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
</details>
@ -1316,7 +1316,7 @@ picoclaw gateway
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
</details>
@ -1347,7 +1347,7 @@ picoclaw gateway
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
For full options (`device_id`, `join_on_invite`, `group_trigger`, `placeholder`, `reasoning_channel_id`), see [Matrix Channel Configuration Guide](docs/channels/matrix/README.md).
@ -1395,7 +1395,7 @@ Then set the Webhook URL in LINE Developers Console to `https://your-domain/webh
**4. Run**
```bash
picoclaw gateway
piconomous gateway
```
> In group chats, the bot responds only when @mentioned. Replies quote the original message.
@ -1405,7 +1405,7 @@ picoclaw gateway
<details>
<summary><b>WeCom (企业微信)</b></summary>
PicoClaw supports three types of WeCom integration:
Piconomous supports three types of WeCom integration:
**Option 1: WeCom Bot (Bot)** - Easier setup, supports group chats
**Option 2: WeCom App (Custom App)** - More features, proactive messaging, private chat only
@ -1440,7 +1440,7 @@ See [WeCom AI Bot Configuration Guide](docs/channels/wecom/wecom_aibot/README.zh
**3. Run**
```bash
picoclaw gateway
piconomous gateway
```
> **Note**: WeCom AI Bot uses streaming pull protocol — no reply timeout concerns. Long tasks (>30 seconds) automatically switch to `response_url` push delivery.
@ -1457,24 +1457,24 @@ Connect Picoclaw to the Agent Social Network simply by sending a single message
| Command | Description |
| ------------------------- | ----------------------------- |
| `picoclaw onboard` | Initialize config & workspace |
| `picoclaw agent -m "..."` | Chat with the agent |
| `picoclaw agent` | Interactive chat mode |
| `picoclaw gateway` | Start the gateway |
| `picoclaw status` | Show status |
| `picoclaw version` | Show version info |
| `picoclaw cron list` | List all scheduled jobs |
| `picoclaw cron add ...` | Add a scheduled job |
| `picoclaw cron disable` | Disable a scheduled job |
| `picoclaw cron remove` | Remove a scheduled job |
| `picoclaw skills list` | List installed skills |
| `picoclaw skills install` | Install a skill |
| `picoclaw migrate` | Migrate data from older versions |
| `picoclaw auth login` | Authenticate with providers |
| `piconomous onboard` | Initialize config & workspace |
| `piconomous agent -m "..."` | Chat with the agent |
| `piconomous agent` | Interactive chat mode |
| `piconomous gateway` | Start the gateway |
| `piconomous status` | Show status |
| `piconomous version` | Show version info |
| `piconomous cron list` | List all scheduled jobs |
| `piconomous cron add ...` | Add a scheduled job |
| `piconomous cron disable` | Disable a scheduled job |
| `piconomous cron remove` | Remove a scheduled job |
| `piconomous skills list` | List installed skills |
| `piconomous skills install` | Install a skill |
| `piconomous migrate` | Migrate data from older versions |
| `piconomous auth login` | Authenticate with providers |
### Scheduled Tasks / Reminders
PicoClaw supports scheduled reminders and recurring tasks through the `cron` tool:
Piconomous supports scheduled reminders and recurring tasks through the `cron` tool:
* **One-time reminders**: "Remind me in 10 minutes" → triggers once after 10min
* **Recurring tasks**: "Remind me every 2 hours" → triggers every 2 hours
@ -1484,7 +1484,7 @@ PicoClaw supports scheduled reminders and recurring tasks through the `cron` too
PRs welcome! The codebase is intentionally small and readable. 🤗
See our full [Community Roadmap](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md).
See our full [Community Roadmap](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md).
Developer group building, join after your first merged PR!
@ -1492,7 +1492,7 @@ User Groups:
discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">
## <img src="assets/clawdchat-icon.png" width="24" height="24" alt="ClawdChat"> Join the Agent Social Network
@ -1504,25 +1504,25 @@ Connect Picoclaw to the Agent Social Network simply by sending a single message
| Command | Description |
| ------------------------- | ----------------------------- |
| `picoclaw onboard` | Initialize config & workspace |
| `picoclaw agent -m "..."` | Chat with the agent |
| `picoclaw agent` | Interactive chat mode |
| `picoclaw gateway` | Start the gateway |
| `picoclaw status` | Show status |
| `picoclaw version` | Show version info |
| `picoclaw cron list` | List all scheduled jobs |
| `picoclaw cron add ...` | Add a scheduled job |
| `picoclaw cron disable` | Disable a scheduled job |
| `picoclaw cron remove` | Remove a scheduled job |
| `picoclaw skills list` | List installed skills |
| `picoclaw skills install` | Install a skill |
| `picoclaw migrate` | Migrate data from older versions |
| `picoclaw auth login` | Authenticate with providers |
| `picoclaw model` | View or switch the default model |
| `piconomous onboard` | Initialize config & workspace |
| `piconomous agent -m "..."` | Chat with the agent |
| `piconomous agent` | Interactive chat mode |
| `piconomous gateway` | Start the gateway |
| `piconomous status` | Show status |
| `piconomous version` | Show version info |
| `piconomous cron list` | List all scheduled jobs |
| `piconomous cron add ...` | Add a scheduled job |
| `piconomous cron disable` | Disable a scheduled job |
| `piconomous cron remove` | Remove a scheduled job |
| `piconomous skills list` | List installed skills |
| `piconomous skills install` | Install a skill |
| `piconomous migrate` | Migrate data from older versions |
| `piconomous auth login` | Authenticate with providers |
| `piconomous model` | View or switch the default model |
### Scheduled Tasks / Reminders
PicoClaw supports scheduled reminders and recurring tasks through the `cron` tool:
Piconomous supports scheduled reminders and recurring tasks through the `cron` tool:
* **One-time reminders**: "Remind me in 10 minutes" → triggers once after 10min
* **Recurring tasks**: "Remind me every 2 hours" → triggers every 2 hours
@ -1532,7 +1532,7 @@ PicoClaw supports scheduled reminders and recurring tasks through the `cron` too
PRs welcome! The codebase is intentionally small and readable. 🤗
See our full [Community Roadmap](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md).
See our full [Community Roadmap](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md).
Developer group building, join after your first merged PR!
@ -1540,4 +1540,4 @@ User Groups:
discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">

106
README.pt-br.md
View file

@ -1,7 +1,7 @@
<div align="center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw: Assistente de IA Ultra-Eficiente em Go</h1>
<h1>Piconomous: Assistente de IA Ultra-Eficiente em Go</h1>
<h3>Hardware de $10 · <10MB de RAM · Boot em <1s · 皮皮虾，我们走！</h3>
<p>
@ -9,9 +9,9 @@
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -24,9 +24,9 @@
---
> **PicoClaw** é um projeto open-source independente iniciado pela [Sipeed](https://sipeed.com). É escrito inteiramente em **Go** — não é um fork do OpenClaw, NanoBot ou qualquer outro projeto.
> **Piconomous** é um projeto open-source independente iniciado pela [Sipeed](https://sipeed.com). É escrito inteiramente em **Go** — não é um fork do OpenClaw, NanoBot ou qualquer outro projeto.
🦐 PicoClaw é um assistente pessoal de IA ultra-leve inspirado no [NanoBot](https://github.com/HKUDS/nanobot), reescrito do zero em Go por meio de um processo de auto-inicialização (self-bootstrapping), onde o próprio agente de IA conduziu toda a migração de arquitetura e otimização de código.
🦐 Piconomous é um assistente pessoal de IA ultra-leve inspirado no [NanoBot](https://github.com/HKUDS/nanobot), reescrito do zero em Go por meio de um processo de auto-inicialização (self-bootstrapping), onde o próprio agente de IA conduziu toda a migração de arquitetura e otimização de código.
⚡️ Roda em hardware de $10 com <10MB de RAM: Isso é 99% menos memória que o OpenClaw e 98% mais barato que um Mac mini!
@ -34,7 +34,7 @@
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -48,31 +48,31 @@
> [!CAUTION]
> **🚨 DECLARAÇÃO DE SEGURANÇA & CANAIS OFICIAIS**
>
> * **SEM CRIPTOMOEDAS:** O PicoClaw **NÃO** possui nenhum token/moeda oficial. Todas as alegações no `pump.fun` ou outras plataformas de negociação são **GOLPES**.
> * **SEM CRIPTOMOEDAS:** O Piconomous **NÃO** possui nenhum token/moeda oficial. Todas as alegações no `pump.fun` ou outras plataformas de negociação são **GOLPES**.
>
> * **DOMÍNIO OFICIAL:** O **ÚNICO** site oficial é o **[picoclaw.io](https://picoclaw.io)**, e o site da empresa é o **[sipeed.com](https://sipeed.com)**
> * **DOMÍNIO OFICIAL:** O **ÚNICO** site oficial é o **[piconomous.io](https://piconomous.io)**, e o site da empresa é o **[sipeed.com](https://sipeed.com)**
> * **Aviso:** Muitos domínios `.ai/.org/.com/.net/...` foram registrados por terceiros.
> * **Aviso:** O PicoClaw está em fase inicial de desenvolvimento e pode ter problemas de segurança de rede não resolvidos. Não implante em ambientes de produção antes da versão v1.0.
> * **Nota:** O PicoClaw recentemente fez merge de muitos PRs, o que pode resultar em maior consumo de memória (10–20MB) nas versões mais recentes. Planejamos priorizar a otimização de recursos assim que o conjunto de funcionalidades estiver estável.
> * **Aviso:** O Piconomous está em fase inicial de desenvolvimento e pode ter problemas de segurança de rede não resolvidos. Não implante em ambientes de produção antes da versão v1.0.
> * **Nota:** O Piconomous recentemente fez merge de muitos PRs, o que pode resultar em maior consumo de memória (10–20MB) nas versões mais recentes. Planejamos priorizar a otimização de recursos assim que o conjunto de funcionalidades estiver estável.
## 📢 Novidades
2026-03-17 🚀 **v0.2.3 Lançado!** Interface de bandeja do sistema (Windows & Linux), rastreamento de status de sub-agentes (`spawn_status`), hot-reload experimental do gateway, portões de segurança para cron e 2 correções de segurança. PicoClaw agora com **25K ⭐**!
2026-03-17 🚀 **v0.2.3 Lançado!** Interface de bandeja do sistema (Windows & Linux), rastreamento de status de sub-agentes (`spawn_status`), hot-reload experimental do gateway, portões de segurança para cron e 2 correções de segurança. Piconomous agora com **25K ⭐**!
2026-03-09 🎉 **v0.2.1 — Maior atualização até agora!** Suporte ao protocolo MCP, 4 novos canais (Matrix/IRC/WeCom/Discord Proxy), 3 novos provedores (Kimi/Minimax/Avian), pipeline de visão, armazenamento de memória JSONL e roteamento de modelos.
2026-02-28 📦 **v0.2.0** lançado com suporte a Docker Compose e launcher Web UI.
2026-02-26 🎉 PicoClaw atingiu **20K stars** em apenas 17 dias! Orquestração automática de canais e interfaces de capacidade implementadas.
2026-02-26 🎉 Piconomous atingiu **20K stars** em apenas 17 dias! Orquestração automática de canais e interfaces de capacidade implementadas.
<details>
<summary>Novidades anteriores...</summary>
2026-02-16 🎉 PicoClaw atingiu 12K stars em uma semana! Papéis de maintainers da comunidade e [roadmap](ROADMAP.md) publicados oficialmente.
2026-02-16 🎉 Piconomous atingiu 12K stars em uma semana! Papéis de maintainers da comunidade e [roadmap](ROADMAP.md) publicados oficialmente.
2026-02-13 🎉 PicoClaw atingiu 5000 stars em 4 dias! Roadmap do Projeto e Grupo de Desenvolvedores em preparação.
2026-02-13 🎉 Piconomous atingiu 5000 stars em 4 dias! Roadmap do Projeto e Grupo de Desenvolvedores em preparação.
2026-02-09 🎉 **PicoClaw Lançado!** Construído em 1 dia para trazer Agentes de IA para hardware de $10 com <10MB de RAM. 🦐 PicoClaw, Partiu!
2026-02-09 🎉 **Piconomous Lançado!** Construído em 1 dia para trazer Agentes de IA para hardware de $10 com <10MB de RAM. 🦐 Piconomous, Partiu!
</details>
@ -96,14 +96,14 @@
_*Versões recentes podem usar 10–20MB devido a merges rápidos de funcionalidades. Otimização de recursos está planejada. Comparação de inicialização baseada em benchmarks de single-core a 0.8GHz (veja tabela abaixo)._
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- |
| **Linguagem** | TypeScript | Python | **Go** |
| **RAM** | >1GB | >100MB | **< 10MB*** |
| **Inicialização**</br>(CPU 0.8GHz) | >500s | >30s | **<1s** |
| **Custo** | Mac Mini $599 | Maioria dos SBC Linux </br>~$50 | **Qualquer placa Linux**</br>**A partir de $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
> 📋 **[Lista de Compatibilidade de Hardware](docs/hardware-compatibility.md)** — Veja todas as placas testadas, de RISC-V de $5 a Raspberry Pi e telefones Android. Sua placa não está listada? Envie um PR!
@ -118,9 +118,9 @@ _*Versões recentes podem usar 10–20MB devido a merges rápidos de funcionalid
<th><p align="center">🔎 Busca Web & Aprendizado</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">Desenvolver • Implantar • Escalar</td>
@ -131,26 +131,26 @@ _*Versões recentes podem usar 10–20MB devido a merges rápidos de funcionalid
### 📱 Rode em celulares Android antigos
Dê uma segunda vida ao seu celular de dez anos atrás! Transforme-o em um assistente de IA inteligente com o PicoClaw. Início rápido:
Dê uma segunda vida ao seu celular de dez anos atrás! Transforme-o em um assistente de IA inteligente com o Piconomous. Início rápido:
1. **Instale o [Termux](https://github.com/termux/termux-app)** (Baixe em [GitHub Releases](https://github.com/termux/termux-app/releases), ou busque no F-Droid / Google Play).
2. **Execute os comandos**
```bash
# Baixe a versão mais recente em https://github.com/sipeed/picoclaw/releases
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
# Baixe a versão mais recente em https://github.com/sipeed/piconomous/releases
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard # chroot fornece um layout padrão do sistema de arquivos Linux
termux-chroot ./piconomous onboard # chroot fornece um layout padrão do sistema de arquivos Linux
```
Depois siga as instruções na seção "Início Rápido" para completar a configuração!
<img src="assets/termux.jpg" alt="PicoClaw" width="512">
<img src="assets/termux.jpg" alt="Piconomous" width="512">
### 🐜 Implantação Inovadora com Baixo Consumo
O PicoClaw pode ser implantado em praticamente qualquer dispositivo Linux!
O Piconomous pode ser implantado em praticamente qualquer dispositivo Linux!
- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) versão E(Ethernet) ou W(WiFi6), para Assistente Doméstico Minimalista
- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), ou $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) para Manutenção Automatizada de Servidores
@ -162,20 +162,20 @@ O PicoClaw pode ser implantado em praticamente qualquer dispositivo Linux!
## 📦 Instalação
### Baixar de picoclaw.io (Recomendado)
### Baixar de piconomous.io (Recomendado)
Visite **[picoclaw.io](https://picoclaw.io)** — o site oficial detecta automaticamente sua plataforma e oferece download com um clique. Sem necessidade de escolher manualmente a arquitetura.
Visite **[piconomous.io](https://piconomous.io)** — o site oficial detecta automaticamente sua plataforma e oferece download com um clique. Sem necessidade de escolher manualmente a arquitetura.
### Baixar binário pré-compilado
Alternativamente, baixe o binário para sua plataforma na página de [GitHub Releases](https://github.com/sipeed/picoclaw/releases).
Alternativamente, baixe o binário para sua plataforma na página de [GitHub Releases](https://github.com/sipeed/piconomous/releases).
### Compilar a partir do código-fonte (para desenvolvimento)
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# Build, sem necessidade de instalar
@ -210,7 +210,7 @@ Para guias detalhados, consulte a documentação abaixo. Este README cobre apena
## <img src="assets/clawdchat-icon.png" width="24" height="24" alt="ClawdChat"> Junte-se à Rede Social de Agentes
Conecte o PicoClaw à Rede Social de Agentes simplesmente enviando uma única mensagem via CLI ou qualquer App de Chat integrado.
Conecte o Piconomous à Rede Social de Agentes simplesmente enviando uma única mensagem via CLI ou qualquer App de Chat integrado.
**Leia `https://clawdchat.ai/skill.md` e siga as instruções para entrar no [ClawdChat.ai](https://clawdchat.ai)**
@ -218,25 +218,25 @@ Conecte o PicoClaw à Rede Social de Agentes simplesmente enviando uma única me
| Comando | Descrição |
| ------------------------- | ----------------------------- |
| `picoclaw onboard` | Inicializar configuração & workspace |
| `picoclaw agent -m "..."` | Conversar com o agente |
| `picoclaw agent` | Modo de chat interativo |
| `picoclaw gateway` | Iniciar o gateway |
| `picoclaw status` | Mostrar status |
| `picoclaw version` | Mostrar informações de versão |
| `picoclaw cron list` | Listar todas as tarefas agendadas |
| `picoclaw cron add ...` | Adicionar uma tarefa agendada |
| `picoclaw cron disable` | Desabilitar uma tarefa agendada |
| `picoclaw cron remove` | Remover uma tarefa agendada |
| `picoclaw skills list` | Listar skills instaladas |
| `picoclaw skills install` | Instalar uma skill |
| `picoclaw migrate` | Migrar dados de versões anteriores |
| `picoclaw auth login` | Autenticar com provedores |
| `picoclaw model` | Ver ou trocar o modelo padrão |
| `piconomous onboard` | Inicializar configuração & workspace |
| `piconomous agent -m "..."` | Conversar com o agente |
| `piconomous agent` | Modo de chat interativo |
| `piconomous gateway` | Iniciar o gateway |
| `piconomous status` | Mostrar status |
| `piconomous version` | Mostrar informações de versão |
| `piconomous cron list` | Listar todas as tarefas agendadas |
| `piconomous cron add ...` | Adicionar uma tarefa agendada |
| `piconomous cron disable` | Desabilitar uma tarefa agendada |
| `piconomous cron remove` | Remover uma tarefa agendada |
| `piconomous skills list` | Listar skills instaladas |
| `piconomous skills install` | Instalar uma skill |
| `piconomous migrate` | Migrar dados de versões anteriores |
| `piconomous auth login` | Autenticar com provedores |
| `piconomous model` | Ver ou trocar o modelo padrão |
### Tarefas Agendadas / Lembretes
O PicoClaw suporta lembretes agendados e tarefas recorrentes por meio da ferramenta `cron`:
O Piconomous suporta lembretes agendados e tarefas recorrentes por meio da ferramenta `cron`:
* **Lembretes únicos**: "Me lembre em 10 minutos" → dispara uma vez após 10min
* **Tarefas recorrentes**: "Me lembre a cada 2 horas" → dispara a cada 2 horas
@ -246,7 +246,7 @@ O PicoClaw suporta lembretes agendados e tarefas recorrentes por meio da ferrame
PRs são bem-vindos! O código-fonte é intencionalmente pequeno e legível. 🤗
Veja nosso [Roadmap da Comunidade](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md) completo.
Veja nosso [Roadmap da Comunidade](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md) completo.
Grupo de desenvolvedores em formação. Junte-se após seu primeiro PR com merge!
@ -254,4 +254,4 @@ Grupos de usuários:
discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">

106
README.vi.md
View file

@ -1,7 +1,7 @@
<div align="center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw: Trợ lý AI Siêu Nhẹ viết bằng Go</h1>
<h1>Piconomous: Trợ lý AI Siêu Nhẹ viết bằng Go</h1>
<h3>Phần cứng $10 · <10MB RAM · Khởi động <1 giây · Nào, xuất phát!</h3>
<p>
@ -9,9 +9,9 @@
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -24,9 +24,9 @@
---
> **PicoClaw** là dự án mã nguồn mở độc lập được khởi xướng bởi [Sipeed](https://sipeed.com). Được viết hoàn toàn bằng **Go** — không phải là bản fork của OpenClaw, NanoBot hay bất kỳ dự án nào khác.
> **Piconomous** là dự án mã nguồn mở độc lập được khởi xướng bởi [Sipeed](https://sipeed.com). Được viết hoàn toàn bằng **Go** — không phải là bản fork của OpenClaw, NanoBot hay bất kỳ dự án nào khác.
🦐 PicoClaw là trợ lý AI cá nhân siêu nhẹ, lấy cảm hứng từ [NanoBot](https://github.com/HKUDS/nanobot), được viết lại hoàn toàn bằng Go thông qua quá trình "tự khởi tạo" (self-bootstrapping) — nơi chính AI Agent đã tự dẫn dắt toàn bộ quá trình chuyển đổi kiến trúc và tối ưu hóa mã nguồn.
🦐 Piconomous là trợ lý AI cá nhân siêu nhẹ, lấy cảm hứng từ [NanoBot](https://github.com/HKUDS/nanobot), được viết lại hoàn toàn bằng Go thông qua quá trình "tự khởi tạo" (self-bootstrapping) — nơi chính AI Agent đã tự dẫn dắt toàn bộ quá trình chuyển đổi kiến trúc và tối ưu hóa mã nguồn.
⚡️ Chạy trên phần cứng chỉ $10 với RAM <10MB: Tiết kiệm 99% bộ nhớ so với OpenClaw và rẻ hơn 98% so với Mac mini!
@ -34,7 +34,7 @@
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -48,31 +48,31 @@
> [!CAUTION]
> **🚨 TUYÊN BỐ BẢO MẬT & KÊNH CHÍNH THỨC**
>
> * **KHÔNG CÓ CRYPTO:** PicoClaw **KHÔNG** có bất kỳ token/coin chính thức nào. Mọi thông tin trên `pump.fun` hoặc các sàn giao dịch khác đều là **LỪA ĐẢO**.
> * **KHÔNG CÓ CRYPTO:** Piconomous **KHÔNG** có bất kỳ token/coin chính thức nào. Mọi thông tin trên `pump.fun` hoặc các sàn giao dịch khác đều là **LỪA ĐẢO**.
>
> * **DOMAIN CHÍNH THỨC:** Website chính thức **DUY NHẤT** là **[picoclaw.io](https://picoclaw.io)**, website công ty là **[sipeed.com](https://sipeed.com)**
> * **DOMAIN CHÍNH THỨC:** Website chính thức **DUY NHẤT** là **[piconomous.io](https://piconomous.io)**, website công ty là **[sipeed.com](https://sipeed.com)**
> * **Cảnh báo:** Nhiều tên miền `.ai/.org/.com/.net/...` đã bị bên thứ ba đăng ký.
> * **Cảnh báo:** PicoClaw đang trong giai đoạn phát triển sớm và có thể còn các vấn đề bảo mật mạng chưa được giải quyết. Không nên triển khai lên môi trường production trước phiên bản v1.0.
> * **Lưu ý:** PicoClaw gần đây đã merge nhiều PR, dẫn đến bộ nhớ sử dụng có thể lớn hơn (10–20MB) ở các phiên bản mới nhất. Chúng tôi sẽ ưu tiên tối ưu tài nguyên khi bộ tính năng đã ổn định.
> * **Cảnh báo:** Piconomous đang trong giai đoạn phát triển sớm và có thể còn các vấn đề bảo mật mạng chưa được giải quyết. Không nên triển khai lên môi trường production trước phiên bản v1.0.
> * **Lưu ý:** Piconomous gần đây đã merge nhiều PR, dẫn đến bộ nhớ sử dụng có thể lớn hơn (10–20MB) ở các phiên bản mới nhất. Chúng tôi sẽ ưu tiên tối ưu tài nguyên khi bộ tính năng đã ổn định.
## 📢 Tin tức
2026-03-17 🚀 **v0.2.3 Phát hành!** Giao diện khay hệ thống (Windows & Linux), theo dõi trạng thái sub-agent (`spawn_status`), hot-reload gateway thử nghiệm, cổng bảo mật cron và 2 bản vá bảo mật. PicoClaw đạt **25K ⭐**!
2026-03-17 🚀 **v0.2.3 Phát hành!** Giao diện khay hệ thống (Windows & Linux), theo dõi trạng thái sub-agent (`spawn_status`), hot-reload gateway thử nghiệm, cổng bảo mật cron và 2 bản vá bảo mật. Piconomous đạt **25K ⭐**!
2026-03-09 🎉 **v0.2.1 — Bản cập nhật lớn nhất!** Hỗ trợ giao thức MCP, 4 kênh mới (Matrix/IRC/WeCom/Discord Proxy), 3 nhà cung cấp mới (Kimi/Minimax/Avian), pipeline xử lý hình ảnh, bộ nhớ JSONL và định tuyến mô hình.
2026-02-28 📦 **v0.2.0** phát hành với hỗ trợ Docker Compose và launcher Web UI.
2026-02-26 🎉 PicoClaw đạt **20K stars** chỉ trong 17 ngày! Tự động điều phối kênh và giao diện năng lực đã được triển khai.
2026-02-26 🎉 Piconomous đạt **20K stars** chỉ trong 17 ngày! Tự động điều phối kênh và giao diện năng lực đã được triển khai.
<details>
<summary>Tin tức cũ hơn...</summary>
2026-02-16 🎉 PicoClaw đạt 12K stars chỉ trong một tuần! Vai trò maintainer cộng đồng và [roadmap](ROADMAP.md) đã được công bố chính thức.
2026-02-16 🎉 Piconomous đạt 12K stars chỉ trong một tuần! Vai trò maintainer cộng đồng và [roadmap](ROADMAP.md) đã được công bố chính thức.
2026-02-13 🎉 PicoClaw đạt 5000 stars trong 4 ngày! Lộ trình dự án và Nhóm phát triển đang được thiết lập.
2026-02-13 🎉 Piconomous đạt 5000 stars trong 4 ngày! Lộ trình dự án và Nhóm phát triển đang được thiết lập.
2026-02-09 🎉 **PicoClaw chính thức ra mắt!** Được xây dựng trong 1 ngày để mang AI Agent đến phần cứng $10 với RAM <10MB. 🦐 PicoClaw, Lên Đường!
2026-02-09 🎉 **Piconomous chính thức ra mắt!** Được xây dựng trong 1 ngày để mang AI Agent đến phần cứng $10 với RAM <10MB. 🦐 Piconomous, Lên Đường!
</details>
@ -96,14 +96,14 @@
_*Các phiên bản gần đây có thể sử dụng 10–20MB do merge tính năng nhanh chóng. Tối ưu tài nguyên đang được lên kế hoạch. So sánh thời gian khởi động dựa trên benchmark đơn nhân 0.8GHz (xem bảng bên dưới)._
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- |
| **Ngôn ngữ** | TypeScript | Python | **Go** |
| **RAM** | >1GB | >100MB | **< 10MB*** |
| **Thời gian khởi động**</br>(CPU 0.8GHz) | >500s | >30s | **<1s** |
| **Chi phí** | Mac Mini $599 | Hầu hết SBC Linux ~$50 | **Mọi bo mạch Linux**</br>**Chỉ từ $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
> 📋 **[Danh Sách Tương Thích Phần Cứng](docs/hardware-compatibility.md)** — Xem tất cả các board đã được kiểm tra, từ RISC-V $5 đến Raspberry Pi và điện thoại Android. Board của bạn chưa có? Gửi PR!
@ -118,9 +118,9 @@ _*Các phiên bản gần đây có thể sử dụng 10–20MB do merge tính n
<th><p align="center">🔎 Tìm kiếm Web & Học hỏi</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">Phát triển • Triển khai • Mở rộng</td>
@ -131,26 +131,26 @@ _*Các phiên bản gần đây có thể sử dụng 10–20MB do merge tính n
### 📱 Chạy trên điện thoại Android cũ
Hãy cho chiếc điện thoại cũ một cuộc sống mới! Biến nó thành trợ lý AI thông minh với PicoClaw. Bắt đầu nhanh:
Hãy cho chiếc điện thoại cũ một cuộc sống mới! Biến nó thành trợ lý AI thông minh với Piconomous. Bắt đầu nhanh:
1. **Cài đặt [Termux](https://github.com/termux/termux-app)** (Tải từ [GitHub Releases](https://github.com/termux/termux-app/releases), hoặc tìm trên F-Droid / Google Play).
2. **Chạy các lệnh**
```bash
# Tải phiên bản mới nhất từ https://github.com/sipeed/picoclaw/releases
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
# Tải phiên bản mới nhất từ https://github.com/sipeed/piconomous/releases
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard # chroot cung cấp bố cục hệ thống tệp Linux tiêu chuẩn
termux-chroot ./piconomous onboard # chroot cung cấp bố cục hệ thống tệp Linux tiêu chuẩn
```
Sau đó làm theo hướng dẫn trong phần "Bắt đầu nhanh" để hoàn tất cấu hình!
<img src="assets/termux.jpg" alt="PicoClaw" width="512">
<img src="assets/termux.jpg" alt="Piconomous" width="512">
### 🐜 Triển khai sáng tạo trên phần cứng tối thiểu
PicoClaw có thể triển khai trên hầu hết mọi thiết bị Linux!
Piconomous có thể triển khai trên hầu hết mọi thiết bị Linux!
- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) phiên bản E(Ethernet) hoặc W(WiFi6), dùng làm Trợ lý Gia đình tối giản
- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), hoặc $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) dùng cho quản trị Server tự động
@ -162,20 +162,20 @@ PicoClaw có thể triển khai trên hầu hết mọi thiết bị Linux!
## 📦 Cài đặt
### Tải từ picoclaw.io (Khuyến nghị)
### Tải từ piconomous.io (Khuyến nghị)
Truy cập **[picoclaw.io](https://picoclaw.io)** — trang web chính thức tự động phát hiện nền tảng của bạn và cung cấp tải xuống một cú nhấp. Không cần chọn kiến trúc thủ công.
Truy cập **[piconomous.io](https://piconomous.io)** — trang web chính thức tự động phát hiện nền tảng của bạn và cung cấp tải xuống một cú nhấp. Không cần chọn kiến trúc thủ công.
### Tải binary đã biên dịch sẵn
Hoặc tải binary cho nền tảng của bạn từ trang [GitHub Releases](https://github.com/sipeed/picoclaw/releases).
Hoặc tải binary cho nền tảng của bạn từ trang [GitHub Releases](https://github.com/sipeed/piconomous/releases).
### Biên dịch từ mã nguồn (cho phát triển)
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# Build (không cần cài đặt)
@ -210,7 +210,7 @@ make install
## <img src="assets/clawdchat-icon.png" width="24" height="24" alt="ClawdChat"> Tham gia Mạng xã hội Agent
Kết nối PicoClaw với Mạng xã hội Agent chỉ bằng cách gửi một tin nhắn qua CLI hoặc bất kỳ ứng dụng Chat nào đã tích hợp.
Kết nối Piconomous với Mạng xã hội Agent chỉ bằng cách gửi một tin nhắn qua CLI hoặc bất kỳ ứng dụng Chat nào đã tích hợp.
**Đọc `https://clawdchat.ai/skill.md` và làm theo hướng dẫn để tham gia [ClawdChat.ai](https://clawdchat.ai)**
@ -218,25 +218,25 @@ Kết nối PicoClaw với Mạng xã hội Agent chỉ bằng cách gửi một
| Lệnh | Mô tả |
| -------------------------- | ------------------------------ |
| `picoclaw onboard` | Khởi tạo cấu hình & workspace |
| `picoclaw agent -m "..."` | Trò chuyện với agent |
| `picoclaw agent` | Chế độ chat tương tác |
| `picoclaw gateway` | Khởi động gateway |
| `picoclaw status` | Hiển thị trạng thái |
| `picoclaw version` | Hiển thị thông tin phiên bản |
| `picoclaw cron list` | Liệt kê tất cả tác vụ định kỳ |
| `picoclaw cron add ...` | Thêm tác vụ định kỳ |
| `picoclaw cron disable` | Tắt tác vụ định kỳ |
| `picoclaw cron remove` | Xóa tác vụ định kỳ |
| `picoclaw skills list` | Liệt kê các skill đã cài |
| `picoclaw skills install` | Cài đặt một skill |
| `picoclaw migrate` | Di chuyển dữ liệu từ phiên bản cũ |
| `picoclaw auth login` | Xác thực với nhà cung cấp |
| `picoclaw model` | Xem hoặc chuyển đổi model mặc định |
| `piconomous onboard` | Khởi tạo cấu hình & workspace |
| `piconomous agent -m "..."` | Trò chuyện với agent |
| `piconomous agent` | Chế độ chat tương tác |
| `piconomous gateway` | Khởi động gateway |
| `piconomous status` | Hiển thị trạng thái |
| `piconomous version` | Hiển thị thông tin phiên bản |
| `piconomous cron list` | Liệt kê tất cả tác vụ định kỳ |
| `piconomous cron add ...` | Thêm tác vụ định kỳ |
| `piconomous cron disable` | Tắt tác vụ định kỳ |
| `piconomous cron remove` | Xóa tác vụ định kỳ |
| `piconomous skills list` | Liệt kê các skill đã cài |
| `piconomous skills install` | Cài đặt một skill |
| `piconomous migrate` | Di chuyển dữ liệu từ phiên bản cũ |
| `piconomous auth login` | Xác thực với nhà cung cấp |
| `piconomous model` | Xem hoặc chuyển đổi model mặc định |
### Tác vụ định kỳ / Nhắc nhở
PicoClaw hỗ trợ nhắc nhở theo lịch và tác vụ lặp lại thông qua công cụ `cron`:
Piconomous hỗ trợ nhắc nhở theo lịch và tác vụ lặp lại thông qua công cụ `cron`:
* **Nhắc nhở một lần**: "Nhắc tôi sau 10 phút" → kích hoạt một lần sau 10 phút
* **Tác vụ lặp lại**: "Nhắc tôi mỗi 2 giờ" → kích hoạt mỗi 2 giờ
@ -246,7 +246,7 @@ PicoClaw hỗ trợ nhắc nhở theo lịch và tác vụ lặp lại thông qu
Chào đón mọi PR! Mã nguồn được thiết kế nhỏ gọn và dễ đọc. 🤗
Xem [Lộ trình Cộng đồng](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md) đầy đủ.
Xem [Lộ trình Cộng đồng](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md) đầy đủ.
Nhóm phát triển đang được xây dựng. Tham gia sau khi có PR đầu tiên được merge!
@ -254,4 +254,4 @@ Nhóm người dùng:
discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">

106
README.zh.md
View file

@ -1,7 +1,7 @@
<div align="center">
<img src="assets/logo.webp" alt="PicoClaw" width="512">
<img src="assets/logo.webp" alt="Piconomous" width="512">
<h1>PicoClaw: 基于Go语言的超高效 AI 助手</h1>
<h1>Piconomous: 基于Go语言的超高效 AI 助手</h1>
<h3>$10 硬件 · <10MB 内存 · <1s 启动 · 皮皮虾，我们走！</h3>
<p>
@ -9,9 +9,9 @@
<img src="https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue" alt="Hardware">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<br>
<a href="https://picoclaw.io"><img src="https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.picoclaw.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<a href="https://piconomous.io"><img src="https://img.shields.io/badge/Website-piconomous.io-blue?style=flat&logo=google-chrome&logoColor=white" alt="Website"></a>
<a href="https://docs.piconomous.io/"><img src="https://img.shields.io/badge/Docs-Official-007acc?style=flat&logo=read-the-docs&logoColor=white" alt="Docs"></a>
<a href="https://deepwiki.com/sipeed/piconomous"><img src="https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat&logo=wikipedia&logoColor=white" alt="Wiki"></a>
<br>
<a href="https://x.com/SipeedIO"><img src="https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat&logo=x&logoColor=white" alt="Twitter"></a>
<a href="./assets/wechat.png"><img src="https://img.shields.io/badge/WeChat-Group-41d56b?style=flat&logo=wechat&logoColor=white"></a>
@ -24,9 +24,9 @@
---
> **PicoClaw** 是由 [矽速科技 (Sipeed)](https://sipeed.com) 发起的独立开源项目，完全使用 **Go 语言**从零编写——不是 OpenClaw、NanoBot 或其他项目的分支。
> **Piconomous** 是由 [矽速科技 (Sipeed)](https://sipeed.com) 发起的独立开源项目，完全使用 **Go 语言**从零编写——不是 OpenClaw、NanoBot 或其他项目的分支。
🦐 **PicoClaw** 是一个受 [NanoBot](https://github.com/HKUDS/nanobot) 启发的超轻量级个人 AI 助手。它采用 **Go 语言** 从零重构，经历了一个"自举"过程——即由 AI Agent 自身驱动了整个架构迁移和代码优化。
🦐 **Piconomous** 是一个受 [NanoBot](https://github.com/HKUDS/nanobot) 启发的超轻量级个人 AI 助手。它采用 **Go 语言** 从零重构，经历了一个"自举"过程——即由 AI Agent 自身驱动了整个架构迁移和代码优化。
⚡️ **极致轻量**：可在 **10 美元** 的硬件上运行，内存占用 **<10MB**。这意味着比 OpenClaw 节省 99% 的内存，比 Mac mini 便宜 98%！
@ -34,7 +34,7 @@
<tr align="center">
<td align="center" valign="top">
<p align="center">
<img src="assets/picoclaw_mem.gif" width="360" height="240">
<img src="assets/piconomous_mem.gif" width="360" height="240">
</p>
</td>
<td align="center" valign="top">
@ -48,30 +48,30 @@
> [!CAUTION]
> **🚨 安全声明**
>
> - **无加密货币 (NO CRYPTO):** PicoClaw **没有** 发行任何官方代币、Token 或虚拟货币。所有在 `pump.fun` 或其他交易平台上的相关声称均为 **诈骗**。
> - **官方域名:** 唯一的官方网站是 **[picoclaw.io](https://picoclaw.io)**，公司官网是 **[sipeed.com](https://sipeed.com)**。
> - **无加密货币 (NO CRYPTO):** Piconomous **没有** 发行任何官方代币、Token 或虚拟货币。所有在 `pump.fun` 或其他交易平台上的相关声称均为 **诈骗**。
> - **官方域名:** 唯一的官方网站是 **[piconomous.io](https://piconomous.io)**，公司官网是 **[sipeed.com](https://sipeed.com)**。
> - **警惕:** 许多 `.ai/.org/.com/.net/...` 后缀的域名被第三方抢注，请勿轻信。
> - **注意:** PicoClaw 正在初期的快速功能开发阶段，可能有尚未修复的网络安全问题，在 1.0 正式版发布前，请不要将其部署到生产环境中。
> - **注意:** PicoClaw 最近合并了大量 PR，近期版本可能内存占用较大 (10~20MB)，我们将在功能较为收敛后进行资源占用优化。
> - **注意:** Piconomous 正在初期的快速功能开发阶段，可能有尚未修复的网络安全问题，在 1.0 正式版发布前，请不要将其部署到生产环境中。
> - **注意:** Piconomous 最近合并了大量 PR，近期版本可能内存占用较大 (10~20MB)，我们将在功能较为收敛后进行资源占用优化。
## 📢 新闻
2026-03-17 🚀 **v0.2.3 发布！** 系统托盘 UI（Windows & Linux）、子 Agent 状态查询 (`spawn_status`)、实验性 Gateway 热重载、Cron 安全门控，以及 2 项安全修复。PicoClaw 已达 **25K ⭐**！
2026-03-17 🚀 **v0.2.3 发布！** 系统托盘 UI（Windows & Linux）、子 Agent 状态查询 (`spawn_status`)、实验性 Gateway 热重载、Cron 安全门控，以及 2 项安全修复。Piconomous 已达 **25K ⭐**！
2026-03-09 🎉 **v0.2.1 — 史上最大更新！** MCP 协议支持、4 个新频道 (Matrix/IRC/WeCom/Discord Proxy)、3 个新 Provider (Kimi/Minimax/Avian)、视觉管线、JSONL 记忆存储、模型路由。
2026-02-28 📦 **v0.2.0** 发布，支持 Docker Compose 和 Web UI 启动器。
2026-02-26 🎉 PicoClaw 仅 17 天突破 **20K Stars**！频道自动编排和能力接口上线。
2026-02-26 🎉 Piconomous 仅 17 天突破 **20K Stars**！频道自动编排和能力接口上线。
<details>
<summary>更早的新闻...</summary>
2026-02-16 🎉 PicoClaw 一周内突破 12K Stars！社区维护者角色和 [路线图](ROADMAP.md) 正式发布。
2026-02-16 🎉 Piconomous 一周内突破 12K Stars！社区维护者角色和 [路线图](ROADMAP.md) 正式发布。
2026-02-13 🎉 PicoClaw 4 天内突破 5000 Stars！项目路线图和开发者群组筹建中。
2026-02-13 🎉 Piconomous 4 天内突破 5000 Stars！项目路线图和开发者群组筹建中。
2026-02-09 🎉 **PicoClaw 正式发布！** 仅用 1 天构建，将 AI Agent 带入 $10 硬件与 <10MB 内存的世界。🦐 皮皮虾，我们走！
2026-02-09 🎉 **Piconomous 正式发布！** 仅用 1 天构建，将 AI Agent 带入 $10 硬件与 <10MB 内存的世界。🦐 皮皮虾，我们走！
</details>
@ -95,14 +95,14 @@
_*近期版本因快速合并 PR 可能占用 10–20MB，资源优化已列入计划。启动速度对比基于 0.8GHz 单核实测（见下方对比表）。_
| | OpenClaw | NanoBot | **PicoClaw** |
| | OpenClaw | NanoBot | **Piconomous** |
| ------------------------------ | ------------- | ------------------------ | -------------------------------------- |
| **语言** | TypeScript | Python | **Go** |
| **RAM** | >1GB | >100MB | **< 10MB*** |
| **启动时间**</br>(0.8GHz core) | >500s | >30s | **<1s** |
| **成本** | Mac Mini $599 | 大多数 Linux 开发板 ~$50 | **任意 Linux 开发板**</br>**低至 $10** |
<img src="assets/compare.jpg" alt="PicoClaw" width="512">
<img src="assets/compare.jpg" alt="Piconomous" width="512">
> 📋 **[硬件兼容列表](docs/hardware-compatibility.md)** — 查看所有已测试的板卡，从 $5 RISC-V 到树莓派到安卓手机。你的板卡没在列表中？欢迎提交 PR！
@ -117,9 +117,9 @@ _*近期版本因快速合并 PR 可能占用 10–20MB，资源优化已列入
<th><p align="center">🔎 网络搜索与学习</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="assets/picoclaw_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/picoclaw_search.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_code.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_memory.gif" width="240" height="180"></p></td>
<td align="center"><p align="center"><img src="assets/piconomous_search.gif" width="240" height="180"></p></td>
</tr>
<tr>
<td align="center">开发 • 部署 • 扩展</td>
@ -130,26 +130,26 @@ _*近期版本因快速合并 PR 可能占用 10–20MB，资源优化已列入
### 📱 在手机上轻松运行
PicoClaw 可以将你 10 年前的老旧手机废物利用，变身成为你的 AI 助理！快速指南：
Piconomous 可以将你 10 年前的老旧手机废物利用，变身成为你的 AI 助理！快速指南：
1. 安装 [Termux](https://github.com/termux/termux-app)（可从 [GitHub Releases](https://github.com/termux/termux-app/releases) 下载，或在 F-Droid 等应用商店搜索）
2. 打开后执行指令
```bash
# 从 Release 页面下载最新版本
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
wget https://github.com/sipeed/piconomous/releases/latest/download/piconomous_Linux_arm64.tar.gz
tar xzf piconomous_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard # chroot 提供标准 Linux 文件系统布局
termux-chroot ./piconomous onboard # chroot 提供标准 Linux 文件系统布局
```
然后跟随下面的"快速开始"章节继续配置 PicoClaw 即可使用！
然后跟随下面的"快速开始"章节继续配置 Piconomous 即可使用！
<img src="assets/termux.jpg" alt="PicoClaw" width="512">
<img src="assets/termux.jpg" alt="Piconomous" width="512">
### 🐜 创新的低占用部署
PicoClaw 几乎可以部署在任何 Linux 设备上！
Piconomous 几乎可以部署在任何 Linux 设备上！
- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) E(网口) 或 W(WiFi6) 版本，用于极简家庭助手
- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html)，或 $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html)，用于自动化服务器运维
@ -161,20 +161,20 @@ PicoClaw 几乎可以部署在任何 Linux 设备上！
## 📦 安装
### 从 picoclaw.io 下载（推荐）
### 从 piconomous.io 下载（推荐）
访问 **[picoclaw.io](https://picoclaw.io)** — 官网自动检测你的平台，提供一键下载，无需手动选择架构。
访问 **[piconomous.io](https://piconomous.io)** — 官网自动检测你的平台，提供一键下载，无需手动选择架构。
### 下载预编译二进制文件
也可以从 [GitHub Releases](https://github.com/sipeed/picoclaw/releases) 页面手动下载对应平台的二进制文件。
也可以从 [GitHub Releases](https://github.com/sipeed/piconomous/releases) 页面手动下载对应平台的二进制文件。
### 从源码构建（开发用）
```bash
git clone https://github.com/sipeed/picoclaw.git
git clone https://github.com/sipeed/piconomous.git
cd picoclaw
cd piconomous
make deps
# 构建（无需安装）
@ -209,7 +209,7 @@ make install
## <img src="assets/clawdchat-icon.png" width="24" height="24" alt="ClawdChat"> 加入 Agent 社交网络
通过 CLI 或任何已集成的聊天应用发送一条消息，即可将 PicoClaw 连接到 Agent 社交网络。
通过 CLI 或任何已集成的聊天应用发送一条消息，即可将 Piconomous 连接到 Agent 社交网络。
**阅读 `https://clawdchat.ai/skill.md` 并按照说明加入 [ClawdChat.ai](https://clawdchat.ai)**
@ -217,25 +217,25 @@ make install
| 命令 | 说明 |
| ------------------------- | ---------------------- |
| `picoclaw onboard` | 初始化配置与工作区 |
| `picoclaw agent -m "..."` | 与 Agent 对话 |
| `picoclaw agent` | 交互式对话模式 |
| `picoclaw gateway` | 启动网关 |
| `picoclaw status` | 查看状态 |
| `picoclaw version` | 查看版本信息 |
| `picoclaw cron list` | 列出所有定时任务 |
| `picoclaw cron add ...` | 添加定时任务 |
| `picoclaw cron disable` | 禁用定时任务 |
| `picoclaw cron remove` | 删除定时任务 |
| `picoclaw skills list` | 列出已安装技能 |
| `picoclaw skills install` | 安装技能 |
| `picoclaw migrate` | 从旧版本迁移数据 |
| `picoclaw auth login` | 认证提供商 |
| `picoclaw model` | 查看或切换默认模型 |
| `piconomous onboard` | 初始化配置与工作区 |
| `piconomous agent -m "..."` | 与 Agent 对话 |
| `piconomous agent` | 交互式对话模式 |
| `piconomous gateway` | 启动网关 |
| `piconomous status` | 查看状态 |
| `piconomous version` | 查看版本信息 |
| `piconomous cron list` | 列出所有定时任务 |
| `piconomous cron add ...` | 添加定时任务 |
| `piconomous cron disable` | 禁用定时任务 |
| `piconomous cron remove` | 删除定时任务 |
| `piconomous skills list` | 列出已安装技能 |
| `piconomous skills install` | 安装技能 |
| `piconomous migrate` | 从旧版本迁移数据 |
| `piconomous auth login` | 认证提供商 |
| `piconomous model` | 查看或切换默认模型 |
### 定时任务 / 提醒
PicoClaw 通过 `cron` 工具支持定时提醒和重复任务：
Piconomous 通过 `cron` 工具支持定时提醒和重复任务：
* **一次性提醒**: "10分钟后提醒我" → 10分钟后触发一次
* **重复任务**: "每2小时提醒我" → 每2小时触发
@ -245,7 +245,7 @@ PicoClaw 通过 `cron` 工具支持定时提醒和重复任务：
欢迎提交 PR！代码库刻意保持小巧和可读。🤗
查看完整的 [社区路线图](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md)。
查看完整的 [社区路线图](https://github.com/sipeed/piconomous/blob/main/ROADMAP.md)。
开发者群组正在组建中，入群门槛：至少合并过 1 个 PR。
@ -253,4 +253,4 @@ PicoClaw 通过 `cron` 工具支持定时提醒和重复任务：
Discord: <https://discord.gg/V4sAZ9XWpN>
<img src="assets/wechat.png" alt="PicoClaw" width="512">
<img src="assets/wechat.png" alt="Piconomous" width="512">

30
ROADMAP.md
View file

@ -1,5 +1,5 @@
# 🦐 PicoClaw Roadmap
# 🦐 Piconomous Roadmap
> **Vision**: To build the ultimate lightweight, secure, and fully autonomous AI Agent infrastructure.automate the mundane, unleash your creativity
@ -7,9 +7,9 @@
## 🚀 1. Core Optimization: Extreme Lightweight
*Our defining characteristic. We fight software bloat to ensure PicoClaw runs smoothly on the smallest embedded devices.*
*Our defining characteristic. We fight software bloat to ensure Piconomous runs smoothly on the smallest embedded devices.*
* [**Memory Footprint Reduction**](https://github.com/sipeed/picoclaw/issues/346)
* [**Memory Footprint Reduction**](https://github.com/sipeed/piconomous/issues/346)
* **Goal**: Run smoothly on 64MB RAM embedded boards (e.g., low-end RISC-V SBCs) with the core process consuming < 20MB.
* **Context**: RAM is expensive and scarce on edge devices. Memory optimization takes precedence over storage size.
* **Action**: Analyze memory growth between releases, remove redundant dependencies, and optimize data structures.
@ -42,7 +42,7 @@
*Connect every model, reach every platform.*
* **Provider**
* [**Architecture Upgrade**](https://github.com/sipeed/picoclaw/issues/283): Refactor from "Vendor-based" to "Protocol-based" classification (e.g., OpenAI-compatible, Ollama-compatible). *(Status: In progress by @Daming, ETA 5 days)*
* [**Architecture Upgrade**](https://github.com/sipeed/piconomous/issues/283): Refactor from "Vendor-based" to "Protocol-based" classification (e.g., OpenAI-compatible, Ollama-compatible). *(Status: In progress by @Daming, ETA 5 days)*
* **Local Models**: Deep integration with **Ollama**, **vLLM**, **LM Studio**, and **Mistral** (local inference).
* **Online Models**: Continued support for frontier closed-source models.
@ -50,11 +50,11 @@
* **Channel**
* **IM Matrix**: QQ, WeChat (Work), DingTalk, Feishu (Lark), Telegram, Discord, WhatsApp, LINE, Slack, Email, KOOK, Signal, ...
* **Standards**: Support for the **OneBot** protocol.
* [**attachment**](https://github.com/sipeed/picoclaw/issues/348): Native handling of images, audio, and video attachments.
* [**attachment**](https://github.com/sipeed/piconomous/issues/348): Native handling of images, audio, and video attachments.
* **Skill Marketplace**
* [**Discovery skills**](https://github.com/sipeed/picoclaw/issues/287): Implement `find_skill` to automatically discover and install skills from the [GitHub Skills Repo] or other registries.
* [**Discovery skills**](https://github.com/sipeed/piconomous/issues/287): Implement `find_skill` to automatically discover and install skills from the [GitHub Skills Repo] or other registries.
@ -63,16 +63,16 @@
*Beyond conversation—focusing on action and collaboration.*
* **Operations**
* [**MCP Support**](https://github.com/sipeed/picoclaw/issues/290): Native support for the **Model Context Protocol (MCP)**.
* [**Browser Automation**](https://github.com/sipeed/picoclaw/issues/293): Headless browser control via CDP (Chrome DevTools Protocol) or ActionBook.
* [**Mobile Operation**](https://github.com/sipeed/picoclaw/issues/292): Android device control (similar to BotDrop).
* [**MCP Support**](https://github.com/sipeed/piconomous/issues/290): Native support for the **Model Context Protocol (MCP)**.
* [**Browser Automation**](https://github.com/sipeed/piconomous/issues/293): Headless browser control via CDP (Chrome DevTools Protocol) or ActionBook.
* [**Mobile Operation**](https://github.com/sipeed/piconomous/issues/292): Android device control (similar to BotDrop).
* **Multi-Agent Collaboration**
* [**Basic Multi-Agent**](https://github.com/sipeed/picoclaw/issues/294) implement
* [**Model Routing**](https://github.com/sipeed/picoclaw/issues/295): "Smart Routing" — dispatch simple tasks to small/local models (fast/cheap) and complex tasks to SOTA models (smart).
* [**Swarm Mode**](https://github.com/sipeed/picoclaw/issues/284): Collaboration between multiple PicoClaw instances on the same network.
* [**AIEOS**](https://github.com/sipeed/picoclaw/issues/296): Exploring AI-Native Operating System interaction paradigms.
* [**Basic Multi-Agent**](https://github.com/sipeed/piconomous/issues/294) implement
* [**Model Routing**](https://github.com/sipeed/piconomous/issues/295): "Smart Routing" — dispatch simple tasks to small/local models (fast/cheap) and complex tasks to SOTA models (smart).
* [**Swarm Mode**](https://github.com/sipeed/piconomous/issues/284): Collaboration between multiple Piconomous instances on the same network.
* [**AIEOS**](https://github.com/sipeed/piconomous/issues/296): Exploring AI-Native Operating System interaction paradigms.
@ -80,7 +80,7 @@
*Lowering the barrier to entry so anyone can deploy in minutes.*
* [**QuickGuide (Zero-Config Start)**](https://github.com/sipeed/picoclaw/issues/350)
* [**QuickGuide (Zero-Config Start)**](https://github.com/sipeed/piconomous/issues/350)
* Interactive CLI Wizard: If launched without config, automatically detect the environment and guide the user through Token/Network setup step-by-step.
@ -104,7 +104,7 @@
## 🎨 7. Brand & Community
* [**Logo Design**](https://github.com/sipeed/picoclaw/issues/297): We are looking for a **Mantis Shrimp (Stomatopoda)** logo design!
* [**Logo Design**](https://github.com/sipeed/piconomous/issues/297): We are looking for a **Mantis Shrimp (Stomatopoda)** logo design!
* *Concept*: Needs to reflect "Small but Mighty" and "Lightning Fast Strikes."

0
assets/picoclaw_code.gif → assets/piconomous_code.gif
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 1.5 MiB

After

Width:  |  Height:  |  Size: 1.5 MiB

0
assets/picoclaw_mem.gif → assets/piconomous_mem.gif
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 994 KiB

After

Width:  |  Height:  |  Size: 994 KiB

0
assets/picoclaw_memory.gif → assets/piconomous_memory.gif
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 4.2 MiB

After

Width:  |  Height:  |  Size: 4.2 MiB

0
assets/picoclaw_scedule.gif → assets/piconomous_scedule.gif
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 1.5 MiB

After

Width:  |  Height:  |  Size: 1.5 MiB

0
assets/picoclaw_search.gif → assets/piconomous_search.gif
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 830 KiB

After

Width:  |  Height:  |  Size: 830 KiB

16
cmd/picoclaw-launcher-tui/config/config.go → cmd/piconomous-launcher-tui/config/config.go
View file

@ -1,9 +1,9 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
// Package config provides types and I/O for ~/.picoclaw/tui.toml.
// Package config provides types and I/O for ~/.piconomous/tui.toml.
package config
import (
@ -15,7 +15,7 @@ import (
"github.com/BurntSushi/toml"
"github.com/sipeed/picoclaw/pkg/fileutil"
"github.com/sipeed/piconomous/pkg/fileutil"
)
// DefaultConfigPath returns the default path to the tui.toml config file.
@ -24,10 +24,10 @@ func DefaultConfigPath() string {
if err != nil {
home = "."
}
return filepath.Join(home, ".picoclaw", "tui.toml")
return filepath.Join(home, ".piconomous", "tui.toml")
}
// TUIConfig is the top-level structure of ~/.picoclaw/tui.toml.
// TUIConfig is the top-level structure of ~/.piconomous/tui.toml.
type TUIConfig struct {
Version string `toml:"version"`
Model Model `toml:"model"`
@ -151,7 +151,7 @@ func (p *Provider) UsersForScheme(schemeName string) []User {
return out
}
// SyncSelectedModelToMainConfig syncs the currently selected model to ~/.picoclaw/config.json
// SyncSelectedModelToMainConfig syncs the currently selected model to ~/.piconomous/config.json
// Adds/replaces a "tui-prefer" model entry and sets it as the default model.
// Preserves all other existing fields in the config file unchanged.
func SyncSelectedModelToMainConfig(scheme Scheme, user User, modelID string) error {
@ -159,7 +159,7 @@ func SyncSelectedModelToMainConfig(scheme Scheme, user User, modelID string) err
if err != nil {
home = "."
}
mainConfigPath := filepath.Join(home, ".picoclaw", "config.json")
mainConfigPath := filepath.Join(home, ".piconomous", "config.json")
var cfg map[string]any
if data, readErr := os.ReadFile(mainConfigPath); readErr == nil {

14
cmd/picoclaw-launcher-tui/main.go → cmd/piconomous-launcher-tui/main.go
View file

@ -1,7 +1,7 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package main
@ -11,8 +11,8 @@ import (
"os/exec"
"path/filepath"
tuicfg "github.com/sipeed/picoclaw/cmd/picoclaw-launcher-tui/config"
"github.com/sipeed/picoclaw/cmd/picoclaw-launcher-tui/ui"
tuicfg "github.com/sipeed/piconomous/cmd/piconomous-launcher-tui/config"
"github.com/sipeed/piconomous/cmd/piconomous-launcher-tui/ui"
)
func main() {
@ -23,7 +23,7 @@ func main() {
configDir := filepath.Dir(configPath)
if _, err := os.Stat(configDir); os.IsNotExist(err) {
cmd := exec.Command("picoclaw", "onboard")
cmd := exec.Command("piconomous", "onboard")
cmd.Stdin = os.Stdin
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
@ -32,7 +32,7 @@ func main() {
cfg, err := tuicfg.Load(configPath)
if err != nil {
fmt.Fprintf(os.Stderr, "picoclaw-launcher-tui: %v\n", err)
fmt.Fprintf(os.Stderr, "piconomous-launcher-tui: %v\n", err)
os.Exit(1)
}
@ -42,7 +42,7 @@ func main() {
_ = tuicfg.SyncSelectedModelToMainConfig(scheme, user, modelID)
}
if err := app.Run(); err != nil {
fmt.Fprintf(os.Stderr, "picoclaw-launcher-tui: %v\n", err)
fmt.Fprintf(os.Stderr, "piconomous-launcher-tui: %v\n", err)
os.Exit(1)
}
}

8
cmd/picoclaw-launcher-tui/ui/app.go → cmd/piconomous-launcher-tui/ui/app.go
View file

@ -1,7 +1,7 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package ui
@ -12,7 +12,7 @@ import (
"github.com/gdamore/tcell/v2"
"github.com/rivo/tview"
tuicfg "github.com/sipeed/picoclaw/cmd/picoclaw-launcher-tui/config"
tuicfg "github.com/sipeed/piconomous/cmd/piconomous-launcher-tui/config"
)
// App is the root TUI application.
@ -271,7 +271,7 @@ func (a *App) buildShell(pageID string, content tview.Primitive, hint string) tv
}
headerLeft := tview.NewTextView().
SetText(" [#ff00ff::b]///[#00f0ff] PICOCLAW LAUNCHER [#ff00ff]///").
SetText(" [#ff00ff::b]///[#00f0ff] PICONOMOUS LAUNCHER [#ff00ff]///").
SetDynamicColors(true).
SetBackgroundColor(tcell.NewHexColor(0x050510))

6
cmd/picoclaw-launcher-tui/ui/channels.go → cmd/piconomous-launcher-tui/ui/channels.go
View file

@ -1,7 +1,7 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package ui
@ -39,7 +39,7 @@ func (a *App) newChannelsPage() tview.Primitive {
if err != nil {
home = "."
}
configPath := filepath.Join(home, ".picoclaw", "config.json")
configPath := filepath.Join(home, ".piconomous", "config.json")
var cfg map[string]any
if data, err := os.ReadFile(configPath); err == nil {

12
cmd/picoclaw-launcher-tui/ui/gateway.go → cmd/piconomous-launcher-tui/ui/gateway.go
View file

@ -1,7 +1,7 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package ui
@ -31,7 +31,7 @@ func getPidPath() string {
if err != nil {
home = "."
}
return filepath.Join(home, ".picoclaw", pidFileName)
return filepath.Join(home, ".piconomous", pidFileName)
}
func isProcessRunning(pid int) bool {
@ -85,9 +85,9 @@ func startGateway() error {
var cmd *exec.Cmd
if runtime.GOOS == "windows" {
cmd = exec.Command("cmd", "/C", "start /B picoclaw gateway > NUL 2>&1")
cmd = exec.Command("cmd", "/C", "start /B piconomous gateway > NUL 2>&1")
} else {
cmd = exec.Command("sh", "-c", "nohup picoclaw gateway > /dev/null 2>&1 & echo $! > "+pidPath)
cmd = exec.Command("sh", "-c", "nohup piconomous gateway > /dev/null 2>&1 & echo $! > "+pidPath)
}
err := cmd.Start()
@ -102,7 +102,7 @@ func startGateway() error {
"wmic",
"process",
"where",
"name='picoclaw.exe' and commandline like '%gateway%'",
"name='piconomous.exe' and commandline like '%gateway%'",
"get",
"processid",
)

10
cmd/picoclaw-launcher-tui/ui/home.go → cmd/piconomous-launcher-tui/ui/home.go
View file

@ -1,7 +1,7 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package ui
@ -41,19 +41,19 @@ func (a *App) newHomePage() tview.Primitive {
a.navigateTo("channels", a.newChannelsPage())
},
)
list.AddItem("GATEWAY MANAGEMENT", "Manage PicoClaw gateway daemon", 'g', func() {
list.AddItem("GATEWAY MANAGEMENT", "Manage Piconomous gateway daemon", 'g', func() {
a.navigateTo("gateway", a.newGatewayPage())
})
list.AddItem("CHAT: Start AI agent chat", "Launch interactive chat session", 'c', func() {
a.tapp.Suspend(func() {
cmd := exec.Command("picoclaw", "agent")
cmd := exec.Command("piconomous", "agent")
cmd.Stdin = os.Stdin
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
_ = cmd.Run()
})
})
list.AddItem("QUIT SYSTEM", "Exit PicoClaw Launcher", 'q', func() { a.tapp.Stop() })
list.AddItem("QUIT SYSTEM", "Exit Piconomous Launcher", 'q', func() { a.tapp.Stop() })
if sel >= 0 && sel < list.GetItemCount() {
list.SetCurrentItem(sel)
}

6
cmd/picoclaw-launcher-tui/ui/models.go → cmd/piconomous-launcher-tui/ui/models.go
View file

@ -1,7 +1,7 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package ui
@ -16,7 +16,7 @@ import (
"github.com/gdamore/tcell/v2"
"github.com/rivo/tview"
tuicfg "github.com/sipeed/picoclaw/cmd/picoclaw-launcher-tui/config"
tuicfg "github.com/sipeed/piconomous/cmd/piconomous-launcher-tui/config"
)
type modelsAPIResponse struct {

6
cmd/picoclaw-launcher-tui/ui/schemes.go → cmd/piconomous-launcher-tui/ui/schemes.go
View file

@ -1,7 +1,7 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package ui
@ -11,7 +11,7 @@ import (
"github.com/gdamore/tcell/v2"
"github.com/rivo/tview"
tuicfg "github.com/sipeed/picoclaw/cmd/picoclaw-launcher-tui/config"
tuicfg "github.com/sipeed/piconomous/cmd/piconomous-launcher-tui/config"
)
func (a *App) newSchemesPage() tview.Primitive {

6
cmd/picoclaw-launcher-tui/ui/users.go → cmd/piconomous-launcher-tui/ui/users.go
View file

@ -1,7 +1,7 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package ui
@ -11,7 +11,7 @@ import (
"github.com/gdamore/tcell/v2"
"github.com/rivo/tview"
tuicfg "github.com/sipeed/picoclaw/cmd/picoclaw-launcher-tui/config"
tuicfg "github.com/sipeed/piconomous/cmd/piconomous-launcher-tui/config"
)
func (a *App) newUsersPage(schemeName string) tview.Primitive {

4
cmd/picoclaw/dns_noresolv.go → cmd/piconomous/dns_noresolv.go
View file

@ -17,8 +17,8 @@ func init() {
}
// 从环境变量获取 DNS server 列表，多个用 ; 隔开
// 例如: PICOCLAW_DNS_SERVER="8.8.8.8:53;1.1.1.1:53;223.5.5.5:53"
dnsEnv := os.Getenv("PICOCLAW_DNS_SERVER")
// 例如: PICONOMOUS_DNS_SERVER="8.8.8.8:53;1.1.1.1:53;223.5.5.5:53"
dnsEnv := os.Getenv("PICONOMOUS_DNS_SERVER")
if dnsEnv == "" {
dnsEnv = "8.8.8.8:53;1.1.1.1:53"
}

0
cmd/picoclaw/internal/agent/command.go → cmd/piconomous/internal/agent/command.go
View file

0
cmd/picoclaw/internal/agent/command_test.go → cmd/piconomous/internal/agent/command_test.go
View file

12
cmd/picoclaw/internal/agent/helpers.go → cmd/piconomous/internal/agent/helpers.go
View file

@ -11,11 +11,11 @@ import (
"github.com/ergochat/readline"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/agent"
"github.com/sipeed/picoclaw/pkg/bus"
"github.com/sipeed/picoclaw/pkg/logger"
"github.com/sipeed/picoclaw/pkg/providers"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/agent"
"github.com/sipeed/piconomous/pkg/bus"
"github.com/sipeed/piconomous/pkg/logger"
"github.com/sipeed/piconomous/pkg/providers"
)
func agentCmd(message, sessionKey, model string, debug bool) error {
@ -82,7 +82,7 @@ func interactiveMode(agentLoop *agent.AgentLoop, sessionKey string) {
rl, err := readline.NewEx(&readline.Config{
Prompt: prompt,
HistoryFile: filepath.Join(os.TempDir(), ".picoclaw_history"),
HistoryFile: filepath.Join(os.TempDir(), ".piconomous_history"),
HistoryLimit: 100,
InterruptPrompt: "^C",
EOFPrompt: "exit",

0
cmd/picoclaw/internal/auth/command.go → cmd/piconomous/internal/auth/command.go
View file

0
cmd/picoclaw/internal/auth/command_test.go → cmd/piconomous/internal/auth/command_test.go
View file

14
cmd/picoclaw/internal/auth/helpers.go → cmd/piconomous/internal/auth/helpers.go
View file

@ -10,10 +10,10 @@ import (
"strings"
"time"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/auth"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/picoclaw/pkg/providers"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/auth"
"github.com/sipeed/piconomous/pkg/config"
"github.com/sipeed/piconomous/pkg/providers"
)
const (
@ -162,7 +162,7 @@ func authLoginGoogleAntigravity() error {
fmt.Println("\n✓ Google Antigravity login successful!")
fmt.Println("Default model set to: gemini-flash")
fmt.Println("Try it: picoclaw agent -m \"Hello world\"")
fmt.Println("Try it: piconomous agent -m \"Hello world\"")
return nil
}
@ -412,7 +412,7 @@ func authStatusCmd() error {
if len(store.Credentials) == 0 {
fmt.Println("No authenticated providers.")
fmt.Println("Run: picoclaw auth login --provider <name>")
fmt.Println("Run: piconomous auth login --provider <name>")
return nil
}
@ -460,7 +460,7 @@ func authModelsCmd() error {
cred, err := auth.GetCredential("google-antigravity")
if err != nil || cred == nil {
return fmt.Errorf(
"not logged in to Google Antigravity.\nrun: picoclaw auth login --provider google-antigravity",
"not logged in to Google Antigravity.\nrun: piconomous auth login --provider google-antigravity",
)
}

0
cmd/picoclaw/internal/auth/login.go → cmd/piconomous/internal/auth/login.go
View file

0
cmd/picoclaw/internal/auth/login_test.go → cmd/piconomous/internal/auth/login_test.go
View file

0
cmd/picoclaw/internal/auth/logout.go → cmd/piconomous/internal/auth/logout.go
View file

0
cmd/picoclaw/internal/auth/logout_test.go → cmd/piconomous/internal/auth/logout_test.go
View file

0
cmd/picoclaw/internal/auth/models.go → cmd/piconomous/internal/auth/models.go
View file

0
cmd/picoclaw/internal/auth/models_test.go → cmd/piconomous/internal/auth/models_test.go
View file

0
cmd/picoclaw/internal/auth/status.go → cmd/piconomous/internal/auth/status.go
View file

0
cmd/picoclaw/internal/auth/status_test.go → cmd/piconomous/internal/auth/status_test.go
View file

2
cmd/picoclaw/internal/cron/add.go → cmd/piconomous/internal/cron/add.go
View file

@ -5,7 +5,7 @@ import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/pkg/cron"
"github.com/sipeed/piconomous/pkg/cron"
)
func newAddCommand(storePath func() string) *cobra.Command {

0
cmd/picoclaw/internal/cron/add_test.go → cmd/piconomous/internal/cron/add_test.go
View file

2
cmd/picoclaw/internal/cron/command.go → cmd/piconomous/internal/cron/command.go
View file

@ -6,7 +6,7 @@ import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
)
func NewCronCommand() *cobra.Command {

0
cmd/picoclaw/internal/cron/command_test.go → cmd/piconomous/internal/cron/command_test.go
View file

2
cmd/picoclaw/internal/cron/disable.go → cmd/piconomous/internal/cron/disable.go
View file

@ -7,7 +7,7 @@ func newDisableCommand(storePath func() string) *cobra.Command {
Use: "disable",
Short: "Disable a job",
Args: cobra.ExactArgs(1),
Example: `picoclaw cron disable 1`,
Example: `piconomous cron disable 1`,
RunE: func(_ *cobra.Command, args []string) error {
cronSetJobEnabled(storePath(), args[0], false)
return nil

0
cmd/picoclaw/internal/cron/disable_test.go → cmd/piconomous/internal/cron/disable_test.go
View file

2
cmd/picoclaw/internal/cron/enable.go → cmd/piconomous/internal/cron/enable.go
View file

@ -7,7 +7,7 @@ func newEnableCommand(storePath func() string) *cobra.Command {
Use: "enable",
Short: "Enable a job",
Args: cobra.ExactArgs(1),
Example: `picoclaw cron enable 1`,
Example: `piconomous cron enable 1`,
RunE: func(_ *cobra.Command, args []string) error {
cronSetJobEnabled(storePath(), args[0], true)
return nil

0
cmd/picoclaw/internal/cron/enable_test.go → cmd/piconomous/internal/cron/enable_test.go
View file

2
cmd/picoclaw/internal/cron/helpers.go → cmd/piconomous/internal/cron/helpers.go
View file

@ -4,7 +4,7 @@ import (
"fmt"
"time"
"github.com/sipeed/picoclaw/pkg/cron"
"github.com/sipeed/piconomous/pkg/cron"
)
func cronListCmd(storePath string) {

0
cmd/picoclaw/internal/cron/list.go → cmd/piconomous/internal/cron/list.go
View file

0
cmd/picoclaw/internal/cron/list_test.go → cmd/piconomous/internal/cron/list_test.go
View file

2
cmd/picoclaw/internal/cron/remove.go → cmd/piconomous/internal/cron/remove.go
View file

@ -7,7 +7,7 @@ func newRemoveCommand(storePath func() string) *cobra.Command {
Use: "remove",
Short: "Remove a job by ID",
Args: cobra.ExactArgs(1),
Example: `picoclaw cron remove 1`,
Example: `piconomous cron remove 1`,
RunE: func(_ *cobra.Command, args []string) error {
cronRemoveCmd(storePath(), args[0])
return nil

0
cmd/picoclaw/internal/cron/remove_test.go → cmd/piconomous/internal/cron/remove_test.go
View file

10
cmd/picoclaw/internal/gateway/command.go → cmd/piconomous/internal/gateway/command.go
View file

@ -5,10 +5,10 @@ import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/gateway"
"github.com/sipeed/picoclaw/pkg/logger"
"github.com/sipeed/picoclaw/pkg/utils"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/gateway"
"github.com/sipeed/piconomous/pkg/logger"
"github.com/sipeed/piconomous/pkg/utils"
)
func NewGatewayCommand() *cobra.Command {
@ -19,7 +19,7 @@ func NewGatewayCommand() *cobra.Command {
cmd := &cobra.Command{
Use: "gateway",
Aliases: []string{"g"},
Short: "Start picoclaw gateway",
Short: "Start piconomous gateway",
Args: cobra.NoArgs,
PreRunE: func(_ *cobra.Command, _ []string) error {
if noTruncate && !debug {

2
cmd/picoclaw/internal/gateway/command_test.go → cmd/piconomous/internal/gateway/command_test.go
View file

@ -13,7 +13,7 @@ func TestNewGatewayCommand(t *testing.T) {
require.NotNil(t, cmd)
assert.Equal(t, "gateway", cmd.Use)
assert.Equal(t, "Start picoclaw gateway", cmd.Short)
assert.Equal(t, "Start piconomous gateway", cmd.Short)
assert.Len(t, cmd.Aliases, 1)
assert.True(t, cmd.HasAlias("g"))

8
cmd/picoclaw/internal/helpers.go → cmd/piconomous/internal/helpers.go
View file

@ -4,19 +4,19 @@ import (
"os"
"path/filepath"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/piconomous/pkg/config"
)
const Logo = "🦞"
// GetPicoclawHome returns the picoclaw home directory.
// Priority: $PICOCLAW_HOME > ~/.picoclaw
// GetPicoclawHome returns the piconomous home directory.
// Priority: $PICONOMOUS_HOME > ~/.piconomous
func GetPicoclawHome() string {
if home := os.Getenv(config.EnvHome); home != "" {
return home
}
home, _ := os.UserHomeDir()
return filepath.Join(home, ".picoclaw")
return filepath.Join(home, ".piconomous")
}
func GetConfigPath() string {

16
cmd/picoclaw/internal/helpers_test.go → cmd/piconomous/internal/helpers_test.go
View file

@ -14,24 +14,24 @@ func TestGetConfigPath(t *testing.T) {
t.Setenv("HOME", "/tmp/home")
got := GetConfigPath()
want := filepath.Join("/tmp/home", ".picoclaw", "config.json")
want := filepath.Join("/tmp/home", ".piconomous", "config.json")
assert.Equal(t, want, got)
}
func TestGetConfigPath_WithPICOCLAW_HOME(t *testing.T) {
t.Setenv("PICOCLAW_HOME", "/custom/picoclaw")
func TestGetConfigPath_WithPICONOMOUS_HOME(t *testing.T) {
t.Setenv("PICONOMOUS_HOME", "/custom/piconomous")
t.Setenv("HOME", "/tmp/home")
got := GetConfigPath()
want := filepath.Join("/custom/picoclaw", "config.json")
want := filepath.Join("/custom/piconomous", "config.json")
assert.Equal(t, want, got)
}
func TestGetConfigPath_WithPICOCLAW_CONFIG(t *testing.T) {
t.Setenv("PICOCLAW_CONFIG", "/custom/config.json")
t.Setenv("PICOCLAW_HOME", "/custom/picoclaw")
func TestGetConfigPath_WithPICONOMOUS_CONFIG(t *testing.T) {
t.Setenv("PICONOMOUS_CONFIG", "/custom/config.json")
t.Setenv("PICONOMOUS_HOME", "/custom/piconomous")
t.Setenv("HOME", "/tmp/home")
got := GetConfigPath()
@ -49,7 +49,7 @@ func TestGetConfigPath_Windows(t *testing.T) {
t.Setenv("USERPROFILE", testUserProfilePath)
got := GetConfigPath()
want := filepath.Join(testUserProfilePath, ".picoclaw", "config.json")
want := filepath.Join(testUserProfilePath, ".piconomous", "config.json")
require.True(t, strings.EqualFold(got, want), "GetConfigPath() = %q, want %q", got, want)
}

16
cmd/picoclaw/internal/migrate/command.go → cmd/piconomous/internal/migrate/command.go
View file

@ -3,7 +3,7 @@ package migrate
import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/pkg/migrate"
"github.com/sipeed/piconomous/pkg/migrate"
)
func NewMigrateCommand() *cobra.Command {
@ -11,13 +11,13 @@ func NewMigrateCommand() *cobra.Command {
cmd := &cobra.Command{
Use: "migrate",
Short: "Migrate from xxxclaw(openclaw, etc.) to picoclaw",
Short: "Migrate from xxxclaw(openclaw, etc.) to piconomous",
Args: cobra.NoArgs,
Example: ` picoclaw migrate
picoclaw migrate --from openclaw
picoclaw migrate --dry-run
picoclaw migrate --refresh
picoclaw migrate --force`,
Example: ` piconomous migrate
piconomous migrate --from openclaw
piconomous migrate --dry-run
piconomous migrate --refresh
piconomous migrate --force`,
RunE: func(cmd *cobra.Command, _ []string) error {
m := migrate.NewMigrateInstance(opts)
result, err := m.Run(opts)
@ -46,7 +46,7 @@ func NewMigrateCommand() *cobra.Command {
cmd.Flags().StringVar(&opts.SourceHome, "source-home", "",
"Override source home directory (default: ~/.openclaw)")
cmd.Flags().StringVar(&opts.TargetHome, "target-home", "",
"Override target home directory (default: ~/.picoclaw)")
"Override target home directory (default: ~/.piconomous)")
return cmd
}

2
cmd/picoclaw/internal/migrate/command_test.go → cmd/piconomous/internal/migrate/command_test.go
View file

@ -13,7 +13,7 @@ func TestNewMigrateCommand(t *testing.T) {
require.NotNil(t, cmd)
assert.Equal(t, "migrate", cmd.Use)
assert.Equal(t, "Migrate from xxxclaw(openclaw, etc.) to picoclaw", cmd.Short)
assert.Equal(t, "Migrate from xxxclaw(openclaw, etc.) to piconomous", cmd.Short)
assert.Len(t, cmd.Aliases, 0)

12
cmd/picoclaw/internal/model/command.go → cmd/piconomous/internal/model/command.go
View file

@ -5,8 +5,8 @@ import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/config"
)
// LocalModel is a special model name that indicates that the model is local and with or without api_key.
@ -22,10 +22,10 @@ If no argument is provided, shows the current default model.
If a model name is provided, sets it as the default model.
Examples:
picoclaw model # Show current default model
picoclaw model gpt-5.2 # Set gpt-5.2 as default
picoclaw model claude-sonnet-4.6 # Set claude-sonnet-4.6 as default
picoclaw model local-model # Set local VLLM server as default
piconomous model # Show current default model
piconomous model gpt-5.2 # Set gpt-5.2 as default
piconomous model claude-sonnet-4.6 # Set claude-sonnet-4.6 as default
piconomous model local-model # Set local VLLM server as default
Note: 'local-model' is a special value for using a local VLLM server
(running at localhost:8000 by default) which does not require an API key.`,

4
cmd/picoclaw/internal/model/command_test.go → cmd/piconomous/internal/model/command_test.go
View file

@ -10,7 +10,7 @@ import (
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/piconomous/pkg/config"
)
var configPath = ""
@ -18,7 +18,7 @@ var configPath = ""
func initTest(t *testing.T) {
tmpDir := t.TempDir()
configPath = filepath.Join(tmpDir, "config.json")
_ = os.Setenv("PICOCLAW_CONFIG", configPath)
_ = os.Setenv("PICONOMOUS_CONFIG", configPath)
}
// captureStdout captures stdout during the execution of fn and returns the captured output

2
cmd/picoclaw/internal/onboard/command.go → cmd/piconomous/internal/onboard/command.go
View file

@ -16,7 +16,7 @@ func NewOnboardCommand() *cobra.Command {
cmd := &cobra.Command{
Use: "onboard",
Aliases: []string{"o"},
Short: "Initialize picoclaw configuration and workspace",
Short: "Initialize piconomous configuration and workspace",
Run: func(cmd *cobra.Command, args []string) {
onboard(encrypt)
},

2
cmd/picoclaw/internal/onboard/command_test.go → cmd/piconomous/internal/onboard/command_test.go
View file

@ -13,7 +13,7 @@ func TestNewOnboardCommand(t *testing.T) {
require.NotNil(t, cmd)
assert.Equal(t, "onboard", cmd.Use)
assert.Equal(t, "Initialize picoclaw configuration and workspace", cmd.Short)
assert.Equal(t, "Initialize piconomous configuration and workspace", cmd.Short)
assert.Len(t, cmd.Aliases, 1)
assert.True(t, cmd.HasAlias("o"))

18
cmd/picoclaw/internal/onboard/helpers.go → cmd/piconomous/internal/onboard/helpers.go
View file

@ -8,9 +8,9 @@ import (
"golang.org/x/term"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/picoclaw/pkg/credential"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/config"
"github.com/sipeed/piconomous/pkg/credential"
)
func onboard(encrypt bool) {
@ -79,12 +79,12 @@ func onboard(encrypt bool) {
workspace := cfg.WorkspacePath()
createWorkspaceTemplates(workspace)
fmt.Printf("\n%s picoclaw is ready!\n", internal.Logo)
fmt.Printf("\n%s piconomous is ready!\n", internal.Logo)
fmt.Println("\nNext steps:")
if encrypt {
fmt.Println(" 1. Set your encryption passphrase before starting picoclaw:")
fmt.Println(" export PICOCLAW_KEY_PASSPHRASE=<your-passphrase> # Linux/macOS")
fmt.Println(" set PICOCLAW_KEY_PASSPHRASE=<your-passphrase> # Windows cmd")
fmt.Println(" 1. Set your encryption passphrase before starting piconomous:")
fmt.Println(" export PICONOMOUS_KEY_PASSPHRASE=<your-passphrase> # Linux/macOS")
fmt.Println(" set PICONOMOUS_KEY_PASSPHRASE=<your-passphrase> # Windows cmd")
fmt.Println("")
fmt.Println(" 2. Add your API key to", configPath)
} else {
@ -97,7 +97,7 @@ func onboard(encrypt bool) {
fmt.Println("")
fmt.Println(" See README.md for 17+ supported providers.")
fmt.Println("")
fmt.Println(" 3. Chat: picoclaw agent -m \"Hello!\"")
fmt.Println(" 3. Chat: piconomous agent -m \"Hello!\"")
}
// promptPassphrase reads the encryption passphrase twice from the terminal
@ -127,7 +127,7 @@ func promptPassphrase() (string, error) {
return string(p1), nil
}
// setupSSHKey generates the picoclaw-specific SSH key at ~/.ssh/picoclaw_ed25519.key.
// setupSSHKey generates the piconomous-specific SSH key at ~/.ssh/piconomous_ed25519.key.
// If the key already exists the user is warned and asked to confirm overwrite.
// Answering anything other than "y" keeps the existing key (not an error).
func setupSSHKey() error {

0
cmd/picoclaw/internal/onboard/helpers_test.go → cmd/piconomous/internal/onboard/helpers_test.go
View file

6
cmd/picoclaw/internal/skills/command.go → cmd/piconomous/internal/skills/command.go
View file

@ -6,8 +6,8 @@ import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/skills"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/skills"
)
type deps struct {
@ -42,7 +42,7 @@ func NewSkillsCommand() *cobra.Command {
// get global config directory and builtin skills directory
globalDir := filepath.Dir(internal.GetConfigPath())
globalSkillsDir := filepath.Join(globalDir, "skills")
builtinSkillsDir := filepath.Join(globalDir, "picoclaw", "skills")
builtinSkillsDir := filepath.Join(globalDir, "piconomous", "skills")
d.skillsLoader = skills.NewSkillsLoader(d.workspace, globalSkillsDir, builtinSkillsDir)
return nil

0
cmd/picoclaw/internal/skills/command_test.go → cmd/piconomous/internal/skills/command_test.go
View file

12
cmd/picoclaw/internal/skills/helpers.go → cmd/piconomous/internal/skills/helpers.go
View file

@ -9,10 +9,10 @@ import (
"strings"
"time"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/picoclaw/pkg/skills"
"github.com/sipeed/picoclaw/pkg/utils"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/config"
"github.com/sipeed/piconomous/pkg/skills"
"github.com/sipeed/piconomous/pkg/utils"
)
const skillsSearchMaxResults = 20
@ -130,7 +130,7 @@ func skillsRemoveCmd(installer *skills.SkillInstaller, skillName string) {
}
func skillsInstallBuiltinCmd(workspace string) {
builtinSkillsDir := "./picoclaw/skills"
builtinSkillsDir := "./piconomous/skills"
workspaceSkillsDir := filepath.Join(workspace, "skills")
fmt.Printf("Copying builtin skills to workspace...\n")
@ -171,7 +171,7 @@ func skillsListBuiltinCmd() {
fmt.Printf("Error loading config: %v\n", err)
return
}
builtinSkillsDir := filepath.Join(filepath.Dir(cfg.WorkspacePath()), "picoclaw", "skills")
builtinSkillsDir := filepath.Join(filepath.Dir(cfg.WorkspacePath()), "piconomous", "skills")
fmt.Println("\nAvailable Builtin Skills:")
fmt.Println("-----------------------")

8
cmd/picoclaw/internal/skills/install.go → cmd/piconomous/internal/skills/install.go
View file

@ -5,8 +5,8 @@ import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/skills"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/skills"
)
func newInstallCommand(installerFn func() (*skills.SkillInstaller, error)) *cobra.Command {
@ -16,8 +16,8 @@ func newInstallCommand(installerFn func() (*skills.SkillInstaller, error)) *cobr
Use: "install",
Short: "Install skill from GitHub",
Example: `
picoclaw skills install sipeed/picoclaw-skills/weather
picoclaw skills install --registry clawhub github
piconomous skills install sipeed/piconomous-skills/weather
piconomous skills install --registry clawhub github
`,
Args: func(cmd *cobra.Command, args []string) error {
if registry != "" {

2
cmd/picoclaw/internal/skills/install_test.go → cmd/piconomous/internal/skills/install_test.go
View file

@ -37,7 +37,7 @@ func TestInstallCommandArgs(t *testing.T) {
}{
{
name: "no registry, one arg",
args: []string{"sipeed/picoclaw-skills/weather"},
args: []string{"sipeed/piconomous-skills/weather"},
registry: "",
expectError: false,
},

2
cmd/picoclaw/internal/skills/installbuiltin.go → cmd/piconomous/internal/skills/installbuiltin.go
View file

@ -6,7 +6,7 @@ func newInstallBuiltinCommand(workspaceFn func() (string, error)) *cobra.Command
cmd := &cobra.Command{
Use: "install-builtin",
Short: "Install all builtin skills to workspace",
Example: `picoclaw skills install-builtin`,
Example: `piconomous skills install-builtin`,
RunE: func(_ *cobra.Command, _ []string) error {
workspace, err := workspaceFn()
if err != nil {

0
cmd/picoclaw/internal/skills/installbuiltin_test.go → cmd/piconomous/internal/skills/installbuiltin_test.go
View file

4
cmd/picoclaw/internal/skills/list.go → cmd/piconomous/internal/skills/list.go
View file

@ -3,14 +3,14 @@ package skills
import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/pkg/skills"
"github.com/sipeed/piconomous/pkg/skills"
)
func newListCommand(loaderFn func() (*skills.SkillsLoader, error)) *cobra.Command {
cmd := &cobra.Command{
Use: "list",
Short: "List installed skills",
Example: `picoclaw skills list`,
Example: `piconomous skills list`,
RunE: func(_ *cobra.Command, _ []string) error {
loader, err := loaderFn()
if err != nil {

0
cmd/picoclaw/internal/skills/list_test.go → cmd/piconomous/internal/skills/list_test.go
View file

2
cmd/picoclaw/internal/skills/listbuiltin.go → cmd/piconomous/internal/skills/listbuiltin.go
View file

@ -6,7 +6,7 @@ func newListBuiltinCommand() *cobra.Command {
cmd := &cobra.Command{
Use: "list-builtin",
Short: "List available builtin skills",
Example: `picoclaw skills list-builtin`,
Example: `piconomous skills list-builtin`,
Run: func(_ *cobra.Command, _ []string) {
skillsListBuiltinCmd()
},

0
cmd/picoclaw/internal/skills/listbuiltin_test.go → cmd/piconomous/internal/skills/listbuiltin_test.go
View file

4
cmd/picoclaw/internal/skills/remove.go → cmd/piconomous/internal/skills/remove.go
View file

@ -3,7 +3,7 @@ package skills
import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/pkg/skills"
"github.com/sipeed/piconomous/pkg/skills"
)
func newRemoveCommand(installerFn func() (*skills.SkillInstaller, error)) *cobra.Command {
@ -12,7 +12,7 @@ func newRemoveCommand(installerFn func() (*skills.SkillInstaller, error)) *cobra
Aliases: []string{"rm", "uninstall"},
Short: "Remove installed skill",
Args: cobra.ExactArgs(1),
Example: `picoclaw skills remove weather`,
Example: `piconomous skills remove weather`,
RunE: func(_ *cobra.Command, args []string) error {
installer, err := installerFn()
if err != nil {

0
cmd/picoclaw/internal/skills/remove_test.go → cmd/piconomous/internal/skills/remove_test.go
View file

0
cmd/picoclaw/internal/skills/search.go → cmd/piconomous/internal/skills/search.go
View file

0
cmd/picoclaw/internal/skills/search_test.go → cmd/piconomous/internal/skills/search_test.go
View file

4
cmd/picoclaw/internal/skills/show.go → cmd/piconomous/internal/skills/show.go
View file

@ -3,7 +3,7 @@ package skills
import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/pkg/skills"
"github.com/sipeed/piconomous/pkg/skills"
)
func newShowCommand(loaderFn func() (*skills.SkillsLoader, error)) *cobra.Command {
@ -11,7 +11,7 @@ func newShowCommand(loaderFn func() (*skills.SkillsLoader, error)) *cobra.Comman
Use: "show",
Short: "Show skill details",
Args: cobra.ExactArgs(1),
Example: `picoclaw skills show weather`,
Example: `piconomous skills show weather`,
RunE: func(_ *cobra.Command, args []string) error {
loader, err := loaderFn()
if err != nil {

0
cmd/picoclaw/internal/skills/show_test.go → cmd/piconomous/internal/skills/show_test.go
View file

2
cmd/picoclaw/internal/status/command.go → cmd/piconomous/internal/status/command.go
View file

@ -8,7 +8,7 @@ func NewStatusCommand() *cobra.Command {
cmd := &cobra.Command{
Use: "status",
Aliases: []string{"s"},
Short: "Show picoclaw status",
Short: "Show piconomous status",
Run: func(cmd *cobra.Command, args []string) {
statusCmd()
},

2
cmd/picoclaw/internal/status/command_test.go → cmd/piconomous/internal/status/command_test.go
View file

@ -17,7 +17,7 @@ func TestNewStatusCommand(t *testing.T) {
assert.Len(t, cmd.Aliases, 1)
assert.True(t, cmd.HasAlias("s"))
assert.Equal(t, "Show picoclaw status", cmd.Short)
assert.Equal(t, "Show piconomous status", cmd.Short)
assert.False(t, cmd.HasSubCommands())

8
cmd/picoclaw/internal/status/helpers.go → cmd/piconomous/internal/status/helpers.go
View file

@ -4,9 +4,9 @@ import (
"fmt"
"os"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/auth"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/auth"
"github.com/sipeed/piconomous/pkg/config"
)
func statusCmd() {
@ -18,7 +18,7 @@ func statusCmd() {
configPath := internal.GetConfigPath()
fmt.Printf("%s picoclaw Status\n", internal.Logo)
fmt.Printf("%s piconomous Status\n", internal.Logo)
fmt.Printf("Version: %s\n", config.FormatVersion())
build, _ := config.FormatBuildInfo()
if build != "" {

6
cmd/picoclaw/internal/version/command.go → cmd/piconomous/internal/version/command.go
View file

@ -5,8 +5,8 @@ import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/config"
)
func NewVersionCommand() *cobra.Command {
@ -23,7 +23,7 @@ func NewVersionCommand() *cobra.Command {
}
func printVersion() {
fmt.Printf("%s picoclaw %s\n", internal.Logo, config.FormatVersion())
fmt.Printf("%s piconomous %s\n", internal.Logo, config.FormatVersion())
build, goVer := config.FormatBuildInfo()
if build != "" {
fmt.Printf(" Build: %s\n", build)

0
cmd/picoclaw/internal/version/command_test.go → cmd/piconomous/internal/version/command_test.go
View file

34
cmd/picoclaw/main.go → cmd/piconomous/main.go
View file

@ -1,8 +1,8 @@
// PicoClaw - Ultra-lightweight personal AI agent
// Piconomous - Ultra-lightweight personal AI agent
// Inspired by and based on nanobot: https://github.com/HKUDS/nanobot
// License: MIT
//
// Copyright (c) 2026 PicoClaw contributors
// Copyright (c) 2026 Piconomous contributors
package main
@ -12,27 +12,27 @@ import (
"github.com/spf13/cobra"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/agent"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/auth"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/cron"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/gateway"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/migrate"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/model"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/onboard"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/skills"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/status"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal/version"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/cmd/piconomous/internal/agent"
"github.com/sipeed/piconomous/cmd/piconomous/internal/auth"
"github.com/sipeed/piconomous/cmd/piconomous/internal/cron"
"github.com/sipeed/piconomous/cmd/piconomous/internal/gateway"
"github.com/sipeed/piconomous/cmd/piconomous/internal/migrate"
"github.com/sipeed/piconomous/cmd/piconomous/internal/model"
"github.com/sipeed/piconomous/cmd/piconomous/internal/onboard"
"github.com/sipeed/piconomous/cmd/piconomous/internal/skills"
"github.com/sipeed/piconomous/cmd/piconomous/internal/status"
"github.com/sipeed/piconomous/cmd/piconomous/internal/version"
"github.com/sipeed/piconomous/pkg/config"
)
func NewPicoclawCommand() *cobra.Command {
short := fmt.Sprintf("%s picoclaw - Personal AI Assistant v%s\n\n", internal.Logo, config.GetVersion())
short := fmt.Sprintf("%s piconomous - Personal AI Assistant v%s\n\n", internal.Logo, config.GetVersion())
cmd := &cobra.Command{
Use: "picoclaw",
Use: "piconomous",
Short: short,
Example: "picoclaw version",
Example: "piconomous version",
}
cmd.AddCommand(

8
cmd/picoclaw/main_test.go → cmd/piconomous/main_test.go
View file

@ -8,8 +8,8 @@ import (
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
"github.com/sipeed/picoclaw/cmd/picoclaw/internal"
"github.com/sipeed/picoclaw/pkg/config"
"github.com/sipeed/piconomous/cmd/piconomous/internal"
"github.com/sipeed/piconomous/pkg/config"
)
func TestNewPicoclawCommand(t *testing.T) {
@ -17,9 +17,9 @@ func TestNewPicoclawCommand(t *testing.T) {
require.NotNil(t, cmd)
short := fmt.Sprintf("%s picoclaw - Personal AI Assistant v%s\n\n", internal.Logo, config.GetVersion())
short := fmt.Sprintf("%s piconomous - Personal AI Assistant v%s\n\n", internal.Logo, config.GetVersion())
assert.Equal(t, "picoclaw", cmd.Use)
assert.Equal(t, "piconomous", cmd.Use)
assert.Equal(t, short, cmd.Short)
assert.True(t, cmd.HasSubCommands())

2
config/config.example.json
View file

@ -1,7 +1,7 @@
{
"agents": {
"defaults": {
"workspace": "~/.picoclaw/workspace",
"workspace": "~/.piconomous/workspace",
"restrict_to_workspace": true,
"model_name": "gpt-5.4",
"max_tokens": 8192,

32
docker/docker-compose.full.yml
View file

@ -1,44 +1,44 @@
services:
# ─────────────────────────────────────────────
# PicoClaw Agent (one-shot query) - Full MCP Support
# docker compose -f docker/docker-compose.full.yml run --rm picoclaw-agent -m "Hello"
# Piconomous Agent (one-shot query) - Full MCP Support
# docker compose -f docker/docker-compose.full.yml run --rm piconomous-agent -m "Hello"
# ─────────────────────────────────────────────
picoclaw-agent:
piconomous-agent:
build:
context: ..
dockerfile: docker/Dockerfile.full
container_name: picoclaw-agent-full
container_name: piconomous-agent-full
profiles:
- agent
volumes:
- ../config/config.json:/root/.picoclaw/config.json:ro
- picoclaw-workspace:/root/.picoclaw/workspace
- picoclaw-npm-cache:/root/.npm # npm cache for faster MCP server installs
entrypoint: ["picoclaw", "agent"]
- ../config/config.json:/root/.piconomous/config.json:ro
- piconomous-workspace:/root/.piconomous/workspace
- piconomous-npm-cache:/root/.npm # npm cache for faster MCP server installs
entrypoint: ["piconomous", "agent"]
stdin_open: true
tty: true
# ─────────────────────────────────────────────
# PicoClaw Gateway (Long-running Bot) - Full MCP Support
# Piconomous Gateway (Long-running Bot) - Full MCP Support
# docker compose -f docker/docker-compose.full.yml --profile gateway up
# ─────────────────────────────────────────────
picoclaw-gateway:
piconomous-gateway:
build:
context: ..
dockerfile: docker/Dockerfile.full
container_name: picoclaw-gateway-full
container_name: piconomous-gateway-full
restart: unless-stopped
profiles:
- gateway
volumes:
# Configuration file
- ../config/config.json:/root/.picoclaw/config.json:ro
- ../config/config.json:/root/.piconomous/config.json:ro
# Persistent workspace (sessions, memory, logs)
- picoclaw-workspace:/root/.picoclaw/workspace
- piconomous-workspace:/root/.piconomous/workspace
# NPM cache for faster MCP server installs
- picoclaw-npm-cache:/root/.npm
- piconomous-npm-cache:/root/.npm
command: ["gateway"]
volumes:
picoclaw-workspace:
picoclaw-npm-cache: # Cache npm packages to speed up MCP server installations
piconomous-workspace:
piconomous-npm-cache: # Cache npm packages to speed up MCP server installations

36
docker/docker-compose.yml
View file

@ -1,29 +1,29 @@
services:
# ─────────────────────────────────────────────
# PicoClaw Agent (one-shot query)
# docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "Hello"
# Piconomous Agent (one-shot query)
# docker compose -f docker/docker-compose.yml run --rm piconomous-agent -m "Hello"
# ─────────────────────────────────────────────
picoclaw-agent:
image: docker.io/sipeed/picoclaw:latest
container_name: picoclaw-agent
piconomous-agent:
image: docker.io/sipeed/piconomous:latest
container_name: piconomous-agent
profiles:
- agent
# Uncomment to access host network; leave commented unless needed.
#extra_hosts:
# - "host.docker.internal:host-gateway"
volumes:
- ./data:/root/.picoclaw
entrypoint: ["picoclaw", "agent"]
- ./data:/root/.piconomous
entrypoint: ["piconomous", "agent"]
stdin_open: true
tty: true
# ─────────────────────────────────────────────
# PicoClaw Gateway (Long-running Bot)
# Piconomous Gateway (Long-running Bot)
# docker compose -f docker/docker-compose.yml --profile gateway up
# ─────────────────────────────────────────────
picoclaw-gateway:
image: docker.io/sipeed/picoclaw:latest
container_name: picoclaw-gateway
piconomous-gateway:
image: docker.io/sipeed/piconomous:latest
container_name: piconomous-gateway
restart: on-failure
profiles:
- gateway
@ -31,22 +31,22 @@ services:
#extra_hosts:
# - "host.docker.internal:host-gateway"
volumes:
- ./data:/root/.picoclaw
- ./data:/root/.piconomous
# ─────────────────────────────────────────────
# PicoClaw Launcher (Web Console + Gateway)
# Piconomous Launcher (Web Console + Gateway)
# docker compose -f docker/docker-compose.yml --profile launcher up
# ─────────────────────────────────────────────
picoclaw-launcher:
image: docker.io/sipeed/picoclaw:launcher
container_name: picoclaw-launcher
piconomous-launcher:
image: docker.io/sipeed/piconomous:launcher
container_name: piconomous-launcher
restart: on-failure
profiles:
- launcher
environment:
- PICOCLAW_GATEWAY_HOST=0.0.0.0
- PICONOMOUS_GATEWAY_HOST=0.0.0.0
ports:
- "127.0.0.1:18800:18800"
- "127.0.0.1:18790:18790"
volumes:
- ./data:/root/.picoclaw
- ./data:/root/.piconomous

8
docker/entrypoint.sh
View file

@ -4,12 +4,12 @@ set -e
# First-run: neither config nor workspace exists.
# If config.json is already mounted but workspace is missing we skip onboard to
# avoid the interactive "Overwrite? (y/n)" prompt hanging in a non-TTY container.
if [ ! -d "${HOME}/.picoclaw/workspace" ] && [ ! -f "${HOME}/.picoclaw/config.json" ]; then
picoclaw onboard
if [ ! -d "${HOME}/.piconomous/workspace" ] && [ ! -f "${HOME}/.piconomous/config.json" ]; then
piconomous onboard
echo ""
echo "First-run setup complete."
echo "Edit ${HOME}/.picoclaw/config.json (add your API key, etc.) then restart the container."
echo "Edit ${HOME}/.piconomous/config.json (add your API key, etc.) then restart the container."
exit 0
fi
exec picoclaw gateway "$@"
exec piconomous gateway "$@"

42
docs/ANTIGRAVITY_AUTH.md
View file

@ -2,7 +2,7 @@
## Overview
**Antigravity** (Google Cloud Code Assist) is a Google-backed AI model provider that offers access to models like Claude Opus 4.6 and Gemini through Google's Cloud infrastructure. This document provides a complete guide on how authentication works, how to fetch models, and how to implement a new provider in PicoClaw.
**Antigravity** (Google Cloud Code Assist) is a Google-backed AI model provider that offers access to models like Claude Opus 4.6 and Gemini through Google's Cloud infrastructure. This document provides a complete guide on how authentication works, how to fetch models, and how to implement a new provider in Piconomous.
---
@ -17,7 +17,7 @@
7. [Integration Requirements](#integration-requirements)
8. [API Endpoints](#api-endpoints)
9. [Configuration](#configuration)
10. [Creating a New Provider in PicoClaw](#creating-a-new-provider-in-picoclaw)
10. [Creating a New Provider in Piconomous](#creating-a-new-provider-in-piconomous)
---
@ -378,7 +378,7 @@ const antigravityPlugin = {
description: "OAuth flow for Google Antigravity (Cloud Code Assist)",
configSchema: emptyPluginConfigSchema(),
register(api: PicoClawPluginApi) {
register(api: PiconomousPluginApi) {
api.registerProvider({
id: "google-antigravity",
label: "Google Antigravity",
@ -405,7 +405,7 @@ const antigravityPlugin = {
```typescript
type ProviderAuthContext = {
config: PicoClawConfig;
config: PiconomousConfig;
agentDir?: string;
workspaceDir?: string;
prompter: WizardPrompter; // UI prompts/notifications
@ -426,7 +426,7 @@ type ProviderAuthResult = {
profileId: string;
credential: AuthProfileCredential;
}>;
configPatch?: Partial<PicoClawConfig>;
configPatch?: Partial<PiconomousConfig>;
defaultModel?: string;
notes?: string[];
};
@ -439,7 +439,7 @@ type ProviderAuthResult = {
### 1. Required Environment/Dependencies
- Go ≥ 1.25
- PicoClaw codebase (`pkg/providers/` and `pkg/auth/`)
- Piconomous codebase (`pkg/providers/` and `pkg/auth/`)
- `crypto` and `net/http` standard library packages
### 2. Required Headers for API Calls
@ -592,7 +592,7 @@ Each SSE message (`data: {...}`) is wrapped in a `response` field:
### Auth Profile Storage
Auth profiles are stored in `~/.picoclaw/auth.json`:
Auth profiles are stored in `~/.piconomous/auth.json`:
```json
{
@ -612,9 +612,9 @@ Auth profiles are stored in `~/.picoclaw/auth.json`:
---
## Creating a New Provider in PicoClaw
## Creating a New Provider in Piconomous
PicoClaw providers are implemented as Go packages under `pkg/providers/`. To add a new provider:
Piconomous providers are implemented as Go packages under `pkg/providers/`. To add a new provider:
### Step-by-Step Implementation
@ -674,7 +674,7 @@ Add a default entry in `pkg/config/defaults.go`:
#### 5. Add Auth Support (Optional)
If your provider requires OAuth or special authentication, add a case to `cmd/picoclaw/internal/auth/helpers.go`:
If your provider requires OAuth or special authentication, add a case to `cmd/piconomous/internal/auth/helpers.go`:
```go
case "your-provider":
@ -704,26 +704,26 @@ case "your-provider":
```bash
# Authenticate with a provider
picoclaw auth login --provider your-provider
piconomous auth login --provider your-provider
# List models (for Antigravity)
picoclaw auth models
piconomous auth models
# Start the gateway
picoclaw gateway
piconomous gateway
# Run an agent with a specific model
picoclaw agent -m "Hello" --model your-model
piconomous agent -m "Hello" --model your-model
```
### Environment Variables for Testing
```bash
# Override default model
export PICOCLAW_AGENTS_DEFAULTS_MODEL=your-model
export PICONOMOUS_AGENTS_DEFAULTS_MODEL=your-model
# Override provider settings
export PICOCLAW_MODEL_LIST='[{"model_name":"your-model","model":"your-provider/model-name","api_key":"..."}]'
export PICONOMOUS_MODEL_LIST='[{"model_name":"your-model","model":"your-provider/model-name","api_key":"..."}]'
```
---
@ -733,10 +733,10 @@ export PICOCLAW_MODEL_LIST='[{"model_name":"your-model","model":"your-provider/m
- **Source Files:**
- `pkg/providers/antigravity_provider.go` - Antigravity provider implementation
- `pkg/auth/oauth.go` - OAuth flow implementation
- `pkg/auth/store.go` - Auth credential storage (`~/.picoclaw/auth.json`)
- `pkg/auth/store.go` - Auth credential storage (`~/.piconomous/auth.json`)
- `pkg/providers/factory.go` - Provider factory and protocol routing
- `pkg/providers/types.go` - Provider interface definitions
- `cmd/picoclaw/internal/auth/helpers.go` - Auth CLI commands
- `cmd/piconomous/internal/auth/helpers.go` - Auth CLI commands
- **Documentation:**
- `docs/ANTIGRAVITY_USAGE.md` - Antigravity usage guide
@ -792,7 +792,7 @@ Some models might show up in the available models list but return an empty respo
## Troubleshooting
### "Token expired"
- Refresh OAuth tokens: `picoclaw auth login --provider antigravity`
- Refresh OAuth tokens: `piconomous auth login --provider antigravity`
### "Gemini for Google Cloud is not enabled"
- Enable the API in your Google Cloud Console
@ -803,5 +803,5 @@ Some models might show up in the available models list but return an empty respo
### Models not appearing in list
- Verify OAuth authentication completed successfully
- Check auth profile storage: `~/.picoclaw/auth.json`
- Re-run `picoclaw auth login --provider antigravity`
- Check auth profile storage: `~/.piconomous/auth.json`
- Re-run `piconomous auth login --provider antigravity`

24
docs/ANTIGRAVITY_USAGE.md
View file

@ -1,6 +1,6 @@
# Using Antigravity Provider in PicoClaw
# Using Antigravity Provider in Piconomous
This guide explains how to set up and use the **Antigravity** (Google Cloud Code Assist) provider in PicoClaw.
This guide explains how to set up and use the **Antigravity** (Google Cloud Code Assist) provider in Piconomous.
## Prerequisites
@ -12,7 +12,7 @@ This guide explains how to set up and use the **Antigravity** (Google Cloud Code
To authenticate with Antigravity, run the following command:
```bash
picoclaw auth login --provider antigravity
piconomous auth login --provider antigravity
```
### Manual Authentication (Headless/VPS)
@ -22,9 +22,9 @@ If you are running on a server (Coolify/Docker) and cannot reach `localhost`, fo
3. Complete the login.
4. Your browser will redirect to a `localhost:51121` URL (which will fail to load).
5. **Copy that final URL** from your browser's address bar.
6. **Paste it back into the terminal** where PicoClaw is waiting.
6. **Paste it back into the terminal** where Piconomous is waiting.
PicoClaw will extract the authorization code and complete the process automatically.
Piconomous will extract the authorization code and complete the process automatically.
## 2. Managing Models
@ -32,15 +32,15 @@ PicoClaw will extract the authorization code and complete the process automatica
To see which models your project has access to and check their quotas:
```bash
picoclaw auth models
piconomous auth models
```
### Switch Models
You can change the default model in `~/.picoclaw/config.json` or override it via the CLI:
You can change the default model in `~/.piconomous/config.json` or override it via the CLI:
```bash
# Override for a single command
picoclaw agent -m "Hello" --model claude-opus-4-6-thinking
piconomous agent -m "Hello" --model claude-opus-4-6-thinking
```
## 3. Real-world Usage (Coolify/Docker)
@ -48,19 +48,19 @@ picoclaw agent -m "Hello" --model claude-opus-4-6-thinking
If you are deploying via Coolify or Docker, follow these steps to test:
1. **Environment Variables**:
* `PICOCLAW_AGENTS_DEFAULTS_MODEL=gemini-flash`
* `PICONOMOUS_AGENTS_DEFAULTS_MODEL=gemini-flash`
2. **Authentication persistence**:
If you've logged in locally, you can copy your credentials to the server:
```bash
scp ~/.picoclaw/auth.json user@your-server:~/.picoclaw/
scp ~/.piconomous/auth.json user@your-server:~/.piconomous/
```
*Alternatively*, run the `auth login` command once on the server if you have terminal access.
## 4. Troubleshooting
* **Empty Response**: If a model returns an empty reply, it may be restricted for your project. Try `gemini-3-flash` or `claude-opus-4-6-thinking`.
* **429 Rate Limit**: Antigravity has strict quotas. PicoClaw will display the "reset time" in the error message if you hit a limit.
* **404 Not Found**: Ensure you are using a model ID from the `picoclaw auth models` list. Use the short ID (e.g., `gemini-3-flash`) not the full path.
* **429 Rate Limit**: Antigravity has strict quotas. Piconomous will display the "reset time" in the error message if you hit a limit.
* **404 Not Found**: Ensure you are using a model ID from the `piconomous auth models` list. Use the short ID (e.g., `gemini-3-flash`) not the full path.
## 5. Summary of Working Models

Some files were not shown because too many files have changed in this diff Show more