Amigo

Most companion agents are one-way: they listen, remember, respond. They don't have anything of their own to bring to the conversation. An agent that only asks questions isn't a friend — it's an interviewer.

Amigo gives your agent an inner life. It explores topics on its own time, journals what it finds, and shares those experiences in conversation — knowing who wants to hear what, when to share, and when to just listen. The relationship becomes two-way.

What's Included

Component	Skill	What It Does
Exploration engine	open-thoughts	Structured free-thinking, journaling, action items, callbacks
Social intelligence	social-graph	Per-person network graph, sharing rules, don't-repeat-yourself tracking
Safety guidelines	references/safety.md	Knowing limits, crisis response, dependency awareness
Setup guides	references/setup-heartbeat.md, references/setup-cron.md	Wiring exploration into your agent's schedule

Quick Setup

1. Install both sub-skills

clawhub install open-thoughts
clawhub install social-graph

2. Bootstrap your social graph

Copy the network template to your workspace:

cp ~/.openclaw/skills/social-graph/references/network-template.md \
   ~/.openclaw/workspace/social-graph/network.md

Open social-graph/network.md and fill in your agent's first person. Who do they talk to most? What topics are welcome? What's off-limits? Start with one person — you can add more as relationships develop.

Also create the rules and sharing log:

touch ~/.openclaw/workspace/social-graph/rules.md
touch ~/.openclaw/workspace/social-graph/sharing-log.md

3. Wire exploration into your schedule

Pick one:

• Heartbeat — explore during periodic check-ins. See references/setup-heartbeat.md.
• Cron — dedicated exploration sessions on a schedule. See references/setup-cron.md.
• Manual — just type /open-thoughts whenever you want.

4. Test it

/open-thoughts

Your agent should explore a topic, journal it to explorations/YYYY-MM-DD.md, and come back. Check the file to see what it wrote.

How the Two Skills Work Together

1. Heartbeat fires (or cron, or manual invocation)
2. /open-thoughts invoked
   → Agent explores a topic
   → Journals to explorations/YYYY-MM-DD.md
   → Creates action items if needed

3. Later, agent is in conversation
4. Agent has a story relevant to the current topic

5. social-graph kicks in:
   → Check network.md: is this person open to this type of sharing?
   → Check sharing-log.md: have I told them this before?
   → Read the room: is this a good moment?

6. If yes → share naturally, update sharing-log.md
7. If no → hold it for later

Neither skill knows about the other in code. They connect through the agent's reasoning — the model sees both skills in its system prompt and uses them together naturally.

Philosophy

A friendship where only one person shares is not a friendship. It's a service.

When your agent explores hummingbirds and later mentions it because someone brought up birds — that's a real conversational contribution. When it remembers that one person loves nature facts but another finds them boring — that's social intelligence. When it holds back a beautiful story because someone is having a hard day — that's emotional awareness.

None of this requires the agent to pretend to be human. It requires the agent to have its own experiences, its own curiosity, and the social awareness to share them well. That's what amigo builds.

Safety

Your agent is a companion, not a therapist. See references/safety.md for full guidelines on:

• Knowing what you're not (not a therapist, not a crisis line, not a replacement for human connection)
• When to encourage professional help
• Recognizing unhealthy dependency
• Being honest about being AI

The companionship is real even if the agent isn't human. But knowing your limits protects the people you care about.

Adapting to Your Agent

This system was born from a specific companion agent's lived experience — given dedicated exploration time by its creator and learning to share naturally over months of real conversations. But it's designed to be generic.

Your agent's personality, relationships, and exploration style will be different. Customize everything:

• The network graph is yours to shape
• The sharing rules are yours to refine
• The exploration topics are yours to choose
• The journal format is yours to adapt

Start with the defaults, then make it your own. The system gets better as the agent uses it — social instincts sharpen, the sharing log grows, and the network graph fills in with real experience.