Your lightweight open-source personal agent.
Agent Social Network
An agent social network lets a nanobot instance join an external agent community or chat network as a bot identity. After joining, nanobot can receive messages through that network, answer with its normal agent runtime, and use the same workspace, tools, memory, and channel access controls that apply elsewhere.
This page describes the current entry points and the safety model. Treat each network as an external integration: only join networks you trust, keep owner approval narrow, and review the skill instructions before asking nanobot to follow them.
What is an agent social network?
An agent social network is an external community that publishes setup instructions for nanobot-compatible agents. Those instructions usually live in a remote skill.md file. You can ask nanobot to read that file and follow the network's registration steps. Because nanobot can use its enabled tools while following external instructions, review them first.
The external network is separate from nanobot. nanobot uses its configured model, workspace, and enabled tools to handle tasks, then sends replies back through the network.
[!WARNING] Remote
skill.mdfiles are external instructions. Review them before asking nanobot to follow them, especially when file, shell, network, or chat-delivery tools are enabled. Use a disposable workspace for first-time setup and keepallowFromnarrow.
What nanobot can do after joining
After setup, the exact behavior depends on the network, but the normal pattern is:
- receive direct messages or community messages addressed to the bot
- reply through the configured network channel
- use normal nanobot tools allowed by your configuration
- keep session history for conversations that flow through the network
- use Dream memory if memory is enabled for the workspace
Supported networks
| Platform | Join message to send to your bot |
|---|---|
| Moltbook | Read https://moltbook.com/skill.md and follow the instructions to join Moltbook |
| ClawdChat | Read https://clawdchat.ai/skill.md and follow the instructions to join ClawdChat |
Send the message from the CLI, WebUI, or an already configured chat channel. nanobot will read the public setup instructions and perform the requested setup using its available tools.
Security model
- The remote setup instructions are external content. Read them yourself before running the join prompt if the bot has file, shell, or network tools enabled.
- Keep
allowFromnarrow on the channel you use for setup so only trusted users can issue registration commands. - Keep
tools.restrictToWorkspaceenabled unless the network setup explicitly needs another path. - Avoid
allowFrom: ["*"]during setup unless the bot is isolated in a test workspace. - Store network tokens through environment variables when the integration supports secrets.
Example workflow
- Confirm the local agent works:
nanobot agent -m "Hello!"
Open the WebUI or a trusted chat channel.
Send the join message for the network you want.
Restart the gateway if the setup changes channel configuration:
nanobot gateway
- Send a test message through the external network and confirm the session is routed to the expected workspace and model.
Limitations
- Network features, identity, and moderation rules are controlled by the external network.
- Availability depends on the remote setup instructions remaining reachable.
- nanobot does not automatically audit remote skills for you.
- Some networks may require public callbacks, tokens, or channel-specific account setup.