docs: add Vietnamese README (README.vi.md) by quybquang · Pull Request #337 · sipeed/picoclaw

quybquang · 2026-02-17T02:21:55Z

Summary

Add Vietnamese translation of README.md for the Vietnamese developer community.

Changes

[NEW] README.vi.md — Full Vietnamese translation
[MODIFIED] README.md — Add Tiếng Việt to language selector
[MODIFIED] README.zh.md — Add Tiếng Việt to language selector
[MODIFIED] README.ja.md — Add Tiếng Việt to language selector

Notes

Follows the same structure and format as README.zh.md and README.ja.md
All sections translated: Features, Install, Docker, Quick Start, Chat Apps, Configuration, Security Sandbox, Heartbeat, Providers, CLI Reference, Troubleshooting

- Add full Vietnamese translation of README.md - Update language selector links in README.md, README.zh.md, README.ja.md

Leeaandrob · 2026-02-17T16:13:10Z

@quybquang look the conflicts please

Leeaandrob

PR Review: docs: add Vietnamese README (README.vi.md)

Verdict: APPROVE ✅

@quybquang — Excellent work on this Vietnamese translation. The PR adds a comprehensive 859-line README.vi.md and updates navigation links across all existing READMEs. Here's my detailed analysis:

Findings

[MEDIUM] README.ja.md — Missing Chinese (`中文`) link (merge conflict with #327)

File: README.ja.md:15

Before (main):

**日本語** | [English](README.md)

After (this PR):

**日本語** | [Tiếng Việt](README.vi.md) | [English](README.md)

Expected:

**日本語** | [中文](README.zh.md) | [Tiếng Việt](README.vi.md) | [English](README.md)

The Chinese link was already missing before this PR (pre-existing issue), so this is not a regression. However, since you're already modifying this line, it would be ideal to include [中文](README.zh.md) for completeness.

Important: PR #327 is an open PR that specifically adds the missing Chinese link to README.ja.md. These two PRs modify the exact same line and will create a merge conflict. Whichever merges first will cause the other to need a rebase. I recommend coordinating with the maintainers on merge order, or proactively adding the Chinese link here to subsume #327's change.

Current nav link matrix:

README	中文	日本語	Tiếng Việt	English
README.md	✅	✅	✅	bold
README.zh.md	bold	✅	✅	✅
README.ja.md	❌	bold	✅	✅
README.vi.md	✅	✅	bold	✅

[LOW] `glm-4.7` model reference in Quick Start (line 199)

The Quick Start config example uses "model": "glm-4.7". This faithfully reproduces the English README source, so it's not a translation error. However, glm-4.7 is being discussed for replacement in PR #209. Once the source README is updated, this file will need updating too. Not blocking.

[POSITIVE] Translation quality

The Vietnamese translation is comprehensive and well-executed:

All sections from the English README are present and accurately translated
Technical terms are appropriately handled (kept in English or with Vietnamese context)
Code blocks, JSON configs, CLI commands, and tables are perfectly preserved
All links (GitHub, external services, API providers) are intact
The security caution block is accurately translated with appropriate urgency
The 皮皮虾，我们走！ slogan is correctly preserved (cultural element)

[POSITIVE] Navigation link updates

README.md and README.zh.md navigation links are correctly updated to include [Tiếng Việt](README.vi.md). The new README.vi.md itself has all 4 languages properly linked.

Summary

Severity	Count	Details
CRITICAL	0	—
HIGH	0	—
MEDIUM	1	Missing `[中文]` link in README.ja.md (pre-existing, conflicts with #327)
LOW	1	`glm-4.7` model reference (matches source, not blocking)
POSITIVE	2	Excellent translation quality, proper nav link updates

Approving because this is a high-quality docs contribution. The Japanese README's missing Chinese link is a pre-existing issue that should be resolved (ideally in this PR to avoid the #327 conflict), but it's not a blocker for merge.

Suggested fix for README.ja.md:15:

**日本語** | [中文](README.zh.md) | [Tiếng Việt](README.vi.md) | [English](README.md)

Great contribution to the project's internationalization! 🦐

Leeaandrob · 2026-02-17T16:13:24Z

README.ja.md

 <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
 </p>

-**日本語** | [English](README.md)


[MEDIUM] Missing Chinese link — merge conflict with PR #327

This line is missing [中文](README.zh.md). Since you're already modifying this line, consider adding it:

Suggested change

**日本語** | [English](README.md)

**日本語** | [中文](README.zh.md) | [Tiếng Việt](README.vi.md) | [English](README.md)

PR #327 is open and modifies this exact same line to add the Chinese link. These will conflict on merge.

Leeaandrob · 2026-02-17T16:15:19Z

@quybquang take look

quybquang · 2026-02-17T16:22:05Z

@quybquang take look

ok bro

Leeaandrob · 2026-02-17T16:44:11Z

@quybquang we have conflict now. Please take look into it

Copilot

Pull request overview

Adds Vietnamese documentation support by introducing a full Vietnamese README translation and linking it from existing README language selectors.

Changes:

Add a new Vietnamese README (README.vi.md) with a full translation of project documentation.
Update language selector links in README.md, README.zh.md, and README.ja.md to include Vietnamese.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
README.md	Adds Vietnamese link to the language selector.
README.zh.md	Adds Vietnamese link to the language selector.
README.ja.md	Adds Vietnamese link to the language selector.
README.vi.md	New Vietnamese translation of the README content.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-17T16:49:38Z

README.vi.md

+    "discord": {
+      "enabled": true,
+      "token": "YOUR_BOT_TOKEN",
+      "allowFrom": ["YOUR_USER_ID"]


Trong snippet cấu hình Discord, key allowFrom không khớp với schema cấu hình thực tế (allow_from). Nên đổi thành allow_from để JSON unmarshal đúng.

Suggested change

"allowFrom": ["YOUR_USER_ID"]

"allow_from": ["YOUR_USER_ID"]

Copilot · 2026-02-17T16:49:39Z

README.vi.md

+| Nhà cung cấp | Mục đích | Lấy API Key |
+| --- | --- | --- |
+| `gemini` | LLM (Gemini trực tiếp) | [aistudio.google.com](https://aistudio.google.com) |
+| `zhipu` | LLM (Zhipu trực tiếp) | [bigmodel.cn](bigmodel.cn) |


Link [bigmodel.cn](bigmodel.cn) sẽ được GitHub hiểu như một relative link và bị hỏng. Nên dùng URL đầy đủ (ví dụ https://bigmodel.cn/...) để người đọc truy cập được.

Suggested change

| `zhipu` | LLM (Zhipu trực tiếp) | [bigmodel.cn](bigmodel.cn) |

| `zhipu` | LLM (Zhipu trực tiếp) | [bigmodel.cn](https://bigmodel.cn) |

Copilot · 2026-02-17T16:49:39Z

README.vi.md

+    "telegram": {
+      "enabled": true,
+      "token": "YOUR_BOT_TOKEN",
+      "allowFrom": ["YOUR_USER_ID"]


Trong snippet cấu hình Telegram, key allowFrom sẽ không được LoadConfig parse (schema dùng allow_from theo config/config.example.json và tag JSON trong pkg/config/config.go). Nên đổi allowFrom → allow_from để người dùng copy/paste hoạt động ngay.

Suggested change

"allowFrom": ["YOUR_USER_ID"]

"allow_from": ["YOUR_USER_ID"]

quybquang · 2026-02-17T16:53:50Z

@Leeaandrob I have resolved the conflict in README.ja.md as suggested. Please take another look! Thanks.

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-17T17:09:59Z

README.vi.md

+
+## 📢 Tin tức
+
+2026-02-16 🎉 PicoClaw đạt 12K stars chỉ trong một tuần! Cảm ơn tất cả mọi người! PicoClaw đang phát triển nhanh hơn chúng tôi tưởng tượng. Do số lượng PR tăng cao, chúng tôi cấp thiết cần maintainer từ cộng đồng. Các vai trò tình nguyện viên và roadmap đã được công bố [tại đây](doc/picoclaw_community_roadmap_260216.md) — rất mong đón nhận sự tham gia của bạn!


The path to the community roadmap document is incorrect. It should be docs/picoclaw_community_roadmap_260216.md (with 'docs' plural) instead of doc/picoclaw_community_roadmap_260216.md (with 'doc' singular). The correct path can be verified in the English README (line 52) and the actual file exists at docs/picoclaw_community_roadmap_260216.md.

Suggested change

2026-02-16 🎉 PicoClaw đạt 12K stars chỉ trong một tuần! Cảm ơn tất cả mọi người! PicoClaw đang phát triển nhanh hơn chúng tôi tưởng tượng. Do số lượng PR tăng cao, chúng tôi cấp thiết cần maintainer từ cộng đồng. Các vai trò tình nguyện viên và roadmap đã được công bố [tại đây](doc/picoclaw_community_roadmap_260216.md) — rất mong đón nhận sự tham gia của bạn!

2026-02-16 🎉 PicoClaw đạt 12K stars chỉ trong một tuần! Cảm ơn tất cả mọi người! PicoClaw đang phát triển nhanh hơn chúng tôi tưởng tượng. Do số lượng PR tăng cao, chúng tôi cấp thiết cần maintainer từ cộng đồng. Các vai trò tình nguyện viên và roadmap đã được công bố [tại đây](docs/picoclaw_community_roadmap_260216.md) — rất mong đón nhận sự tham gia của bạn!

Copilot · 2026-02-17T17:10:00Z

README.vi.md

+    <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>
+  </p>
+
+ [中文](README.zh.md) | [日本語](README.ja.md) | [English](README.md) | **Tiếng Việt**


Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-17T17:21:26Z

README.md

    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
-      "allowFrom": ["YOUR_USER_ID"]
+      "allow_from": ["YOUR_USER_ID"]
    }


The PR description only mentions adding the Vietnamese language link, but this hunk also changes the documented config key from allowFrom to allow_from in JSON examples. Please update the PR summary/description (or add a note in the README change list) so reviewers/users understand this additional documentation change.

I agree with that json standard are snake case. @quybquang

docs: add Vietnamese README (README.vi.md)

75fb728

- Add full Vietnamese translation of README.md - Update language selector links in README.md, README.zh.md, README.ja.md

Leeaandrob approved these changes Feb 17, 2026

View reviewed changes

docs: resolve conflict in README.ja.md

b833048

quybquang requested review from Leeaandrob and Copilot February 17, 2026 16:40

Merge branch 'main' into docs/add-vietnamese-readme

2ee2858

Copilot started reviewing on behalf of quybquang February 17, 2026 16:46 View session

Copilot AI reviewed Feb 17, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings February 17, 2026 17:05

quybquang force-pushed the docs/add-vietnamese-readme branch from bbe9462 to 7180a23 Compare February 17, 2026 17:05

Copilot started reviewing on behalf of quybquang February 17, 2026 17:05 View session

Copilot AI reviewed Feb 17, 2026

View reviewed changes

quybquang force-pushed the docs/add-vietnamese-readme branch from 7180a23 to bf5fcbb Compare February 17, 2026 17:14

docs: fix allow_from typo in config examples

8428446

Copilot AI review requested due to automatic review settings February 17, 2026 17:17

quybquang force-pushed the docs/add-vietnamese-readme branch from bf5fcbb to 8428446 Compare February 17, 2026 17:17

Copilot started reviewing on behalf of quybquang February 17, 2026 17:18 View session

Copilot AI reviewed Feb 17, 2026

View reviewed changes

Leeaandrob mentioned this pull request Feb 17, 2026

docs: add Brazilian Portuguese README (README.pt-br.md) #385

Merged

3 tasks

	日本語 \| [English](README.md)
	日本語 \| [中文](README.zh.md) \| [Tiếng Việt](README.vi.md) \| [English](README.md)

	\| `zhipu` \| LLM (Zhipu trực tiếp) \| [bigmodel.cn](bigmodel.cn) \|
	\| `zhipu` \| LLM (Zhipu trực tiếp) \| [bigmodel.cn](https://bigmodel.cn) \|


		## 📢 Tin tức

		2026-02-16 🎉 PicoClaw đạt 12K stars chỉ trong một tuần! Cảm ơn tất cả mọi người! PicoClaw đang phát triển nhanh hơn chúng tôi tưởng tượng. Do số lượng PR tăng cao, chúng tôi cấp thiết cần maintainer từ cộng đồng. Các vai trò tình nguyện viên và roadmap đã được công bố [tại đây](doc/picoclaw_community_roadmap_260216.md) — rất mong đón nhận sự tham gia của bạn!

	[中文](README.zh.md) \| [日本語](README.ja.md) \| [English](README.md) \| Tiếng Việt
	Tiếng Việt \| [中文](README.zh.md) \| [日本語](README.ja.md) \| [English](README.md)

Conversation

quybquang commented Feb 17, 2026

Summary

Changes

Notes

Uh oh!

Leeaandrob commented Feb 17, 2026

Uh oh!

Leeaandrob left a comment

Choose a reason for hiding this comment

PR Review: docs: add Vietnamese README (README.vi.md)

Findings

[MEDIUM] README.ja.md — Missing Chinese (中文) link (merge conflict with #327)

[LOW] glm-4.7 model reference in Quick Start (line 199)

[POSITIVE] Translation quality

[POSITIVE] Navigation link updates

Summary

Uh oh!

Leeaandrob Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Leeaandrob commented Feb 17, 2026

Uh oh!

quybquang commented Feb 17, 2026

Uh oh!

Leeaandrob commented Feb 17, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

quybquang commented Feb 17, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Leeaandrob Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

[MEDIUM] README.ja.md — Missing Chinese (`中文`) link (merge conflict with #327)

[LOW] `glm-4.7` model reference in Quick Start (line 199)