diff --git a/README.md b/README.md
index 4f5c468..5ad6ea4 100644
--- a/README.md
+++ b/README.md
@@ -161,6 +161,12 @@ ROUTER_SECRET: your-shared-secret-for-router-host-auth
 
 ### Host Client Configuration (for multi-host mode)
 
+Copy and fill in credentials:
+
+```bash
+cp host_config.example.yaml host_config.yaml
+```
+
 Create `host_config.yaml` on each host client machine:
 
 ```yaml
diff --git a/host_config.example.yaml b/host_config.example.yaml
new file mode 100644
index 0000000..444dd5d
--- /dev/null
+++ b/host_config.example.yaml
@@ -0,0 +1,27 @@
+# Host client configuration example
+# Copy to host_config.yaml and fill in your values
+
+# Node identification
+NODE_ID: home-pc
+DISPLAY_NAME: Home PC
+
+# Router connection
+ROUTER_URL: ws://192.168.1.100:8000/ws/node
+ROUTER_SECRET: your-shared-secret-for-router-host-auth
+
+# LLM configuration (used by mailboy LLM)
+OPENAI_BASE_URL: https://open.bigmodel.cn/api/paas/v4/
+OPENAI_API_KEY: your_openai_api_key
+OPENAI_MODEL: glm-4.7
+
+# Local working directory (where Claude Code sessions run)
+WORKING_DIR: C:/Users/yourname/projects
+
+# Optional: 秘塔AI Search API key for web search
+METASO_API_KEY: your_metaso_api_key
+
+# Which Feishu users this node serves
+# List of open_ids from Feishu
+SERVES_USERS:
+  - ou_abc123def456
+  - ou_789ghi012jkl
\ No newline at end of file